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 import
和 tsm 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 import
和 tsm 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
也为必需。指定用户帐户。如果未包括此选项,则使用您登录所使用的凭据运行该命令。