Configure Connection with Analytics Extensions
Tableau supports a set of functions that your users can use to pass expressions to analytics extensions for integration with R and Python. Previously, this feature was referred to "external services." Beginning in version 2020.1, this functionality is referred to as analytics extensions.
This topic describes how to configure sites on Tableau Server with analytics extensions.
For more information about user scenarios and configuring Tableau Desktop, see Pass Expressions Analytics Extensions(Link opens in a new window), in the Tableau Desktop and Web Authoring Help.
Because Tableau Server provides an authentication mechanism, it can be more secure to expose analytics extensions functionality to users through Tableau Server than in Tableau Desktop.
In previous versions of Tableau Server, the analytics extensions configuration applied globally to all sites on the Tableau Server. Beginning with version 2020.2, you can configure a different analytics extensions connection for each site.
To configure SSL for analytics extensions, you must install a valid certificate on the computer running Tableau Server. The certificate must be trusted by the computer running Tableau Server. The certificate Subject field or one of the SAN entries on must exactly match the URI of the analytics extensions service configuration.
Enable analytics extensions
Before you configure extensions, you must enable analytics extensions server-wide.
Sign in to the Tableau Server Admin Area.
- If you only have a single site (default) on your server, click Settings, and then go to Step 2.
- If you have multiple sites on your server:
- Under All Sites, click Manage all sites.
- Click the Extensions tab.
- Scroll to Analytics Extensions, select Enable analytics extension, and then click Save.
Configure analytics extensions settings
- Sign in to the Tableau Server Admin Area.
- On the Settings page, click the Extensions tab and then scroll to Analytics Extensions. (On multi-site deployments of Tableau Server, navigate to the site where you want to configure analytics extensions, and then click Settings>Extensions.)
- Multi-site deployments only: you must enable Analytics Extensions on each site. Under Analytics Extensions, select Enable analytics extensions for site.
- Under Analytics Extensions, click Create new connection.
- In Analytics Extension Connection, enter the configuration settings for your analytics service:
- Connection Type: (Required) Specify the server type you are connecting to. RSERVE supports connections to R via the RServe package. TABPY supports connections to Python via TabPy or to other analytics extensions.
- Require SSL (Recommended): Select this option to encrypt the connection to the analytics service. If you specify a
HTTPSURL in the Host field, then you must select this option.
- Host: (Required) Specify the computer name or URL where the analytics service is running. This field is case sensitive.
- Port: (Required) Specify the port for the service.
- Sign in with a username and password(Recommended): Select this option to specify username and password that is used to authenticate to the analytics service.
- Click Save.
Edit or delete an analytics extension connection
To edit or delete a configuration, navigate to Analytics Extensions on the Extensions tab of your site.
Click Edit or Delete and follow the prompts to change the configuration.
Client requirement: Intermediate certificate chain for Rserve external service
As of Tableau Server version 2020.1, you must install a full certificate chain on Tableau Desktop computers (Windows and Mac) that are connecting to a Rserve external connection through Tableau Server. This requirement is due to how Rserve manages the handshake on secure connections.
Importing a root certificate on the Tableau Desktop is not sufficient, the entire certificate chain must be imported onto the client computer.
Tableau cannot verify that workbooks that use an analytics extension will render properly on Tableau Server. There might be scenarios where a required statistical library is available on a user’s computer but not on the analytics extension instance that Tableau Server is using.
A warning will be displayed when you publish a workbook if it contains views that use an analytics extension.
This worksheet contains external service scripts, which cannot be viewed on the target platform until the administrator configures an external service connection.