The Tableau Server Repository is a PostgreSQL database that stores data about all user interactions, extract refreshes, and more.
The repository can be installed as locally on the same nodes as the Tableau Server or installed externally:
Local repository:Â The PostgreSQL Database is installed and deployed locally, meaning it is deployed along with Tableau Server.Â
External repository: The PostgreSQL Database is deployed externally. The external repository can be installed on Amazon RDS, Azure Database, Google Cloud, or as a stand-alone installation.
For more information about what Tableau Server Repository is in general, see:
The supported hosts for the external repository are:
This topic is an overview of the Tableau Server external repository.
External Repository ConsiderationsBoth Amazon RDS and Azure Database offer better scalability, reliability, high availability and security built-in for PostgreSQL. By integrating more closely with these cloud offerings, you will be able to take advantage of these additional benefits.
If you are setting up a stand-alone PostgreSQL instance, you must set up and manage high availability and scale as needed.
Important: Do not directly modify the repository. Doing so can break Tableau Server. Any customer modifications of the repository will make your installation unsupportable by Tableau.
Cloud PlatformWhen using a cloud platform to host your external repository, you have the option of running PostgreSQL instances on hosted infrastructure and managing them yourself or choosing the fully managed service option.
One of the key considerations when making a choice between self-managed and fully managed is that in a self-managed option you have the most control but with it comes the responsibility of maintaining the VMs and many database administrative tasks. A fully managed option offers ease of setup, configuration management, and maintenance.
Here is a more comprehensive list of things to consider when choosing between the two:
Here is an example of how the two options can be compared for Azure on the Microsoft site: Choose the right PostgreSQL server option in Azure,
RequirementsYour Tableau Server must be using the following versions:
2020.4 or later to use with Azure.
For the right version of PostgreSQL to use, see Azure Database for PostgreSQL Flexible Server .
Your Tableau Server must have the Advanced Management keys activated.
Depending on where you are planning to host the External Repository, you will need to be familiar with one of the following:
You must be running the correct version of PostgreSQLfor standalone Tableau Server repository. The following table shows Tableau Server version compatibility.
Note:Â The maximum compatibility version for any Tableau Server version is the minimum major version or any minor update to that. For example, if the PostgreSQL minimum compatible version is 13.4, the maximum compatible version is 13.x where <x> is equal or higher than 4.
Tableau Server versions PostgreSQLÂ minimum compatible versions2022.3.0 - 2022.3.7
2023.1.0 - 2023.1.4
13.7 2022.1.17 - 2022.1.192022.3.8 - 2022.3.19
2023.1.5 - 2023.1.15
2023.3.0 - 2023.3.8
13.11 2022.3.20 - 2022.3.x2023.1.16 - 2023.1.x
2023.3.9 - 2023.3.x
13.14 2024.0 - 2024.x 15.6 2025.1.0 - 2025.x 15.10 TopologyThe diagram below is a summarized version of the Tableau Server topology with External Repository.
The diagram below is a detailed version of the Tableau Server topology with External Repository and shows all the processes installed on each node.
Managing the External Repository License ManagementTo enable this feature you must first activate Advanced Management on Tableau Server. For more information, see About Tableau Advanced Management on Tableau Server. If you donât have Advanced Management or if the license is expired, you will see the following behavior:
If you try to configure Tableau Server to use external repository during installation, you will see an error message, but you will be able to continue the installation and Tableau Server Repository will be installed locally. For single server installations, the repository is installed on the same machine as Tableau Server. For multi-node installations, the repository is installed on one of the nodes of your Tableau Server cluster.
If you are already using an external Tableau Server Repository on your Tableau Server installation, and the Advanced Management license expires, the server will fail on restart. If you no longer have Advanced Management capabilities, but have a valid Tableau Server license, you will still be able to create a backup. You can also migrate the external repository to local repository which does not require Advanced Management to get your server up and running again. For more information on how to migrate from external repository to local repository, see Re-Configure Tableau Server Repository.
Moving your repository from local to external.
Moving your repository from external to local.
If you have only External Repository configured:
The backup and restore process remains is the same for both local and external repository and as described in the Back up Tableau Server Data topic.
The backup and restore commands work in the same manner for both local and external repository. Backup in the case where Tableau Server uses external repository requires more disk space for backup, so you should keep that in mind when configuring your disk space.
The default and other supported locations for storing the backup file are the same whether it the repository is local or external.
The following exceptions apply to Tableau Servers using external repository:
Any custom user accounts that are created in the external Tableau Server repository will be included in the restore, but the passwords for the custom user accounts will not be. The passwords will have to be reconfigured after restore is complete. Custom user accounts are PostgreSQL database user accounts, used by SQL or other database client software to connect to the PostgreSQL database.
Note: These custom accounts will be disabled as a security measure, but this can be reconfigured.
Configuration and topology should not be included in the backup. For more information on how to export configuration and topology settings, see Perform a Full Backup and Restore of Tableau Server.
If you have both External Repository and External File Store configured:
You have a couple of options if you have both External Repository and External File Store configured for your Tableau Server. These options allow you to take advantage of the snapshot backup capabilities of the cloud platforms you might be using to host the External Repository and File Store. For more information, and detailed step by step instructions, see Backup and Restore with External File Store.
SSL ConnectionsYou have the option to require or not require TLS/SSL connections from Tableau Server to the External Repository.
If you do not need to use encrypted connections, you must configure the External Repository to allow unencrypted connections, and use the --no-ssl
option when you configure the External Repository for Tableau Server. For more information, see tsm topology external-services repository enable.
If you want to enable or disable SSL at a later time, post installation, use the tsm security repository-ssl enable or tsm security repository-ssl disable. This option is available starting in 2021.4.
Updating the SSLÂ CertificateIf as part of a planned expiration of the SSL certificate of the RDS or Azure Database, Google Cloud PostgreSQLÂ instance, or a stand-alone PostgreSQLÂ instance, you need to update the instance with the new certificate file, you will also need to update Tableau Server settings to use the new certificate file. You can do this by downloading the latest file and running the tsm topology external-services repository replace-host command and providing the new certificate file.
High Availability ConsiderationsTableau Server does not manage or setup high availability for the external repository.
Â
TSM status page will show the Tableau Server external service as an additional node for your Tableau Server installation.
The topology tab indicates whether there are Tableau Server external services configured:
Getting LogsTableau Server logs will not include logs from the external repository. Use the following ways to get the logs specific to your instance:
You can use one of the following to create a PostgreSQL database instance:
Re-Configure Tableau Server Repository
Migrate from local to external
Migrate from external to local
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4