Microsoft Azure Cosmos¶

Microsoft Azure Cosmos 連線類型啟用 Azure Cosmos 整合。

驗證 Azure¶

有三種方式可以使用 Airflow 連線到 Azure Cosmos。

使用主金鑰，即將特定認證（client_id、secret、tenant）和帳戶名稱新增至 Airflow 連線。
使用受控識別，透過設定 managed_identity_client_id、workload_identity_tenant_id（底層使用 DefaultAzureCredential 以及這些引數）
回退到 DefaultAzureCredential。這包含嘗試不同選項進行驗證的機制：受控系統識別、環境變數、透過 Azure CLI 驗證等等。

預設連線 ID¶

所有與 Microsoft Azure Cosmos 相關的 Hook 和運算子預設使用 azure_cosmos_default。

設定連線¶

登入

指定用於初始連線的 Cosmos 端點 URI。

密碼 (選填)

指定用於初始連線的 Cosmos Master Key Token。可以省略以回退到 DefaultAzureCredential。

額外 (選填)

指定可用於 Azure Cosmos 連線的額外參數（以 JSON 字典形式）。以下參數皆為選填

database_name：指定要使用的 Azure Cosmos 資料庫。
collection_name：指定要使用的 Azure Cosmos 集合。
partition_key：指定集合的分割區金鑰。
subscription_id：指定用於初始連線的訂用帳戶 ID。回退到 DefaultAzureCredential 時為必要項
resource_group_name：指定所需 Azure Cosmos 所在的 Azure 資源群組名稱。回退到 DefaultAzureCredential 時為必要項
managed_identity_client_id：使用者指派受控識別的用戶端 ID。如果與 workload_identity_tenant_id 一起提供，它們將傳遞至 DefaultAzureCredential。
workload_identity_tenant_id：應用程式 Microsoft Entra 租用戶的 ID。也稱為其「目錄」ID。如果與 managed_identity_client_id 一起提供，它們將傳遞至 DefaultAzureCredential。

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

請注意，URI 的所有組成部分都應進行 URL 編碼。

例如

export AIRFLOW_CONN_AZURE_COSMOS_DEFAULT='azure-cosmos://https%3A%2F%2Fairflow.azure.com:master%20key@?database_name=mydatabase&collection_name=mycollection'