With the 2022.1 release, the Esri connector replaced the Esri ArcGIS Server connector. The workbooks you created with the Esri ArcGIS Server (including published ones) will continue to function normally. All of those workbooks are built on extracts that will be valid indefinitely. You can create new workbooks with the Esri connector.

Esri Connector

Note: This connector was replaced by the Esri connector with the release of 2022.1. You can use the Esri connector to create new workbooks.

This article describes how to connect Tableau to an Esri Server and set up the data source.

  • The connector supports connections via GeoService API.

Before you begin

Before you begin, gather this connection information:

  • URL for the Esri Server that you want to connect to

  • URL for the GeoService API that points to the data you want to connect to

In Esri, make sure that the following conditions are met:

  • Be sure to publish data to ArcGIS Online and share as "Public".

  • Publish your data in a geo-database to ensure pagination support.

  • Enable Query capability for published Esri services.

Driver required

This connector requires a driver to talk to the database. You might already have the required driver installed on your computer. If the driver is not installed on your computer, Tableau displays a message in the connection dialog box with a link to the Driver Download(Link opens in a new window) page where you can find driver links and installation instructions.

Make the connection and set up the data source

  1. Start Tableau and under Connect, select Esri. Then do the following:
    1. Enter the URL for the Esri Server that hosts the tables that you want to connect to.

      Tips:

      • Use https URLs and make them as specific as possible to speed performance. Tableau’s Web Data Connector (WDC) framework supports only HTTPS endpoints and scans every service in the instance.

        It's best to specify a folder, service, or service layer rather than a root URL. Examples:

        • Root: https://gis.oregonmetro.gov/arcgis/rest/

        • Folder: https://gis.oregonmetro.gov/arcgis/rest/services/OpenData

        • Service: https://gis.oregonmetro.gov/arcgis/rest/services/OpenData/BoundaryData/MapServer

        • Service Layer: https://gis.oregonmetro.gov/arcgis/rest/services/OpenData/BoundaryData/MapServer/0

  2. On the data source page, do the following:

    1. (Optional) Select the default data source name at the top of the page, and then enter a unique data source name for use in Tableau. For example, use a data source naming convention that helps other users of the data source figure out which data source to connect to.

    2. Under Table, select a table or use the search field to search for a table by name.

    3. Drag a table to the canvas, and then select the sheet tab to start your analysis.

Troubleshooting Esri connections

Since the Esri connector is built around the Web Data Connector (WDC), there are several limits to be aware of.

  • The Esri connector doesn’t support definition queries.
  • The Esri connector doesn’t support live connections, and will always create an extract. A packaged workbook with an ArcGIS connection can be opened in versions of Tableau older than 2019.4, but you can't refresh the extract.
  • The connector searches only for MapServer and FeatureServer service types.
  • The connector ignores the esriFieldTypeBlob and esriFieldTypeRaster types.
  • Esri geometry types are limited to the following:
    • esriGeometryPoint
    • esriGeometryMultipoint
    • esriGeometryLine
    • esriGeometryPath
    • esriGeometryPolyline
    • esriGeometryPolygon
    • esriGeometryEnvelope
  • If the ArcGIS Server contains multiple layers or tables with identical names within a service, only one is displayed.
  • Editing the connection can cause an "Invalid map <k,t>" error. If that happens, close, and reopen the workbook.

Note: When you use an OAuth connection, only items in the "Owners" user account display.

License disclosures

The Esri Connector uses the arcgis-to-geojson-utils(Link opens in a new window) open source library under the Apache License version 2.0(Link opens in a new window). A copy of the license is available in the repository’s LICENSE(Link opens in a new window) file.

See also

Thanks for your feedback!