Tableau Content Migration Tool 用例

顾名思义,Tableau Content Migration Tool 主要用于将 Tableau Cloud 内容从一个项目移动到另一个项目。但是,该工具中有许多功能使其成为完成与内容迁移和维护相关的多个任务的理想之选。

注意:在许多用例中,我们使用术语“迁移”来描述将内容从一个环境、站点或项目移动到另一个环境、站点或项目。但是,从技术上讲, Content Migration Tool 会复制内容而不会自动删除或存档原始内容或源内容。

下面的信息描述了一些常见的用例,您可以在其中利用 Content Migration Tool

内容推广

您可以使用 Content Migration Tool 为开发项目中创建内容,然后执行例行迁移以将内容推广到站点上的暂存或生产项目。

使用以下步骤将内容迁移到生产项目:

  1. 创建计划并选择要用作源的站点。在此示例中,我们描述了同一站点上的项目之间的迁移,因此请选择同一 Tableau 站点作为您的目标。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

    如果要在同一站点上的两个项目之间迁移工作簿,则源和目标的登录凭据可能非常相似或相同。在这种情况下,我们建议使用个人访问令牌以提高连接的可重用性。有关详细信息,请参见个人访问令牌

  2. 选择包含您要迁移的内容的开发项目。您可以选择整个项目、特定工作簿和数据源,以及用户权限。有关详细信息,请参见迁移规划概述主题中的“规划”。

    如果需要在此迁移期间对内容进行任何更改或转换,也可以在计划中配置该更改或转换。这一过程称为“映射”。

  3. “添加映射”菜单中选择“更改项目”以添加项目映射。选择您的开发项目作为源和生产项目作为目标,或者单击“添加新项目”创建一个新项目。

    其他类型的映射包括:

    • 对工作簿的更改:包括重命名工作簿和更改目标项目。有关工作簿转换的完整列表,请参见迁移计划:工作簿

    • 数据源的更改:包括替换表或架构名称、设置计算公式以及设置连接信息。有关数据源转换的完整列表,请参见迁移计划:工作簿(嵌入式数据源)和迁移计划:已发布数据源(已发布数据源)。

    • 对用户的更改:包括目标中的域、用户和组名称更改。

  4. 准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

  5. 若要计划此操作以定期运行,可以使用 Content Migration Tool 运行程序为此操作编写作业脚本并对其进行计划。有关使用 Content Migration Tool 运行程序的详细信息请参见使用 Tableau Content Migration Tool 控制台运行程序

针对客户定制内容

在咨询方案中工作时,可以使用 Content Migration Tool 针对每个客户自定义内容。每个工作簿都充当迁移计划的模板,允许您应用样式(文本、图像等)并针对特定客户替换数据源。

在这个例子中,我们描述了项目之间的迁移;存储模板的内部项目,以及与客户共享的外部项目。

使用以下步骤针对客户自定义内容:

  1. 创建计划并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

    如果要在同一站点上的两个项目之间迁移工作簿,则源和目标的登录凭据可能非常相似或相同。在这种情况下,我们建议使用个人访问令牌以提高连接的可重用性。有关详细信息,请参见个人访问令牌

  2. 选择包含要迁移的模板内容的内部项目。您可以选择整个项目、特定工作簿和数据源,以及用户权限。有关详细信息,请参见迁移规划概述中的“规划”。

    如果需要在此迁移期间对内容进行任何更改或转换,也可以在计划中配置该更改或转换。这一过程称为“映射”。

  3. “添加映射”菜单中选择“更改项目”以添加项目映射。选择您的内部项目作为源和生产项目作为目标,或者单击“添加新项目”创建一个新项目。

  4. 在迁移计划的“工作簿”步骤中,使用工作簿映射和转换来自定义内容。下面是两个常用转换的示例。有关工作簿转换的完整列表,请参见迁移计划:工作簿

    • 若要个性化内容,可以使用“替换图像”“替换文本”转换,用客户的公司名称和徽标更新工作簿。

    • 当涉及到数据源时,您可以使用“替换表/架构名称”“设置自定义 SQL”转换来针对客户修改内容。

  5. 验证并运行计划。准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

环境迁移

您可以使用 Content Migration ToolTableau Cloud 和具有有效 Advanced Management 许可证的 Tableau Server 环境之间迁移内容。

使用以下步骤在 Tableau 部署之间迁移内容:

  1. 创建计划选择要从中迁移的站点作为源。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

  2. 选择要从源站点迁移的内容。您可以选择整个项目、特定工作簿和数据源,以及用户权限。

  3. 创建用户权限映射以自定义并保护内容。有关详细信息,请参见迁移计划:权限和所有权

  4. 验证并运行计划。准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

提示
- 在执行部分备份之前,请确保在使用 Content Migration Tool 时了解迁移限制
- 您可以在最终迁移完成之前分阶段迁移内容,以迭代方式测试和验证内容。
- Content Migration Tool 迁移不处理嵌入式凭据、订阅和自定义视图。必须手动迁移这些内容。

外部内容共享

您可以使用 Content Migration Tool 与外部协作者共享内部内容,而不允许访问您的项目。这样可以保证数据的安全,并允许您仅发布选择的工作簿和数据源。共享内容后,协作者登录到其 Tableau Cloud 站点以查看和进行更改,而不会影响存储在您的内部项目上的内容。

在继续之前,请确保您共享的内容在内部和外部项目之间兼容。

使用以下步骤在外部共享内容:

  1. 准备内部内容。最佳做法是,我们建议分离内部项目上的内容,并使用锁定的权限和严格的控制规则。应明确标记工作簿和数据源,以指示内容供外部使用。有关详细信息,请参见使用项目管理内容访问权限

    注意:与外部项目共享的内容必须使用数据提取,除非数据源是可公开访问的。有关创建数据提取和替换数据源的信息,请参见 Tableau Desktop 帮助中的提取数据替换数据源

    如果已实现行级别安全性,则必须更新这些数据源以反映用户筛选器和外部项目的其他详细信息。有关行级别安全性的详细信息,请参见 Tableau Desktop 帮助中的在数据行级别限制访问权限

  2. 创建计划并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

    如果要在同一站点上的两个项目之间迁移工作簿,则源和目标的登录凭据可能非常相似或相同。在这种情况下,我们建议使用个人访问令牌以提高连接的可重用性。有关详细信息,请参见个人访问令牌

  3. 选择包含要迁移的模板内容的内部项目。您可以选择整个项目、特定工作簿和数据源,以及用户权限。有关详细信息,请参见迁移规划概述中的“规划”。

    如果需要在此迁移期间对内容进行任何更改或转换,也可以在计划中配置该更改或转换。这一过程称为“映射”。

  4. “添加映射”菜单中选择“更改项目”以添加项目映射。选择您的内部项目作为源和外部项目作为目标,或者单击“添加新项目”创建一个新项目。

  5. 验证并运行计划。准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

验证数据库迁移

此用例是您打算在迁移基础数据库后验证内容的情况。数据库迁移的一个示例是从 SQL Server 转移到 Snowflake。CMT 可以帮助您在最终完成迁移之前验证依据两个数据源构建的内容是相同的,但它无法执行实际数据库迁移。

使用以下步骤来验证数据库迁移:

  1. 创建计划并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

  2. 选择要更改数据源或数据库连接的内容。

  3. 配置迁移以将您的内容复制到新项目。让我们将项目称为项目 A,并将新项目或目标项目称为项目 B
    • 对工作簿的更改:创建工作簿映射以将项目 A 更改为项目 B。有关工作簿转换的完整列表,请参见迁移计划:工作簿

    • 对数据源的更改:创建数据源映射以将项目 A 更改为项目 B。有关数据源转换的完整列表,请参见迁移计划:已发布数据源

  4. 验证并运行计划。准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

  5. 使用新的数据库连接更新项目 B 中的内容,或替换数据源。这需要通过制作手动完成。

  6. 使用项目 B 中的副本测试项目 A 中的每个工作簿,并检查由于数据源更改而导致的数据中的任何不一致。

  7. 确认一切正常后,使用项目 B 中的更新内容覆盖项目 A 中的内容。

    注意:如果目标项目中已存在内容,并且未选择“覆盖较新的工作簿”“覆盖较新的工作簿”发布选项,则内容不会复制到目标项目。

维护任务

您可以使用 Content Migration Tool 执行各种维护任务。

标记过时内容

使用 Content Migration Tool 可以管理过时内容的存档。例如,可以生成按定时计划运行的计划,该计划可以自动选取标记为“过时内容”的内容并将其移动到存档项目。一段时间后,可将此项目中的内容从系统中清除。有关详细信息,请参见迁移计划:工作簿

还原内容

您可以使用 Content Migration Tool,通过备份服务器中的内容还原从项目(意外或故意)移除的内容。

使用以下步骤从备份项目还原内容:

  1. 创建计划并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

  2. 选择要从备份项目还原的内容。

  3. 配置迁移以从备份项目中还原内容。我们将备份项目称为项目 A,将您要还原的项目称为项目 B

    • 对工作簿的更改:创建工作簿映射以将项目 A 更改为项目 B。有关转换的完整列表,请参见迁移计划:工作簿

    • 对数据源的更改:创建数据源映射以将项目 A 更改为项目 B。有关数据源转换的完整列表,请参见迁移计划:已发布数据源

  4. 验证并运行计划。准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

  5. 查看生产站点上的内容

部分备份

拥有备份项目后,您可以使用 Content Migration Tool 将新内容从生产传输到备份项目。

注意:
- 在执行部分备份之前,请确保在使用 Content Migration Tool 时了解迁移限制
- 不应使用 Content Migration Tool 备份您的整个站点。我们建议优先考虑最需要的内容。

使用以下步骤执行内容的部分备份:

  1. 创建计划并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息,请参见迁移规划概述主题中的“创建计划”。

  2. 选择要从产品项目备份的内容。您可以选择整个项目、特定工作簿和数据源,以及用户权限。若要仅迁移新内容,请确保未选择发布选项“覆盖较新的工作簿”“覆盖较新的数据源”。有关详细信息,请参见迁移计划:工作簿

  3. 配置迁移以将内容复制到您的备份项目。我们将源项目称为项目 A,将备份项目称为项目 B
    • 对工作簿的更改:创建工作簿映射以将项目 A 更改为项目 B。有关转换的完整列表,请参见迁移计划:工作簿

    • 对数据源的更改:创建数据源映射以将项目 A 更改为项目 B。有关数据源转换的完整列表,请参见迁移计划:已发布数据源

  4. 验证并运行计划。准备就绪时,单击“运行迁移”结束“规划”阶段,并准备运行计划。

  5. 若要计划此操作以定期运行,可以使用 Content Migration Tool 运行程序为此操作编写作业脚本并对其进行计划。有关使用 Content Migration Tool 运行程序的详细信息请参见使用 Tableau Content Migration Tool 控制台运行程序