Microsoft Azure Synapse¶

The Microsoft Azure Synapse connection type enables the Azure Synapse Integrations.

Authenticating to Azure Synapse¶

There are three ways to connect to Azure Synapse using Airflow.

Use token credentials i.e. add specific credentials (client_id, secret, tenant) and subscription id to the Airflow connection.
Use managed identity by setting managed_identity_client_id, workload_identity_tenant_id (under the hook, it uses DefaultAzureCredential with these arguments)
Fallback on DefaultAzureCredential. This includes a mechanism to try different options to authenticate: Managed System Identity, environment variables, authentication through Azure CLI…

All hooks and operators related to Microsoft Azure Synapse use azure_synapse_default by default.

Client ID: Specify the client_id used for the initial connection. This is needed for token credentials authentication mechanism. It can be left out to fall back on DefaultAzureCredential.
Secret: Specify the secret used for the initial connection. This is needed for token credentials authentication mechanism. It can be left out to fall back on DefaultAzureCredential.
Tenant ID: Specify the tenantId used for the initial connection. This is needed for token credentials authentication mechanism. It can be left out to fall back on DefaultAzureCredential.
Subscription ID: subscriptionId is required for the connection. This is needed for all authentication mechanisms.
Synapse Workspace URL: Specify the Azure Synapse endpoint to interface with.