Tableau Cloud 帮助

本主题介绍 CSV 文件本身的详细信息。若要使用 CSV 导入用户，您可以：

• 使用站点管理页面。有关信息，请参见导入用户
• 使用 tabcmd 实用工具。有关信息，请参见 createsiteusers filename.csv。
• 使用 Tableau Cloud Manager。有关详细信息，请参见使用 Tableau Cloud Manager 管理用户。

CSV 文件格式要求

用于导入用户的 CSV 文件具有以下格式要求：

• 没有列标题。Tableau Cloud假定文件中的每一行代表一个用户。
• 带有字节顺序标记 (BOM) 的 UTF-8 格式。
  • 诸如 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

有关每列的可能值的详细信息，请参见下面的列详细信息部分。

重要信息：列的顺序非常重要。将第一列视为用户名，将第二列视为密码，将第三列视为显示名称等等，而不考虑列中的内容。如果忽略字段的值，您必须仍然包括字段的逗号分隔符。

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”。如果留空，则许可级别将为“未许可”。

Administrator level：可以是“Site”或“None”。如果留空，则 administrator level 将为 None。

• Site = 站点管理员，None = 非管理员。
• 注意：使用 Tableau Cloud Manager 时，云只是一个相关值。有关详细信息，请参见使用 Tableau Cloud Manager 管理用户。

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 将使用必填 username 字段中的值来发送通知

任何留空的列仍必须用逗号分隔，以保留列结构。

不使用 TCM 的身份验证类型

如果您不使用 Tableau Cloud Manager，则在上载过程中只能设置单一默认身份验证类型。之后，您可以为个别用户更改身份验证类型。

• 直接在 Tableau Cloud 中上载 CSV 文件时，请在导入文件时指定身份验证类型，该类型将应用于所有导入的用户。
• 使用 tabcmd 来导入用户时，请在上载期间设置身份验证类型和适用于 CSV 文件中所有用户的站点角色。有关信息，请参见 createsiteusers filename.csv。

若要在上载时为每个用户设置特定的身份验证类型，您必须使用 Tableau Cloud Manager。有关详细信息，请参见使用 Tableau Cloud Manager 管理用户。

Tableau Cloud CSV 示例结构

提示：请记住，结构为：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”。如果留空，则许可级别将为“未许可”。

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 示例结构

提示：请记住，结构为：tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type，当列留空时，逗号之间没有任何内容。

以下示例显示了在 Tableau Cloud Manager 中被授予云管理员角色的用户，并使用带有 MFA 的 Tableau 进行身份验证。

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA

通过更改 authentication 列，您可以使用备用身份验证类型导入以下用户（如果在 Tableau Cloud Manager 设置中配置了该类型）。

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce

在以下示例中，您可以使用带有 MFA 的 Tableau 身份验证导入站点角色为“Explorer - 可发布”的用户。

MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA