tsm sites

您可以使用 tsm sites 命令导出现有站点以便导入到新站点（也称为站点迁移），以及导入新站点。万一错误将站点锁定，则可以使用 unlock 命令。

tsm sites 命令将使用您的本地文件存储来保存导出和导入数据。如果您运行的是多节点 Tableau 群集，则必须在运行数据引擎进程的 Tableau Server 上运行 tsm sites 命令。有关数据引擎进程和需要它的进程的信息，请参见Tableau Server 进程。

有关迁移站点的全面步骤，请参见导出或导入站点。

• tsm sites export

• tsm sites import

• tsm sites import-verified

• tsm sites unlock

tsm sites export

将指定的 Tableau Server 站点导出为 .zip 文件。您可以导出站点以在特定时间点存档其设置，或者完成站点迁移过程的第一步。

注意：如果发生错误，tsm sites import 和 tsm sites export 命令可以使站点保持锁定状态。 若要解锁站点，请使用 tsm sites unlock 命令。

概要

tsm sites export --site-id

选项

• -f,--file

• 必需。

  指定 Tableau Server 将所有站点信息保存到的文件的名称。

  该文件会生成到 TSM basefilepath.site_export.exports 变量中定义的目录。默认情况下：

  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

  有关文件路径及其修改方式的详细信息，请参见tsm File Paths。

• -id,--site-id

• 必需。

  您要导出的站点的站点 ID。您可以在从 Web 浏览器登录到站点时从 URL 中获取该站点 ID。有关查找站点 ID 的信息，请参见准备源站点和目标站点。

• -ow,--overwrite

• 可选。

  覆盖已存在的同名导出文件。

• --request-timeout

• 可选。

  等待指定的时间以完成命令。默认值为 43200（720 分钟）。

tsm sites import

此命令使用您使用 tsm sites export 创建的 .zip 文件生成一组 .csv 文件，这些 .csv 文件显示导出的源站点设置将如何映射到新的目标站点。

默认情况下，将生成 .zip 文件并将其保存到位于以下位置的 siteexports 目录：

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

在使用此命令之前，必须将此 .zip 文件复制到 Tableau 期望文件所在的目录中。TSM basefilepath.site_import.exports 变量中定义了该位置。默认情况下，导入目录为：

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

有关文件路径及其修改方式的详细信息，请参见tsm File Paths。

注意：如果发生错误，tsm sites import 和 tsm sites export 命令可以使站点保持锁定状态。 若要解锁站点，请使用 tsm sites unlock 命令。

概要

tsm sites import --file

选项

• -f,--file

• 必需。

  由 tsm sites export 进程创建并且必须复制到导入目录的 .zip 文件的名称。默认情况下：

  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

• -id,--site-id

• 必需。

  要导入到的新站点（目标站点）的站点 ID。有关查找站点 ID 的信息，请参见准备源站点和目标站点。

• -c,--continue-on-ignorable-errors

• 可选。

  如果发生可忽略的错误，则继续进行站点导入。这些错误可能是指特定工作簿或数据源的导入问题。

• -k,--no-verify

• 可选。

  跳过映射文件的验证。

• -m, --override-schedule-mapper

• 可选。

  计划映射文件以按名称覆盖正常映射。

• --request-timeout

• 可选。

  等待指定的时间以完成命令。默认值为 7200（120 分钟）。

tsm sites import-verified

指定包含已导出站点的 .csv 映射文件的目录，以导入到新站点。这是站点迁移过程的最后一步。

概要

tsm sites import-verified --import-job-dir

选项

• -id,--site-id

• 必需。

  要导入到的新站点（目标站点）的站点 ID。有关查找站点 ID 的信息，请参见准备源站点和目标站点。

• -w, --import-job-dir

• 必需。

  包含来自导出（源）站点的 .csv 文件的 mappings 目录的父目录。此父目录的名称包括导入 ID 以及日期和时间。例如：

  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457

• --request-timeout

• 可选。

  等待指定的时间以完成命令。默认值为 7200（120 分钟）。

tsm sites unlock

使用此命令来解锁站点。

选项

• -id,--site-id

• 必需。

  您要解锁的站点的站点 ID。有关查找站点 ID 的信息，请参见准备源站点和目标站点。

• -d, --desired-state <使已解锁站点保持的状态>

• 可选。

  站点解锁后应保持的状态。选项为“active”和“suspended”。如果未指定，则默认值为“active”。

  例如：

  tsm sites unlock -id mysite -d suspended

• --request-timeout

• 可选。

  等待指定的时间以完成命令。默认值为 300（5 分钟）。

全局选项

• -h, --help

• 可选。

  显示命令帮助。

• -p, --password

• 在会话不是活动状态的情况下为必需，-u 或 --username 也为必需。

  为在 -u 或 --username 中指定的用户指定密码。

  如果密码包括空格或特殊字符，请将其括在引号中：

  --password "my password"

• -s, --server https://

• 可选。

  对 Tableau 服务管理器使用指定的地址。URL 必须以 https 开头，包括端口 8850，并使用服务器名称（而不是 IP 地址）。例如，https://。如果没有指定服务器，则假定为 https://。

• --trust-admin-controller-cert

• 可选。

  使用此标志来信任 TSM 控制器上的自签名证书。有关证书信任和 CLI 连接的详细信息，请参见 连接 TSM 客户端。

• -u, --username

• 在会话不是活动状态的情况下为必需，-p 或 --password 也为必需。

  指定用户帐户。如果未包括此选项，则使用您登录所使用的凭据运行该命令。