您可以通过使用用户信息创建逗号分隔值(CSV)文件然后导入文件来自动添加用户。您可以在CSV文件中包含属性,例如许可级别和发布访问权限,以便在导入用户的同时应用于用户。

要导入用户,可以使用服务器或站点管理页面或tabcmd实用程序。“使用” tabcmd提供了一个选项,用于为CSV文件中的所有用户分配站点角色。有关信息,请参阅 Import Users 或createsiteusers filename.csv。

您可以在站点或服务器级别导入用户。如果将用户导入服务器(而不是特定站点),则不会将用户分配到站点并导入为未许可。

CSV文件格式要求

创建用于导入用户的CSV文件时,请确保该文件符合以下格式要求:

  • 该文件不包含列标题。Tableau Server假定文件中的每一行代表一个用户。
  • 该文件采用UTF-8格式,包括字节顺序标记(BOM)。
  • 诸如BIG-5的字符编码已被转换为UTF-8。您可以通过在文本编辑器中打开文件并使用“ 另存为”命令来完成此操作。
  • 如果用户名包含表示除域分隔符以外的任何内容的@字符,则需要使用十六进制格式引用该符号: \0x40

    例如,user@fremont@mycompany.com应该是user\0x40fremont@mycompany.com

CSV文件中的必填列

每个用户都需要以下值:

  • 用户名

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

其他导入文件选项

CSV文件可以包含以下字段,按此处显示的顺序:

  • 用户名。用户名。如果服务器配置为使用Active Directory,则此值必须与Active Directory中定义的用户匹配。如果用户名在域之间不唯一,则必须将域包含为用户名的一部分(例如,example\Adamadam@example)。这是唯一必填字段。
  • 密码。用户的密码。如果服务器配置为使用Active Directory,则不使用此值。
  • 显示名称。显示名称是用于标识服务器上用户的信息的一部分。如果用户的显示名称已在使用中,Tableau Server将使用CSV文件中的设置更新现有用户信息。如果使用Active Directory配置服务器,则不使用此值。
  • 许可级别。这可以是CreatorExplorerViewerUnlicensed
  • 管理员级别(系统站点)。此设置确定是否以管理员身份导入用户。

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

  • 发布功能(是/ true / 1无/假/ 0)。如果您使用的是Web UI,则仅在登录到特定站点时导入时才使用发布者设置。如果在服务器(所有站点)级别导入用户,则不使用此值。
  • 电子邮件地址。电子邮件地址是用于标识服务器上的用户的信息的一部分。如果电子邮件地址已被使用,Tableau Server将使用CSV文件中的设置更新现有用户信息。

列的顺序很重要。第一列被视为用户名,第二列被视为密码,第三列被视为显示名称,依此类推,无论列中的内容如何。如果省略字段的值,则仍必须包含字段的逗号分隔符。

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

服务器管理员可以启用服务器设置,以帮助提高通过tabcmd命令导入大型CSV文件的性能。您可以使用tsm configuraiton set带有以下选项的命令执行此操作:

  • vizportal.csv_user_mgmt.index_site_users
  • vizportal.csv_user_mgmt.bulk_index_users
  • searchserver.index.bulk_query_user_groups

从本质上讲,这些选项会在处理CSV文件后对用户进行索引,而不是一对一地将它们添加到服务器的数据库中。这减少了对数据库的调用次数和处理文件所需的内存。这些tabadmin set选项适用于tabcmd createsiteusersdeletesiteusersaddusers,和removeusers命令。

从本质上讲,这些选项会在处理CSV文件后对用户进行索引,而不是一对一地将它们添加到服务器的数据库中。这减少了处理文件所需的数据库和内存的调用次数。这些tabadmin set选项适用于tabcmd createsiteusersdeletesiteusersaddusers,和removeusers命令。

有关这些设置的说明,请参阅tsm配置集选项。

笔记

  • 如果您未登录到特定站点并且正在服务器级别导入用户,则只能分配Server Administrator和Unlicensed站点角色。
  • 如果您安装了基于用户的服务器,并且添加的用户数超过了许可证允许的用户数,则会将这些用户添加为未许可的用户。
  • 如果您使用tabcmd并指定许可证,但导入用户将超出许可证限制,则会将用户导入为未许可证。

CSV设置和站点角色

用户的许可级别,管理员和发布设置确定在导入过程中如何设置用户的站点角色。下表显示了如何将设置转换为站点角色。

CSV设置 网站角色
许可级别=(任何)

管理员=系统

出版商=真

Server Administrator。此设置仅适用于Tableau Server,仅在管理服务器时导入用户(即未登录到特定站点)时才有效。

Server Administrator站点角色始终具有Creator许可证(如果有)。如果没有可用的Creator许可证,请参阅许可疑难解答以了解Tableau Server处理此问题的方式。

许可级别=创建者或资源管理器

管理员=网站

出版商=真

站点管理员创建者或站点管理员资源管理 仅当您在登录特定站点时导入用户时,此设置才有效。
许可级别=创建者

管理员=无

出版商=真

创造者
许可级别=资源管理器

管理员=无

出版商=真

资源管理器(可以发布)
许可级别=资源管理器

管理员=无

出版商= FALSE

探险者
许可级别=查看者

管理员=无

出版商= FALSE

查看器
许可级别=未许可

管理员=无

出版商= FALSE

未经许可

Tableau Server的CSV导入示例

以下示例显示了一个CSV文件,其中包含多个用户的信息。

henryw,henrypassword,Henry Wilson,Creator,None,yes,henryw @ example.com
freds,fredpassword,Fred Suzuki,Viewer,None,no,freds @ example.com
alanw,alanpassword,Alan Wang,Explorer,Site,yes,alanw @ example.com
michellek,michellepassword,Michelle Kim,创作者,系统,是的,michellek @ example.com

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

如果在管理服务器时导入此文件,则会将四个用户添加到服务器,但不会将它们添加到任何站点。仅导入一个用户作为服务器管理员; 其余的都设置为未经许可。CSV导入文件指南-IDC帮帮忙