跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何讓 StackQL 向 Azure 進行驗證

StackQL 使用 Microsoft Entra ID(前身為 Azure AD)服務主體向 Azure 進行驗證,並透過三個環境變數提供:AZURE_TENANT_ID、AZURE_CLIENT_ID 與 AZURE_CLIENT_SECRET。

步驟​

  1. 建立服務主體,並授予它目標訂用帳戶上的角色(唯讀查詢只需 Reader 角色即可):
az ad sp create-for-rbac --name stackql-sp --role Reader \
--scopes /subscriptions/<subscription-id>
  1. 匯出它傳回的憑證:
export AZURE_TENANT_ID=your-tenant-id
export AZURE_CLIENT_ID=your-client-id
export AZURE_CLIENT_SECRET=your-client-secret
  1. 提取 Azure Provider(僅首次使用時):
REGISTRY PULL azure;
  1. 以查詢確認:
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 中,請從管線的祕密存放區取得它們。