Content Migration Tool 允许您将工作簿和数据源权限复制到位于不同网络域或者用户名或组语法存在差异的 Tableau Server 环境中。在将内容发布到目标位置之后,您可以创建用户权限映射,以自定义和保护内容。如果已在规划阶段的早期与“应用用户映射”一起选择了Copy Project Permissions、Copy Workbook Permissions或Copy Data Source Permissions,则应用映射。
有关详细信息,请参见迁移计划:源项目、迁移计划:工作簿和迁移计划:已发布数据源。
映射限制
-
如果 Content Migration Tool 在目标位置中找不到映射的用户或组,它将停止迁移过程。第一次失败后不会检查后续用户或组权限映射,并且必须再次运行计划。
-
如果源内容具有多个具有相同名称的用户和组的权限,则 Content Migration Tool 无法复制权限。仅当存在来自单独域的重复用户或组名称时,才会发生这种情况。
步骤 1:添加映射
若要添加用户权限映射,请单击“Add Mapping”,并选择是更改域、用户、组的名称,还是从逗号分隔值 (CSV) 文件导入映射。如果 Content Migration Tool 无法在目标位置中匹配权限,则不会迁移源内容。
域映射
域权限映射适用于目标位置中的所有用户和组。如果您不确定源域或目标域,则可以在 Tableau Server 中检查用户和组页面。如果已选择本地用户预配,则必须将域指定为“local
”。
用户映射
用户权限映射使用语法 domain\user
自动填充来自源和目标位置的用户列表。您不能输入和保存不存在的用户名。
组映射
组权限映射使用语法 domain\group
自动填充来自源和目标位置的用户列表。您不能输入和保存不存在的组的名称。
从 CSV 文件导入映射
从版本 2021.4 开始,您可以导入包含域、用户和组映射的 CSV 文件,以快速准备数据以进行迁移。导入映射允许您在 Content Migration Tool 外部批量创建和编辑映射,从而减少运行迁移计划所需的手动步骤。若要导入映射,请从“添加映射”菜单中选择“从文件导入”。
CSV 文件格式要求
在创建用于导入映射的 CSV 文件时,请确保文件满足以下要求:
-
文件不包括列标题。Tableau 假设每一行都代表一个映射。
-
该文件每行包含三个逗号分隔值:映射类型、源域/用户/组以及目标域/用户/组。
-
如果服务器使用 Active Directory 身份验证或“本地”(假设服务器使用本地身份存储),则为用户名和组包括域。
您必须为映射类型指定“域”、“用户”或“组”,如下表所示。源和目标列提供 Active Directory 和本地身份存储的示例语法。CSV 文件中的实际值会因您的组织而异。
映射类型 | 源 | Destination |
domain |
<domain>
|
<domain>
|
用户 |
<domain> \<user name> local\ <user name> |
<domain> \<user name> local\ <user name > |
组 |
<domain> \<group name> local\ <group name> |
<domain> \<group name> local\ <group name> |
导入用户权限映射
在 Content Migration Tool 中导入用户权限映射:
-
单击“添加映射”,然后选择“从文件导入”。
-
在对话窗口中,单击“导出 CSV”以导出包含源站点中所有用户和组的 .csv 文件。在文本编辑器中编辑生成的文件以添加目标站点的映射。
如果您已有映射文件,请跳至步骤 3。
注意:导出的 CSV 文件不包括来自源站点的域。必须手动将域添加到 CSV 以创建域映射。
-
单击“导入映射”并选择要导入的映射文件。
Content Migration Tool 将在导入文件时验证映射是否存在错误。如果检测到错误,您必须修复 CSV 文件中的每个错误,然后再次导入该文件。
CSV 导入示例
以下示例显示了一个包含多种映射类型的 CSV 文件。
user,local\hwilson,companyx.lan\henry.wilson user,local\jjohnson,companyx.lan\janna.johnson user,local\mkim,companyx.lan\michele.kim user,local\fsuzuki,companyx.lan\fred.suzuki user,local\awang,companyx.lan\alan.wang user,local\snguyen,companyx.lan\susan.nguyen user,local\lrodriguez,companyx.lan\laura.rodriguez user,local\agarcia,companyx.lan\ashley.garcia group,local\All Users,companyx.lan\All Users group,local\Finance Team,companyx.lan\Finance Group domain,dev.mycompany,prod.mycompany
导入 CSV 时会显示一个预览窗口,其中显示已移除、已添加或更新、未更改和忽略的映射。检查映射更改是否正确,并单击“接受”。
成功导入映射后,您可以编辑、删除或更改映射顺序,如步骤 2 中所述。
步骤 2:更改映射顺序
创建权限映射后,可以使用 Up 或 Down 选项更改顺序,以确定在迁移期间何时处理映射。当在权限映射中处理域、用户或组时,将忽略源域、用户或组的任何后续映射。
在下面的示例中,User_A
的权限映射到 User_B
。 Content Migration Tool 将忽略第二个权限映射,因为已处理 User_A
。
在下面的示例中,第一个权限映射将所有用户的域关联到 prod
。Content Migration Tool 将忽略第二个权限映射,因为已处理 User_A
的域。
步骤 3:继续下一步
准备就绪后,单击“Next ”继续进行规划阶段的迁移计划:迁移脚本部分。
谁可以执行此操作
具有站点管理员 Explorer 角色或更高级别角色的 Tableau Server 用户。为了迁移内容,您必须在源站点上具有“查看和下载工作簿”/“保存副本”权限,并在目标站点上具有“发布”权限。有关详细信息,请参见权限。