tsm sites

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

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

注意:Tableau Server 的实例之间迁移站点时,目标站点的版本 Tableau Server 必须等于或高于源站点的版本 Tableau Server。源站点和目标站点都必须来自受支持的 Tableau Server 版本。

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

tsm sites export

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

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

概要

tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]

选项

-f,--file <export-file>

必需。

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

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

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

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

-id,--site-id <source-siteID>

必需。

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

-ow,--overwrite

可选。

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

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。默认值为 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 importtsm sites export 命令可以使站点保持锁定状态。 若要解锁站点,请使用 tsm sites unlock 命令。

概要

tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]

选项

-f,--file <export-file.zip>

必需。

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

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

-id,--site-id <target-siteID>

必需。

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

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

可选。

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

-k,--no-verify

可选。

跳过映射文件的验证。

-m, --override-schedule-mapper <mapping-file.csv>

可选。

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

--request-timeout <timeout in seconds>

可选。

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

tsm sites import-verified

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

概要

tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]

选项

-id,--site-id <target-siteID>

必需。

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

-w, --import-job-dir <importjob-directory>

必需。

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

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

--request-timeout <timeout in seconds>

可选。

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

tsm sites unlock

使用此命令来解锁站点。

选项

-id,--site-id <target-siteID>

必需。

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

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

可选。

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

例如:

tsm sites unlock -id mysite -d suspended

--request-timeout <timeout in seconds>

可选。

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

全局选项

-h, --help

可选。

显示命令帮助。

-p, --password <password>

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

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

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

--password "my password"

-s, --server https://<hostname>:8850

可选。

对 Tableau 服务管理器使用指定的地址。URL 必须以 https 开头,包括端口 8850,并使用服务器名称(而不是 IP 地址)。例如,https://<tsm_hostname>:8850。如果没有指定服务器,则假定为 https://<localhost | dnsname>:8850

--trust-admin-controller-cert

可选。

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

-u, --username <user>

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

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

感谢您的反馈!您的反馈已成功提交。谢谢!