Microsoft Azure Data Explorer¶

Azure Data Explorer 連線型別支援在 Airflow 中整合 Azure Data Explorer (ADX)。

Azure Data Explorer 身份驗證¶

使用 Airflow 連線到 Azure Data Explorer 有五種方式。

使用 AAD 應用程式證書（即在 Airflow 連線中將“AAD_APP”或“AAD_APP_CERT”用作身份驗證方法）。
使用 AAD 使用者名稱和密碼（即在 Airflow 連線中將“AAD_CREDS”用作身份驗證方法）。
使用 AAD 裝置程式碼（即在 Airflow 連線中將“AAD_DEVICE”用作身份驗證方法）。
透過設定 managed_identity_client_id、workload_identity_tenant_id 使用託管標識（底層使用這些引數呼叫 DefaultAzureCredential）
回退到 DefaultAzureCredential。這包含了一種嘗試不同身份驗證選項的機制：託管系統標識、環境變數、透過 Azure CLI 身份驗證等。

一次只能使用一種授權方法。如果您需要管理多個憑據或金鑰，則應配置多個連線。

預設連線 ID¶

所有與 Microsoft Azure Data Explorer 相關的 Hook 和 Operator 預設使用 azure_data_explorer_default。

配置連線¶

Data Explorer 叢集 URL

指定 Data Explorer 叢集 URL。所有身份驗證方法都需要。

身份驗證方法

指定身份驗證方法。可用的身份驗證方法有

AAD_APP: 使用 AAD 應用程式證書進行身份驗證。使用此方法時需要租戶 ID (Tenant ID)。透過 Username 和 Password 引數提供應用程式 ID 和應用程式金鑰。
AAD_APP_CERT: 使用 AAD 應用程式證書進行身份驗證。使用此方法時需要租戶 ID (Tenant ID)、應用程式 PEM 證書和應用程式證書指紋。
AAD_CREDS: 使用 AAD 使用者名稱和密碼進行身份驗證。使用此方法時需要租戶 ID (Tenant ID)。Username 和 Password 引數用於 AAD 身份驗證。
AAD_DEVICE: 使用 AAD 裝置程式碼進行身份驗證。請注意，如果選擇此選項，則需要為每個新初始化的例項進行身份驗證。強烈建議建立一個例項並將其用於所有查詢。
AZURE_TOKEN_CRED: 使用 DefaultAzureCredential 進行身份驗證。這包含了一種嘗試不同身份驗證選項的機制：託管系統標識、環境變數、透過 Azure CLI 身份驗證等。使用此方法時，僅需要“Data Explorer 叢集 URL”。

使用者名稱（可選）

指定用於 data explorer 的使用者名稱。AAD_APP、AAD_APP_CERT 和 AAD_CREDS 身份驗證方法需要。

密碼（可選）

指定用於 data explorer 的密碼。AAD_APP 和 AAD_CREDS 身份驗證方法需要。

租戶 ID（可選）

指定 AAD 租戶。AAD_APP、AAD_APP_CERT 和 AAD_CREDS 需要。

應用程式 PEM 證書（可選）

指定證書。AAD_APP_CERT 身份驗證方法需要。

應用程式證書指紋（可選）

指定與 AAD_APP_CERT 身份驗證方法一起使用所需的指紋。

託管標識客戶端 ID（可選）

使用者分配的託管標識的客戶端 ID。如果與 workload_identity_tenant_id 一起提供，它們將傳遞給 DefaultAzureCredential。

工作負載標識租戶 ID（可選）

應用程式的 Microsoft Entra 租戶 ID。也稱為其“目錄”ID。如果與 managed_identity_client_id 一起提供，它們將傳遞給 DefaultAzureCredential。

在環境變數中指定連線時，應使用 URI 語法指定。

請注意，URI 的所有元件都應進行 URL 編碼。

例如

export AIRFLOW_CONN_AZURE_DATA_EXPLORER_DEFAULT='azure-data-explorer://add%20username:add%20password@mycluster.com?auth_method=AAD_APP&tenant=tenant+id'