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.

Server SSL

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.

Configure

  1. 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:
      1. Click Settings to open the server-wide configuration page, and then click the Extensions tab.
      2. Scroll to Analytics Extensions, select Enable analytics extension, and then click Save.
      3. Navigate to the site where you want to configure analytics extensions, click Settings, and then go to Step 2.
  2. Click the Extensions tab and then scroll to Analytics Extensions.
  3. Enable and configure the connection for the site.
    • 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.
    • 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.
    • Authentication (Recommended): Select this option to specify username and password that is used to authenticate to the analytics service.
    • Require SSL (Recommended): Select this option to encrypt the connection to the analytics service. If you specify a HTTPS URL in the Host field, then you must select this option.
  4. Click Save.

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.

Script errors

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.

Thanks for your feedback! There was an error submitting your feedback. Please try again.