Configure Connection to Azure Data Explorer Data Source

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

Customer Managed Applies to customer-managed instances of Alation

Enhanced Connector Enhanced connectors add extended capabilities and require a separate entitlement in addition to your Alation platform license.

After you install the Azure Data Explorer Enhanced connector and create an Azure Data Explorer data source in Alation, configure the connection settings on the Settings page of the data source.

  1. Provide Access

  2. Connect to Data Source

Provide Access

You manage the catalog visibility of the Azure Data Explorer data source on the Access tab of the settings. Refer to Configure Access to OCF Data Sources for information on how to configure the Access tab.

Connect to Data Source

To establish a connection to the data source, you must configure the following settings under Connector Settings on the General Settings tab:

Application Settings

Specify Application Settings if applicable. Save the changes after providing the information by clicking Save.

Specify Application Settings if applicable. Click Save to save the changes after providing the information.

Parameter

Description

BI Connection Info

This parameter is used to generate lineage between the current data source and another source in the catalog, for example a BI source that retrieves data from the underlying . database

The parameter accepts host and port information of the corresponding BI data source connection.

Use the following format: host:port

You can provide multiple values as a comma-separated list:

10.13.71.216:1541,sever.com:1542

Find more details in BI Connection Info

Enable Automatic Lineage Generation

The Enable Automatic Lineage Generation toggle is ON by default, which means Alation generates lineage automatically during metadata extraction (MDE). You only need to use the toggle if you want to disable automatic lineage generation or re-enable it later.

To disable or enable automatic lineage generation:

  1. Open your data source and go to Settings > General Settings.

  2. Use the Enable Automatic Lineage Generation toggle:

    • Off: lineage is not generated automatically. You can use manual methods or the API to create lineage.

    • On: lineage is generated automatically during MDE.

Configure License Settings

Specify the following license details in Connector Settings > License Settings, and click Save.

  • Company Name — The name of the company that owns the connector license.

  • License Key — The license key provided by Alation.

Configure Authentication

The connector supports Azure AD authentication. Ensure you have completed the prerequisites described in Prerequisites.

Specify the following authentication details in Connector Settings > Datasource Connection, and click Save.

Parameter

Description

Subscription ID

Provide the Azure subscription ID.

Tenant ID

Provide the Azure AD directory identifier.

Client ID

Provide the application (client) ID of the Azure AD app registration.

Client Secret

Provide the secret value generated during the app registration.

Configure Sampling

Provide the following details to configure sampling in Connector Settings > Sampling Configuration, and click Save:

Parameter

Description

Cluster

Provide the cluster name in <cluster_name>.<region> format.

Database Name

Specify the database name to sample.

Configure Logging

To set the logging level for Azure Data Explorer OCF connector logs:

  1. On the Settings page of your Azure Data Explorer data source, go to General Settings > Logging Configuration.

  2. Select a logging level and click Save.

The available log levels are based on the Log4j framework.

To view connector logs, go to Admin Settings > Server Admin > Manage Connectors and select Azure Data Explorer OCF Connector.

Obfuscate Literals

Not applicable.

Note

Query Log Ingestion (QLI) is not applicable for this connector.

Test the Connection

After specifying the authentication details, test connectivity:

  1. On the Settings page of your Azure Data Explorer data source, go to General Settings > Test Connection.

  2. Click Test.

A dialog box confirms the status of the connection test.