Esri ArcGIS Server

This article describes how to connect Tableau to an Esri ArcGIS Server and set up the data source. The connector also supports connections via GeoService API.

This connector works with ArcGIS Server (AGS) v10.3.1 and higher.

Note: This connector uses Tableau’s Web Data Connector (WDC), which requires an internet connection and the ability to reach https://connectors.tableau.com/esri/arcgis-server/1/arcgis-server.html.

Before you begin

Before you begin, gather this connection information:

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

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

In Esri ArcGIS Server, 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.

Make the connection and set up the data source

  1. Start Tableau and under Connect, select Esri ArcGIS Server. For a complete list of data connections, select More under To a Server. Then do the following:
    1. Enter the URL for the Esri ArcGIS 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 ArcGIS connections

Because the Esri ArcGIS Server connector is built around the Web Data Connector (WDC), there are several limitations to be aware of.

  • The Esri ArcGIS Server connector does not support definition queries.
  • The Esri ArcGIS Server connector does not 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 will be unable to 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 may cause an "Invalid map <k,t>" error. If that happens, close and reopen the workbook.

License disclosures

The Esri ArcGIS Server 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! There was an error submitting your feedback. Please try again.