Microsoft SQL Server ingestion connector

This page helps you understand the SQL Server ingestion workflow, including the factors that determine your setup approach and the steps involved for different user personas.

What to know before you start

Topic	Why it matters
Azure Databricks user persona	The workflow depends on your Azure Databricks user persona: Single-user: An admin user configures the source database and creates a Unity Catalog connection, an ingestion gateway, and an ingestion pipeline. Multi-user: An admin user configures the source database and creates a connection for non-admin users to create gateway-pipeline pairs with.
Database variation	The source database configuration depends on the SQL Server deployment environment.
Change tracking method	The source database configuration depends on how you choose to track changes in the source.
Authentication method	The steps to create a connection depend on the authentication method you choose.
Interface	The steps to create a connection, a gateway, and a pipeline depend on the interface.
Ingestion frequency	The pipeline schedule depends on your latency and cost requirements.
Common patterns	Depending on your ingestion needs, the pipeline might use configurations like history tracking, column selection, and row filtering. Supported configurations vary by connector. See Feature availability.

Start ingesting from SQL Server

The following table provides an overview of the end-to-end SQL Server ingestion workflow, based on user type:

User	Steps
Admin	Configure Microsoft SQL Server for ingestion into Azure Databricks. Either: Use Catalog Explorer to create a connection so that non-admins can create gateway-pipeline pairs. See SQL Server. Use the data ingestion UI to create a connection, a gateway, and a pipeline. See Ingest data from SQL Server.
Non-admin	Use any supported interface to create a gateway and a pipeline. See Ingest data from SQL Server.

Feature availability

Feature	Availability
UI-based pipeline authoring	Supported
API-based pipeline authoring	Supported
Declarative Automation Bundles	Supported
Incremental ingestion	Supported
Unity Catalog governance	Supported
Orchestration using Databricks Workflows	Supported
SCD type 2	Supported
API-based column selection and deselection	Supported
API-based row filtering	Not supported
Automated schema evolution: New and deleted columns	Supported
Automated schema evolution: Data type changes	Not supported
Automated schema evolution: Column renames	Not supported Requires a full refresh.
Automated schema evolution: New tables	Supported If you ingest the entire schema. See the limitations on the number of tables per pipeline.
Maximum number of tables per pipeline	250

Authentication methods

Authentication method	Availability
OAuth U2M	Not supported
OAuth M2M	Not supported
OAuth (manual refresh token)	Not supported
Basic authentication (username/password)	Supported
Basic authentication (API key)	Not supported
Basic authentication (service account JSON key)	Not supported