翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何讓 StackQL 向 Azure 進行驗證
StackQL 使用 Microsoft Entra ID(前身為 Azure AD)服務主體向 Azure 進行驗證,並透過三個環境變數提供:AZURE_TENANT_ID、AZURE_CLIENT_ID 與 AZURE_CLIENT_SECRET。
步驟
- 建立服務主體,並授予它目標訂用帳戶上的角色(唯讀查詢只需
Reader角色即可):
az ad sp create-for-rbac --name stackql-sp --role Reader \
--scopes /subscriptions/<subscription-id>
- 匯出它傳回的憑證:
export AZURE_TENANT_ID=your-tenant-id
export AZURE_CLIENT_ID=your-client-id
export AZURE_CLIENT_SECRET=your-client-secret
- 提取 Azure Provider(僅首次使用時):
REGISTRY PULL azure;
- 以查詢確認:
SELECT name, location
FROM azure.compute.virtual_machines
WHERE subscriptionId = '00000000-1111-2222-3333-444444444444';
subscriptionId 述詞是 Azure API 的必要路由參數,不屬於驗證的一部分。以資源群組為範圍的方法另外需要 resourceGroupName;執行 SHOW METHODS IN azure.compute.virtual_machines 可查看每個存取方法的必要參數(list_all 只需要 subscriptionId;list 還需要 resourceGroupName;get 需要 vmName)。
變數的適用範圍
這些變數在 stackql shell、stackql exec、stackql srv(PostgreSQL 線路協定伺服器)與 stackql mcp 中的作用完全相同。對於 Claude Desktop 等 MCP 用戶端,請將它們放在 claude_desktop_config.json 中伺服器項目的 env 區塊。在 CI 中,請從管線的祕密存放區取得它們。
相關概念
- 如何讓 StackQL 向 AWS 進行驗證:AWS 的對應做法
- 如何讓 StackQL 向 Google Cloud 進行驗證:GCP 的對應做法
- 如何搭配 Claude 使用 StackQL:將 Azure 憑證傳遞給 MCP 工作階段
- 控制平面與資料平面:Resource Manager API 涵蓋的範圍
- 常見 StackQL 錯誤:包括驗證失敗