tsm sites

  • 版本 :2022.1 及更高版本

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

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

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

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

tsm sites export

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

注意:如果发生错误,tsm sites importtsm 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 importtsm 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 也为必需。

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