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, Python, and Einstein Discovery. 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.

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.

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.

Beginning with version 2020.2, you can configure a different analytics extensions connection for each site on your server. In previous versions of Tableau Server, the analytics extensions configuration applied globally to all sites on the Tableau Server.

Beginning with version 2021.1, Einstein Discovery is included as an analytics extension option. Einstein Discovery in Tableau is powered by opens in a new window). Consult your agreement with opens in a new window) for applicable terms.

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.

Enable analytics extensions

Before you configure extensions, you must enable analytics extensions server-wide.

  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. Under All Sites, click Manage all sites.
      2. Click the Extensions tab.
  2. Scroll to Analytics Extensions, select Enable analytics extensions, and then click Save.

Configure analytics extensions settings

  1. Sign in to the Tableau Server Admin Area.
  2. 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.)
  3. Multi-site deployments only: you must enable Analytics Extensions on each site. Under Analytics Extensions, select Enable analytics extensions for site.
  4. Under Analytics Extensions, click Create New Connection.
  5. In the New Connection dialog, click the connection type you want to add:

  6. The options you need to configure depend on the connection type you choose:

    • For Einstein Discovery connections, click Enable.
    • For TabPy, RServer and Analytics Extensions API connections, enter the following information:
      • Connection Name: (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 HTTPS URL in the Hostname field, then you must select this option.
      • Hostname: (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 user name and password that is used to authenticate to the analytics service.
  7. Click Create.

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.

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!