CSV 导入文件指南

若要导入用户，可以使用服务器或站点管理页面或实用程序。使用 提供了一个选项，用于将站点角色分配给 CSV 文件中的所有用户。有关信息，请参阅导入用户或创建网站用户文件名.csv。tabcmdtabcmd

您可以在站点或服务器级别导入用户。如果将用户导入服务器（而不是特定站点），则不会将用户分配到站点，而是作为“未许可”导入。

CSV 文件格式要求

创建用于导入用户的 CSV 文件时，请确保该文件满足以下格式要求：

• 该文件不包含列标题。Tableau Server 假定文件中的每一行都代表一个用户。

• 该文件采用 UTF-8 格式，并包含字节顺序标记 （BOM）。

• BIG-5 等字符编码已转换为 UTF-8。为此，您可以在文本编辑器中打开文件并使用“另存为”命令。

• 如果用户名包含表示域分隔符以外的任何内容的 @ 字符，则需要使用十六进制格式引用该符号：\0x40

  例如，应user@fremont@mycompany.comuser\0x40fremont@mycompany.com

CSV 文件中的必需列

每个用户都需要以下值：

• 用户名

• 密码：如果 Tableau Server 配置为使用 Active Directory 身份验证，则必须有一列，但该列本身应为空。如果服务器使用本地身份验证，则必须为新用户提供密码。Password

其他导入文件选项

CSV 文件可以包含以下字段，按此处显示的顺序排列：

• 用户名。用户名。如果服务器配置为使用 Active Directory，则此值必须与 Active Directory 中定义的用户匹配。如果用户名在域中不是唯一的，则必须将域作为用户名的一部分包括在内（例如，或 ）。这是唯一的必填字段。example\Adamadam@example

• 密码。用户的密码。如果服务器配置为使用 Active Directory，则不使用此值。

• 显示名称。显示名称是用于标识服务器上的用户的信息的一部分。如果用户的显示名称已在使用中，Tableau Server 将使用 CSV 文件中的设置更新现有用户信息。如果服务器是使用 Active Directory 配置的，则不使用此值。

• 许可证级别。这可以是创建者、资源管理器、查看者或未许可。

• 管理员级别（“系统”、“站点”或“无”）。此设置确定用户是否以管理员身份导入。

  如果使用 Web UI 导入用户，则仅当在服务器（所有站点）级别导入文件时，才能将管理员站点角色设置为“系统”。如果您已登录到特定站点，并且 CSV 文件中用户的管理员列设置为“系统”，则 Tableau Server 会将用户作为站点管理员导入。

• 发布功能（是/真/1 或否/假/0）。如果您使用的是 Web UI，则仅当您在登录到特定站点时进行导入时，才会使用发布者设置。如果在服务器（所有站点）级别导入用户，则不会使用此值。

• 电子邮件地址。电子邮件地址是用于识别服务器上用户的信息的一部分。如果电子邮件地址已在使用中，Tableau Server 将使用 CSV 文件中的设置更新现有用户信息。

列的顺序很重要。第一列被视为用户名，第二列被视为密码，第三列被视为显示名称，依此类推，而不考虑列中的内容。如果省略字段的值，则仍必须包括该字段的逗号分隔符。

提高了通过 tabcmd 传递的大型 CSV 文件的性能

A server administrator can enable server settings that help to improve performance for importing large CSV files through tabcmd commands. You can do this using the command with the following options:tsm configuraiton set

• vizportal.csv_user_mgmt.index_site_users

• vizportal.csv_user_mgmt.bulk_index_users

• searchserver.index.bulk_query_user_groups

Essentially, these options index users after the CSV file is processed, instead of one-by-one as they are added to the server’s database. This reduces the number of calls to the database and the memory required to process the file. These options apply to the , , , and commands.tsm configuration settabcmd createsiteusersdeletesiteusersaddusersremoveusers

For descriptions for these settings, see tsm configuration set Options.

Notes

• If you are not signed in to a specific site and are importing users at the server level, you can assign only the Server Administrator and Unlicensed site roles.

• If you have a user-based server installation, and if adding users would exceed the number of users allowed by your license, the users are added as unlicensed users.

• If you use and specify the license, but importing users would exceed your license limits, users are imported as Unlicensed. tabcmd

CSV settings and site roles

The license level, administrator, and publishing settings for a user determine how the user's site role is set during the import process. The following table shows how the settings are converted to site roles.

Tableau Server 的 CSV 导入示例

下面的示例演示一个 CSV 文件，其中包含多个用户的信息。

亨利，亨利密码，亨利 Wilson,Creator,None,yes,henryw@example.com
弗雷德，弗雷德密码，弗雷德 Suzuki,Viewer,None,no,freds@example.com
阿兰，艾伦密码，艾伦 Wang,Explorer,Site,yes,alanw@example.com
米歇尔克，米歇尔密码，米歇尔 Kim,Creator,System,yes,michellek@example.com

如果在管理站点时导入此文件，则会向该站点添加四个用户。用户米歇尔的设置为 。但是，由于您要将用户导入到站点中，因此 Tableau Server 会为 Michelle 提供站点管理员创建者站点角色。允许其中三个用户发布。AdministratorSystem

如果在管理服务器时导入此文件，则会将四个用户添加到服务器，但不会将其添加到任何站点。只有一个用户作为服务器管理员导入;其余部分设置为“未许可”。

返回页首