--- schema_version: "1" id: 44ee4800c8f74914b3c571d0ed9342e4ae6268dc2617ead6b602ca50d0ec159a title: CSV 导入文件准则 collection: tableau version: next locale: zh-cn portal_url: https://docs.salesforce.com/tableau/next/zh-cn/online/csvguidelines.md canonical_url: https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm source_site: help.tableau.com content_type: documentation content_hash: fb38f6fd071a07f95b7dd1fa5c55902baa3e0ead43c8533704d732159f3ac28d description: CSV file format guidelines for bulk importing users into Tableau Cloud and Tableau Cloud Manager, with required columns. --- [跳转到主要内容](#main-content) # CSV 导入文件准则 通过创建含有用户信息的逗号分隔值 (CSV) 文件，然后导入该文件，即可批量添加用户。您可以在 CSV 文件中包括属性（例如许可级别和发布访问权限），以便在导入这些属性的同时将它们应用于用户。 本主题介绍 CSV 文件本身的详细信息。若要使用 CSV 导入用户，您可以： - 使用站点管理页面。有关信息，请参见[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm) - 使用 `tabcmd` 实用工具。有关信息，请参见 [createsiteusers filename.csv](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)。 - 使用 Tableau Cloud Manager。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。 ## CSV 文件格式要求 用于导入用户的 CSV 文件具有以下格式要求： - 没有列标题。Tableau Cloud假定文件中的每一行代表一个用户。 - 只有在导入到站点时才支持带字节顺序标记 (BOM) 的 UTF-8 格式。如果要导入到 Tableau Cloud Manager，请使用 UTF-8 格式并从文件中移除任何 BOM。 - 诸如 BIG-5 等字符编码必须转换为 UTF-8。可通过在文本编辑器中打开文件并使用“另存为”命令来达到此目的。 - 如果 `@` 字符出现在除域分隔符以外的任何**用户名**字段中，则它必须为十六进制格式：`\0x40`。例如，`user@fremont@mycompany.com` 应该为 `user\0x40fremont@mycompany.com`。 ## CSV 文件中所需的列结构 文件不应包含标题行。并非所有列都需要填写，但必须通过包括所有预期的逗号分隔符来保留所需的列结构。 列结构因产品和导入工具而异。确保使用适合您的环境的结构： - **Tableau Cloud：**username、password、display name、license level、administrator level、publishing capability、email address - **带有 Tableau Cloud Manager (TCM) 的 Tableau Cloud：**tenant or site URI、username, password、display name、license level、administrator level、publishing capability、email address、authentication type - **Tableau Server：**username、password、display name、license level、admin level、publishing capability、email address - **使用身份池的 Tableau Server：**username、password、display name、license level、admin level、publishing capability、email address、identity pool name、identifier 有关每列的可能值的详细信息，请参见下面的列详细信息部分。 > [!WARNING] > > **重要信息：**列的顺序非常重要。将第一列视为用户名，将第二列视为密码，将第三列视为显示名称等等，而不考虑列中的内容。如果忽略字段的值，您必须仍然包括字段的逗号分隔符。 ## Tableau Cloud CSV 的列详细信息 如果 CSV 文件仅包含 username 值（电子邮件地址），则用户将会收到邀请其访问站点的电子邮件。用户可以联接站点以创建帐户，但在管理员配置他们的帐户（显示名称、许可级别等）之前，他们的帐户会保持未许可状态。用户在站点上的电子邮件地址可能会在站点上显示前导句点（例如 `.user@domain.com`），直到用户首次登录为止。 CSV 文件的列结构：_username、password、display name、license level、administrator level、publishing capability、email address_ ### 列详细信息 任何留空的列仍必须用逗号分隔，以保留列结构。 **Username：**_必填_。用户的电子邮件地址。 **Password：**_忽略_。作为最佳做法，请将此列留空。 - 新用户在首次登录到 Tableau Cloud 时必须选择密码和显示名称。如果用户已有 Tableau 帐户，则他们可能已经有密码。 **Display name：**_忽略_。作为最佳做法，请将此列留空。 **License level：**可以是**“Creator”**、**“Explorer”**、**“Viewer（查看者）”**或**“Unlicensed”**。如果留空，则许可级别将为 Unlicensed。 **Administrator level：**可以是**“Site”**或**“None”**。如果留空，则 administrator level 将为 None。 - Site = 站点管理员，None = 非管理员。 - **注意**：使用 Tableau Cloud Manager 时，云只是一个相关值。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。 **Publishing capability：**可以是**“Yes/True/1”**或**“No/False/0”**。如果留空，则 publishing capability 将为 false。 - 如果 license level 为 Creator，则 publishing capability 必须为 Yes/True/1 - 如果 license level 为 Explorer，则 publishing capability 值就是区分“Explorer（可发布）”和“Explorer”的站点角色的值 - 如果 license level 为 Viewer 或 Unlicensed，则无论此列的值如何，用户都将无法进行发布 **Email address：**从 2025 年 7 月（Tableau 2025.2）开始，如果与用户名不同，您可以指定电子邮件地址。电子邮件地址仅用于通知目的。如果未提供电子邮件地址值，Tableau Cloud 将使用必填用户名字段中的值来发送通知。出于安全考虑，您只能指定仅是一个站点的成员用户的电子邮件地址。 ### 不使用 TCM 的身份验证类型 如果您不使用 Tableau Cloud Manager，则在上载过程中只能设置单一默认身份验证类型。之后，您可以为个别用户更改身份验证类型。 - 直接在 Tableau Cloud 中上载 CSV 文件时，请在导入文件时指定身份验证类型，该类型将应用于所有导入的用户。 - 使用 `tabcmd` 来导入用户时，请在上载期间设置身份验证类型和适用于 CSV 文件中所有用户的站点角色。有关信息，请参见 [createsiteusers filename.csv](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)。 若要在上载时为每个用户设置特定的身份验证类型，您必须使用 Tableau Cloud Manager。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。 ### Tableau Cloud CSV 示例结构 > [!TIP] > > **提示：**请记住，结构为：`username, password, display name, license level, administrator level, publishing capability, email address`，当列留空时，逗号之间没有任何内容。 以下示例显示一个用户，该用户被授予“Explorer（可发布）”站点角色、将不会是站点管理员，并且将能够发布其有适当内容权限的项目。 user1@domain.com,,,Explorer,None,true,user1@domain2.com 通过更改 administrator-level 列，您将能以具有“站点管理员 Explorer”站点角色的站点管理员形式导入以下用户。 adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com ## TCM CSV 的列详细信息 如果 CSV 文件仅包含用户名（电子邮件地址）值，则用户将会收到邀请其访问站点的电子邮件。用户可以联接站点以创建帐户，但在管理员配置他们的帐户（显示名称、许可级别等）之前，他们的帐户会保持未许可状态。 请记住，留空的列仍必须用逗号分隔，以保留列结构。 CSV 文件的列结构：`tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type` ### 列详细信息 **Tenant or site URI：**租户或站点的统一资源标识符。 **Username：**_必填_。用户的电子邮件地址。 **Password：**_忽略_。作为最佳做法，请将此列留空。 - 新用户在首次登录到 Tableau Cloud 时必须选择密码和显示名称。如果用户已有 Tableau 帐户，则他们可能已经有密码。 **Display name：**_忽略_。作为最佳做法，请将此列留空。 **License level：**对于站点，可以是**“Creator”**、**“Explorer”**、**“Viewer（查看者）”**或**“Unlicensed”**。如果留空，则许可级别将为 Unlicensed。 **Administrator level：**可以是**“Site”**、**“Cloud”**或**“None”**。如果留空，则 administrator level 将为 None。 - Site = 站点管理员，None = 非管理员，Cloud = 云管理员。 **Publishing capability：**对于站点，可以是**“True”**或**“False”**。如果留空，则 publishing capability 将为 false。 - 如果 license level 为 Creator，则 publishing capability 必须为 True - 如果 license level 为 Explorer，则 publishing capability 值就是区分“Explorer（可发布）”和“Explorer”的站点角色的值 - 如果 license level 为 Viewer 或 Unlicensed，则无论此列的值如何，用户都将无法进行发布 **Authentication type：**用于访问租户或站点的用户身份验证类型。可以是**“Google”**、**“OpenID”**、**“Salesforce”**、**“SAML”**、**“TableauIDWithMFA”**或**“DEFAULT”**。 ### TCM CSV 示例结构 > [!TIP] > > **提示：**请记住，结构为：`tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type`，当列留空时，逗号之间没有任何内容。 以下示例显示了在 Tableau Cloud Manager 中被授予云管理员角色的用户，并使用带有 MFA 的 Tableau 进行身份验证。 TCM,cloudadminuser@domain.com,,,,Cloud,,TableauIDWithMFA 通过更改 authentication 列，您可以使用备用身份验证类型导入以下用户（如果在 Tableau Cloud Manager 设置中配置了该类型）。 TCM,cloudadminuser@domain.com,,,,Cloud,,Salesforce 在以下示例中，您可以使用带有 MFA 的 Tableau 身份验证导入站点角色为“Explorer - 可发布”的用户。 MySite,user1@domain.com,,,Explorer,None,True,TableauIDWithMFA ## CSV 设置和站点角色 用户的许可证级别、管理员和发布设置确定如何在导入过程中设置用户的站点角色。下面介绍了应如何在 CSV 中捕获站点角色。
站点角色License levelAdministrator levelPublishing capability

云管理员

仅当您在登录 Tableau Cloud Manager（即未登录特定站点）的情况下导入用户时，此角色才有效。

UnlicensedCloudFalse

站点管理员 Creator 或站点管理员 Explorer

仅当您在登录到特定站点的情况下导入用户时，这些角色才有效。

Creator 或 ExplorerSiteTrue
CreatorCreatorNoneTrue
Explorer（可发布）ExplorerNoneTrue
ExplorerExplorerNoneFalse
Viewer（查看者）Viewer（查看者）NoneFalse
UnlicensedUnlicensedNoneFalse