Edit

Share via

Supported data sources in Azure Data Catalog

  • Article

Important

Azure Data Catalog is being retired on May 15, 2024.

New Azure Data Catalog accounts can no longer be created.

For data catalog features, please use the Microsoft Purview service, which offers unified data governance for your entire data estate.

If you're already using Azure Data Catalog, you'll need to create a migration plan for your organization to move to Microsoft Purview by May 15, 2024.

You can publish metadata by using a public API or a click-once registration tool, or by manually entering information directly to the Azure Data Catalog web portal. The following table summarizes all data sources that are supported by the catalog today, and the publishing capabilities for each. Also listed are the external data tools that each data source can launch from our portal "open-in" experience. The second table contains a more technical specification of each data-source connection property.

List of supported data sources

Data source object API Manual entry Registration tool Open-in tools Notes
Azure Data Lake Store directory (Only Gen 1) ✓ ✓ ✓
Azure Data Lake Store file (Only Gen 1) ✓ ✓ ✓
Azure Blob storage ✓ ✓ ✓ Power BI Desktop
Azure Storage directory ✓ ✓ ✓ Power BI Desktop
Azure Storage table ✓ ✓ ✓
HDFS directory ✓ ✓ ✓
HDFS file ✓ ✓ ✓
Hive table ✓ ✓ ✓ Excel
Hive view ✓ ✓ ✓ Excel
MySQL table ✓ ✓ ✓ Excel, Power BI Desktop
MySQL view ✓ ✓ ✓ Excel, Power BI Desktop
Oracle Database table ✓ ✓ ✓ Excel, Power BI Desktop Oracle 10 and later versions.
Oracle Database view ✓ ✓ ✓ Excel, Power BI Desktop Oracle 10 and later versions.
Other (generic asset) ✓ ✓
Azure Synapse Analytics table ✓ ✓ ✓ Excel, Power BI Desktop, SQL Server data tools
Azure Synapse Analytics view ✓ ✓ ✓ Excel, Power BI Desktop, SQL Server data tools
SQL Server Analysis Services dimension ✓ ✓ ✓ Excel, Power BI Desktop SQL Server 2008 and later versions.
SQL Server Analysis Services KPI ✓ ✓ ✓ Excel, Power BI Desktop SQL Server 2008 and later versions.
SQL Server Analysis Services measure ✓ ✓ ✓ Excel, Power BI Desktop SQL Server 2008 and later versions.
SQL Server Analysis Services table ✓ ✓ ✓ Excel, Power BI Desktop SQL Server 2008 and later versions.
SQL Server Reporting Services report ✓ ✓ ✓ Browser Native mode servers only. SharePoint mode isn't supported. SQL Server 2008 and later versions only
SQL Server table ✓ ✓ ✓ Excel, Power BI Desktop, SQL Server data tools SQL Server 2008 and later versions.
SQL Server view ✓ ✓ ✓ Excel, Power BI Desktop, SQL Server data tools SQL Server 2008 and later versions.
Teradata table ✓ ✓ ✓ Excel
Teradata view ✓ ✓ ✓ Excel
SAP Business Warehouse ✓ ✓ ✓ Only works in English. Measures are unsupported.
SAP HANA view ✓ ✓ ✓ Power BI Desktop
DB2 table ✓ ✓ ✓
DB2 view ✓ ✓ ✓
File system file ✓
FTP directory ✓ ✓ ✓
FTP file ✓ ✓ ✓
HTTP report ✓
HTTP endpoint ✓
HTTP file ✓
OData entity set ✓
OData function ✓
PostgreSQL table ✓ ✓ ✓
PostgreSQL view ✓ ✓ ✓
SAP HANA view ✓
Salesforce object ✓ ✓ ✓
SharePoint list ✓
Azure Cosmos DB collection ✓ ✓ ✓ Only legacy collections from Azure DocumentDB and Azure Cosmos DB for NoSQL are compatible. Newer Azure Cosmos DB APIs aren't yet supported. Choose Azure DocumentDB in the Data Source list.
Generic ODBC table ✓ ✓ ✓
Generic ODBC view ✓ ✓ ✓
Cassandra table ✓ ✓ ✓ Publish as a generic ODBC asset
Cassandra view ✓ ✓ ✓ Publish as a generic ODBC asset
Sybase table ✓ ✓ ✓
Sybase view ✓ ✓ ✓
MongoDB table ✓ ✓ ✓ Publish as a generic ODBC asset
MongoDB view ✓ ✓ ✓ Publish as a generic ODBC asset

If you want to see a specific data source supported, suggest it (or voice your support if it has already been suggested) by going to the Data Catalog on the Azure Feedback Forums.

Data-source reference specification

Note

The DSL structure column in the following table lists only the connection properties for "address" property bag that are used by Azure Data Catalog. That is, "address" property bag can contain other connection properties of the data source which Azure Data Catalog persists, but does not use.

Source type Asset type Object types DSL structure
Azure Data Lake Store Container Data Lake Protocol: webhdfs
Authentication: {basic, oauth}
Address:
      url
Azure Data Lake Store Table Directory, file Protocol: webhdfs
Authentication: {basic, oauth}
Address:
      url
Azure Storage Container Container Protocol: azure-blobs
Authentication: {azure-access-key}
Address:
      domain
      account
      container
Azure Storage Table Blob, directory Protocol: azure-blobs
Authentication: {azure-access-key}
Address:
      domain
      account
      container
      name
Azure Storage Container Container Protocol: azure-tables
Authentication: {azure-access-key}
Address:
      domain
      account
Azure Storage Table Table Protocol: azure-tables
Authentication: {azure-access-key}
Address:
      domain
      account
      name
Datazen Container Site Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
Datazen Report Report, dashboard Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
DB2 Container Database Protocol: db2
Authentication: {basic, windows}
Address:
      server
      database
DB2 Table Table, view Protocol: db2
Authentication: {basic, windows}
Address:
      server
      database
      object
      schema
File system Table File Protocol: file
Authentication: {none, basic, windows}
Address:
      path
FTP Table Directory, file Protocol: ftp
Authentication: {none, basic, windows}
Address:
      url
Hadoop Distributed File System Container Cluster Protocol: webhdfs
Authentication: {basic, oauth}
Address:
      url
Hadoop Distributed File System Table Directory, file Protocol: webhdfs
Authentication: {basic, oauth}
Address:
      url
Hive Container Database Protocol: hive
Authentication: {HDInsight, basic, username, none}
Address:
      server
      database
connectionProperties:
      serverProtocol: {hive2}
Hive Table Table, view Protocol: hive
Authentication: {HDInsight, basic, username, none}
Address:
      server
      database
      object
connectionProperties:
      serverProtocol: {hive2}
HTTP Container Site Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
HTTP Report Report, dashboard Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
HTTP Table Endpoint, file Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
MySQL Container Database Protocol: mysql
Authentication: {protocol, windows}
Address:
      server
      database
MySQL Table Table, view Protocol: mysql
Authentication: {protocol, windows}
Address:
      server
      database
      object
OData Container Entity container Protocol: odata
Authentication: {none, basic, windows}
Address:
      url
OData Table Entity set, function Protocol: odata
Authentication: {none, basic, windows}
Address:
      url
      resource
Oracle Database Container Database Protocol: oracle
Authentication: {protocol, windows}
Address:
      server
      database
Oracle Database Table Table, view Protocol: oracle
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
PostgreSQL Container Database Protocol: postgresql
Authentication: {basic, windows}
Address:
      server
      database
PostgreSQL Table Table, view Protocol: postgresql
Authentication: {basic, windows}
Address:
      server
      database
      schema
      object
Power BI Desktop Container Site Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
Power BI Desktop Report Report, dashboard Protocol: http
Authentication: {none, basic, windows, oauth}
Address:
      url
Power Query Table Data mashup Protocol: power-query
Authentication: {oauth}
Address:
      url
Salesforce Table Object Protocol: salesforce-com
Authentication: {basic, windows}
Address:
      loginServer
      class
      itemName
SAP HANA Container Server Protocol: sap-hana-sql
Authentication: {protocol, windows}
Address:
      server
SAP HANA Table View Protocol: sap-hana-sql
Authentication: {protocol, windows}
Address:
      server
      schema
      object
SharePoint Table List Protocol: sharepoint-list
Authentication: {basic, windows}
Address:
      url
Azure Synapse Analytics Command Stored procedure Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
Azure Synapse Analytics TableValuedFunction Table-valued function Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
Azure Synapse Analytics Container Database Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
Azure Synapse Analytics Table Table, view Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
SQL Server Command Stored procedure Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
SQL Server TableValuedFunction Table-valued function Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
SQL Server Container Database Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
SQL Server Table Table, view Protocol: tds
Authentication: {protocol, windows}
Address:
      server
      database
      schema
      object
SQL Server Analysis Services multidimensional Container Model Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
SQL Server Analysis Services multidimensional KPI KPI Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
      object
      objectType: {KPI}
SQL Server Analysis Services multidimensional Measure Measure Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
      object
      objectType: {Measure}
SQL Server Analysis Services multidimensional Table Dimension Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
      object
      objectType: {Dimension}
SQL Server Analysis Services tabular Container Model Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
SQL Server Analysis Services tabular KPI KPI Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
      object
      objectType: {KPI}
SQL Server Analysis Services tabular Measure Measure Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
      object
      objectType: {Measure}
SQL Server Analysis Services tabular Table Table Protocol: analysis-services
Authentication: {windows, basic, anonymous, none}
Address:
      server
      database
      model
      object
      objectType: {Table}
SQL Server Reporting Services Container Server Protocol: reporting-services
Authentication: {windows}
Address:
      server
      version: {ReportingService2010}
SQL Server Reporting Services Report Report Protocol: reporting-services
Authentication: {windows}
Address:
      server
      path
      version: {ReportingService2010}
Teradata Container Database Protocol: teradata
Authentication: {protocol, windows}
Address:
      server
      database
Teradata Table Table, view Protocol: teradata
Authentication: {protocol, windows}
Address:
      server
      database
      object
SQL Server Master Data Services Container Model Protocol: mssql-mds
Authentication: {windows}
Address:
      url
      model
      version
SQL Server Master Data Services Table Entity Protocol: mssql-mds
Authentication: {windows}
Address:
      url
      model
      version
      entity
Azure Cosmos DB Container Database Protocol: document-db
Authentication: {azure-access-key}
Address:
      url
      database
Azure Cosmos DB Collection Collection Protocol: document-db
Authentication: {azure-access-key}
Address:
      url
      database
      collection
Generic ODBC Container Database Protocol: odbc
Authentication: {basic, windows}
Address:
      options
      database
Generic ODBC Table Table, View Protocol: odbc
Authentication: {basic, windows}
Address:
      options
      database
      object
      schema
Sybase Container Database protocol: sybase
authentication: {basic, windows}
address:
      server
      database
Sybase Table Table, View protocol: sybase
authentication: {basic, windows}
address:
      server
      database
      schema
      object
Other (none of the above) ✱ ✱ Protocol: generic-asset
Address:
      assetId