---
schema_version: "1"
id: 9353dab149aa6fab83e262bd2c128a030b0306c881146c68dd0ee77ad2985a74
title: 还原备份内容
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server/db_restore.md
canonical_url: https://help.tableau.com/v0.0/server/zh-cn/db_restore.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b0c9fa908237acd38c2c1ec5fc80b061889ecbf45a693e2d7a836d3eb67d16ea
description: Restore Tableau Server data from a backup file using tsm maintenance restore.
---
[跳转到主要内容](#main-content)

# 还原备份内容

使用 `tsm maintenance restore` 命令来还原 Tableau Server 数据。如果出现系统故障并且需要还原数据、如果您需要切换回 Tableau Server 以前的版本（举例来说，如果升级过程中出现问题），或者如果您将 Tableau Server 迁移到新硬件，则您可以这样做。您可以使用 `tsm maintenance restore` 命令来还原使用 `tabadmin backup` 和 `tsm maintenance backup` 创建的 Tableau Server 备份 。

## 还原 Tableau Server 时的限制

- 如果您使用 [tsm maintenance（备份和还原）](https://help.tableau.com/v0.0/server/zh-cn/cli_maintenance_tsm.htm)方法执行蓝/绿升级或手动升级 Tableau Server 2021.4（或更低版本），则必须启用 `legacy-identity-mode`，然后才能还原到 Tableau Server 2022.1（或更高版本）。有关详细信息，请参见[对身份迁移问题进行故障排除](https://help.tableau.com/v0.0/server/zh-cn/identity_migration_troubleshoot.htm)。
- 在还原 Tableau Server 时，通过其他方式建立的数据库备份以及虚拟计算机快照是无效数据源。
- 使用 `tsm maintenance restore` 还原 Tableau 数据时，备份文件 (`.tsbak`) 中的内容会覆盖数据提取文件以及 PostgreSQL 数据库的内容。如果您正在运行 Tableau Server 的分布式安装，请在运行 TSM 控制器的节点（通常是初始节点）上执行还原。
- 您只能从身份存储与运行服务器类型相同的备份中进行还原。例如，使用本地身份验证的服务器中的备份只能还原到使用本地身份验证初始化的 Tableau Server，但使用 Active Directory 身份验证的服务器中的备份无法还原到使用本地身份验证初始化的服务器。
- 您只能将备份文件还原到与在其上创建备份的版本相同或比该版本新的 Tableau Server 版本。您无法还原到 Tableau 的较旧版本。
- 从版本 2022.3 开始，不支持使用 tabadmin 创建的备份（“TSM 之前的备份”）。您无法将 TSM 之前的备份还原到 Tableau Server 版本 2022.3 或更高版本。
- 在还原过程中，还原过程将启动 Tableau Server 管理的内容和外部资产的完整重新索引。此过程消耗 CPU 资源，在备份和还原过程中可能会明显。

## 从备份文件还原 Tableau Server

**注意：**此操作包括您可能需要使用 TSM 命令行执行的步骤。若要使用 TSM CLI，您需要在安装中的一个节点上对命令行具有管理员访问权限，并需要 TSM 管理员凭据来运行 TSM 命令。

1. （可选）将 `.tsbak` 文件复制到默认文件位置。
    
    `restore` 命令需要 TSM `basefilepath.backuprestore` 变量定义的目录中有备份文件。默认情况下：
    
    `` `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\` ``
    
    有关文件路径及其修改方式的详细信息，请参见[tsm File Paths](https://help.tableau.com/v0.0/server/zh-cn/cli_default_filepaths_tsm.htm)。
    
    **注意：**如果要还原复制到备份文件夹中的备份，请确保运行身份服务帐户（可在 TSM Web UI 中的“**安全性**”下找到）至少具有备份文件的“读取”访问权限。否则，还原过程可能无法解压缩备份文件，并且还原将失败。
2. 停止服务器。在命令提示符处，键入：
    
    `tsm stop`
3. 从备份文件进行还原。在命令提示符处，键入：
    
    `tsm maintenance restore --file <file_name>`
    
    在上面的行中，将 `<file_name>` 替换为要用来进行还原的备份文件的名称。
4. 重新启动服务器：
    
    `tsm start`