使用 Tableau Content Migration Tool 控制台运行程序

Tableau Content Migration Tool 包括一个用于运行迁移的命令行实用工具 tabcmt-runner.exe(位于安装文件夹中)。默认安装文件夹为 %PROGRAMFILES%\Tableau\Tableau Content Migration Tool

注意:tabcmt-runner.exe 实用工具与 tabcmt.cmd 命令行实用工具不同,后者用于配置 Content Migration Tool 图形应用程序。有关 tabcmt.cmd 的详细信息,请参见使用 Tableau Content Migration Tool 命令行界面

用法:

  • tabcmt-runner [选项] <plan_file.tcmx>
  • tabcmt-runner license --remove
  • tabcmt-runner license <新许可证密钥>
  • tabcmt-runner license <许可证文件路径> [--passphrase=<许可证文件密码>]
  • tabcmt-runner encryption --reset
  • tabcmt-runner encryption <新密钥>
  • tabcmt-runner improvement [on|off]
  • tabcmt-runner --help
  • tabcmt-runner --version
  • tabcmt-runner script-warning [on|off]

选项:

  • --version
  • --help
  • --quiet
  • --info
  • --logfile=值
  • --src-user=值
  • --src-password=值
  • --dest-user=值
  • --dest-password=值
  • --https=值
  • --allow-scripts

运行计划

立即执行迁移计划。

tabcmt-runner [options] <plan file>

可用选项:

  • --logfile=<file name> 设置日志输出的文件名
  • --https=<secure|legacy> 设置 HTTPS 模式
  • --quiet 禁止记录到 stdout
  • --src-user=<username> 设置源连接的用户名
  • --src-password=<password> 设置源连接的密码
  • --dest-user=<username> 设置目标连接的用户名
  • --dest-password=<password> 设置目标连接的密码

退出代码:

  • 0 表示迁移成功。
  • 1 表示迁移已成功,但记录了警告消息。
  • 2 表示迁移失败。特定错误将包括在日志输出中。

显示计划摘要

显示迁移计划的摘要,然后退出。

tabcmt-runner --info <plan file>

help

显示命令行实用工具的用法信息。

tabcmt-runner --help

version

显示当前应用程序版本信息。

tabcmt-runner --version

encryption

重置加密密钥或指定新密钥。您必须在使用 tabcmt-runner 实用工具之前指定加密密钥,即使您已经通过 Content Migration Tool UI 这样做了也是如此。

tabcmt-runner encryption <new_key> | --reset

improvement

默认值:on

允许或禁止应用程序收集匿名使用情况信息。此信息完全匿名,并且会定期发送到 Tableau 来帮助我们改进 Content Migration Tool

示例

显示改进计划是处于启用还要禁用状态:

tabcmt-runner improvement

启用或禁用改进计划:

tabcmt-runner improvement <on|off>

license

2022 年 7 月已弃用。

此命令仅适用于旧版许可证。管理当前用户的旧版应用程序许可证。使用旧版密钥时,若要使用 tabcmt-runner 实用工具,您必须使用此命令激活许可证,即使您已经通过 Content Migration Tool UI 激活了许可证也是如此。

示例

显示当前许可证信息:

tabcmt-runner license

设置/激活系列密钥或脱机许可证密钥:

tabcmt-runner license <key>

移除/停用当前许可证:

tabcmt-runner license --remove

使用许可证文件设置/激活:

tabcmt-runner license <file path> [--passphrase=<password>]

script-warning

默认值:on

运行包含迁移脚本的迁移计划时显示警告消息。

注意:此命令会更新您在“设置”页面上的选择。有关详细信息,请参见Tableau Content Migration Tool 设置

示例

显示脚本警告是打开还是关闭。

tabcmd-runner script-warning

打开或关闭脚本警告

tabcmd-runner script-warning <on|off>

如果打开,您必须包括 --allow-scripts 选项以执行迁移计划。

tabcmd-runner --allow-scripts <plan file>

谁可以执行此操作

为了使用控制台运行程序,您必须具有以下所有各项:

  • Content Migration Tool 计算机上的管理员权限。
  • 具有 Explorer 角色或更高级别角色的 Tableau 站点用户帐户。
  • 源站点上的“查看和下载工作簿”/“保存副本”权限。
  • 目标站点的“发布”权限。
感谢您的反馈!您的反馈已成功提交。谢谢!