---
schema_version: "1"
id: be871c86898b4ec9d8e4993fc3203743ea34a16d0985391c1c2b15e17053fcb4
title: 针对 PostgreSQL 新的主要版本升级包含外部存储库的 Tableau Server
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server/server_external_repo_upgrade_postgres.md
canonical_url: https://help.tableau.com/current/server/zh-cn/server_external_repo_upgrade_postgres.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b75edd219046927e37aa0d6d6f30f431dc61465fe6148f051628e56dd3d3acb7
description: Upgrade Tableau Server with an external repository for a new major PostgreSQL version.
---
[跳转到主要内容](#main-content)

# 针对 PostgreSQL 新的主要版本升级包含外部存储库的 Tableau Server

当 Tableau Server 的 PostgreSQL 主要版本要求发生更改时，您必须遵循一些特定说明，以确保 Tableau Server 升级成功。例如，Tableau Server 2020.4 要求存储库使用 PostgreSQL 版本 12。这是与 2020.4 之前在 Tableau Server 版本中使用的 PostgreSQL 版本 9.x 的主要版本更改。因此，如果要从早期版本的 Tableau Server 升级到版本 2020.4 或更高版本，则需要执行以下各节中介绍的步骤才能完成升级。

本主题还包括 PostgreSQL 和 Tableau Server 之间的产品兼容性。

## 升级之前

您不能执行就地升级来更新 Amazon RDS 或 Azure Database for PostgreSQL DB 上现有 PostgreSQL DB 实例上的 PostgreSQL 版本。相反，您必须创建一个新实例，并在升级期间将 Tableau Server 指向新实例。使用以下信息来创建新实例并准备升级：

1. 创建 PostgreSQL 数据库实例的新实例：
    1. [在 AWS 关系数据库服务 (RDS) 上创建 PostgreSQL DB 实例](https://help.tableau.com/current/server/zh-cn/server_external_repo_configure_RDS.htm)
    2. [在 Azure 上创建 Azure 数据库 PostgreSQL 实例](https://help.tableau.com/current/server/zh-cn/server_external_repo_configure_Azure.htm)
    3. [在 Google Cloud 上创建 PostgreSQL 实例](https://help.tableau.com/current/server/zh-cn/server_external_repo_configure_gcp.htm)
    4. [以独立安装的形式创建 PostgreSQL 数据库](https://help.tableau.com/current/server/zh-cn/server_external_repo_configure_standalone.htm)
2. SSL 连接**不是**必需的，但建议使用。如果要为 Tableau Server 和外部存储库之间的通信设置 SSL 连接，请执行以下操作：
    - **Amazon RDS：**请参见[使用 SSL 对 DB 实例连接进行加密](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.SSL)。
    - **Azure Database**：请参见[为 Azure Database for PostgreSQL 配置 TLS 连接](https://docs.microsoft.com/zh-cn/azure/postgresql/concepts-ssl-connection-security)。
    - **Google Cloud 实例：**请参见 [Configuring SSL/TLS certificates（配置 SSL/TLS 证书）](https://www.google.com/url?q=https://cloud.google.com/sql/docs/postgres/configure-ssl-instance&sa=D&source=docs&ust=1635271250769000&usg=AOvVaw3YRZJ0JQdXSkhNjdOxhuww)
    - **独立 PostgreSQL 实例：**请参见[配置 SSL](https://help.tableau.com/current/server/zh-cn/server_external_repo_configure_standalone.htm#configure-ssl)。
3. 为在步骤 1 中创建的新实例创建配置文件。
    
    创建具有以下配置设置的 json 文件：
    
    {
     "flavor":"<flavor name>",
     "masterUsername":"<admin user name>",
     "masterPassword":"<password>", 
     "host":"<instance host name>",
     "port":5432
    }
    
    - **flavor：**您将为 Tableau Server 存储库使用这种类型的外部服务。
        
        - Amazon RDS：使用“rds”
        - Azure 数据库：使用“azure”
        - Google Cloud 数据库：使用“gcp”
        - 独立 PostgreSQL 数据库：使用“generic”
    - **masterUsername：**
        
        - **Amazon RDS**：为用户名使用“rails”。这是您在创建 RDS 实例时指定的用户。
            
            > [!IMPORTANT]
            > 
            > 您必须使用“rails”作为 masterUsername。外部存储库必须需要此项才能与 Tableau Server 正常搭配工作。
        - **Azure Database、Google Cloud 实例和独立 PostgreSQL 实例**：选择满足您要求的用户名。我们建议使用 **postgres** 作为管理员用户名。如果选择使用其他用户名，请确保用户名不以 **pg** 或 **azure** 开头。用户名也不能是 **rails**、**tblwgadmin**、**tableau**、**readonly** 或 **tbladminviews**。
    - **masterPassword**：这是在创建 PostgreSQL 数据库实例时指定的同一密码。
    - **host**：这是 PostgreSQL 数据库实例的端点。
    - **port**：创建 PostgreSQL DB 实例时指定的数据库端口。PostgreSQL 的默认端口为 5432。

## Tableau Server 升级

**注意**：如果您使用的是 Tableau Server 外部存储库，则必须使用命令行选项升级 Tableau Server。

以下是在运行升级脚本时如何指定外部存储库参数的高级别步骤。

有关 Tableau Server 升级过程的完整演练，请参见[从更低版本升级](https://help.tableau.com/current/server/zh-cn/sug_plan.htm)。

1. 在 Tableau Server 上，以管理员身份打开命令提示符。
    
    **注意：**您必须打开一个新的命令窗口，因为安装程序会更新新安装的路径。
2. 导航到新安装位置中的 scripts 文件夹。
    
    默认情况下：
    
    `C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\`
3. 运行升级脚本并指定配置文件和 SSL 证书：
    
    `upgrade-tsm.cmd --external-repository-config-file=<json config file> --external-repository-cert-file=<SSL certificate file>`

## 产品兼容性

下表列出了 Tableau Server 支持的 PostgreSQL 版本。使用此表可以确定要为外部存储库安装的 PostgreSQL 版本。

  
**Amazon RDS 支持：**Tableau Server 版本 2019.3 及更高版本上支持使用 Amazon RDS 的外部存储库。  
**Azure Database 支持：**Tableau Server 版本 2020.4 及更高版本上支持使用 Azure Database 实例的外部存储库。

**Google Cloud 支持：**Tableau Server 版本 2021.4 及更高版本上支持使用 Google Cloud SQL 的外部存储库。  
**独立 PostgreSQL 实例支持：**Tableau Server 版本 2021.2 及更高版本上支持使用独立安装的 PostgreSQL 数据库的外部存储库。

Google Cloud Platform 支持：Tableau Server 2021.4 及更高版本上支持在 Google Cloud Platform 上使用 PostgreSQL 实例的外部存储库。

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>Tableau Server 版本</th><th>PostgreSQL 最低兼容版本</th></tr><tr><td><p>2022.3.0 - 2022.3.7</p><p>2023.1.0 - 2023.1.4</p></td><td>13.7</td></tr><tr><td>2022.1.17 - 2022.1.19<p>2022.3.8 - 2022.3.19</p><p>2023.1.5 - 2023.1.15</p><p>2023.3.0 - 2023.3.8</p></td><td>13.11</td></tr><tr><td>2022.3.20 - 2022.3.x<p>2023.1.16 - 2023.1.x</p><p>2023.3.9 - 2023.3.x</p></td><td>13.14</td></tr><tr><td>2024.0 - 2024.2.8</td><td>15.6</td></tr><tr><td>2024.2.9 - 2024.2.13<p>2025.1.0 - 2025.1.6</p></td><td>15.10</td></tr><tr><td>2024.2.14 - 2024.2.16 <p>2025.1.7 - 2025.1.9</p></td><td>15.13</td></tr><tr><td><p>2024.2.17</p><p>2025.1.10</p><p>2025.3 - 2025.3.5</p></td><td>15.14</td></tr><tr><td>2025.3.6</td><td>15.16</td></tr><tr><td><p>2026.2.x</p></td><td>17.7</td></tr></tbody></table>

旧版兼容性

下表包括两列：

1. Tableau Server 附带的 PostgreSQL 版本，该版本是 Tableau Server 为本地存储库安装的版本。
2. 外部存储库支持的所有 PostgreSQL 版本

**注意：**  
\- 对于版本 10 之前的 PostgreSQL 版本，前两位表示主要版本，次要版本由最后一位数表示。例如，在版本 9.4.1 中，9.4 表示主要版本，.1 表示次要版本。  
\- 对于 PostgreSQL 版本 10 或更高版本，第一位数表示主要版本，次要版本由最后一位数表示。例如，在版本 11.1 中，11 是主要版本，.1 是次要版本。  
\- 主要版本与 Tableau server 附带的 Postgres 版本相等并且次要版本高于该版本的 Postgres 版本始终可与外部存储库以及任何显式允许的较旧版本一起使用。

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr style="height: 35px;"><td>Tableau Server 版本</td><td>PostgreSQL 版本（Tableau Server 附带）</td><td>外部存储库支持的备用 PostgreSQL 版本</td></tr><tr><td>2019.3 - 2019.3.3</td><td>9.6.11</td><td><p>9.6.x，其中 x 大于 11</p></td></tr><tr><td>2019.3.4 - 2019.3.10</td><td>9.6.15</td><td>9.6.x，其中 x 大于 15</td></tr><tr><td>2019.3.11 - 2019.3.14</td><td>9.6.17</td><td>9.6.15 或 9.6.x，其中 x 大于 17</td></tr><tr><td>2019.4 - 2019.4.1</td><td>9.6.14</td><td>9.6.x，其中 x 大于 14</td></tr><tr><td>2019.4.2 - 2019.4.6</td><td>9.6.15</td><td>9.6.x，其中 x 大于 15</td></tr><tr><td>2019.4.7 - 2019.4.13</td><td>9.6.17</td><td>9.6.15 或 9.6.x，其中 x 大于 17</td></tr><tr><td>2020.1 - 2020.1.6</td><td>9.6.15</td><td>9.6.x，其中 x 大于 15</td></tr><tr><td>2020.1.7 - 2020.3.2</td><td>9.6.17</td><td>9.6.15 或 9.6.x，其中 x 大于 17</td></tr><tr><td>2020.4 - 2021.4</td><td>12.8</td><td><p>12.8 或 12.x，其中 x 大于 8</p></td></tr><tr><td>2022.1 及更高版本</td><td>13.3</td><td>13.3 或 13.x，其中 x 大于 3</td></tr></tbody></table>

## 谁可以执行此操作

Tableau Server 管理员可以升级和配置 Tableau Server。