翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何讓 StackQL 向 Google Cloud 進行驗證
StackQL 使用服務帳戶金鑰向 Google Cloud 進行驗證,金鑰以 JSON 內容的形式透過 GOOGLE_CREDENTIALS 環境變數提供。
步驟
- 建立服務帳戶並授予它目標專案上的角色(唯讀查詢只需
roles/viewer即可),然後建立並下載 JSON 金鑰:
gcloud iam service-accounts keys create stackql-key.json \
--iam-account=stackql-sa@my-project.iam.gserviceaccount.com
- 匯出金鑰內容:
export GOOGLE_CREDENTIALS=$(cat ./stackql-key.json)
另一種做法是使用 --auth 旗標以路徑傳遞金鑰,這對伺服器與 MCP 部署很有用:
stackql shell \
--auth='{"google": {"type": "service_account", "credentialsfilepath": "/path/to/stackql-key.json"}}'
- 提取 Google Provider(僅首次使用時):
REGISTRY PULL google;
- 以查詢確認:
SELECT name, status, machineType
FROM google.compute.instances
WHERE project = 'my-project';
這會使用 aggregated_list 存取方法,它只需要 project,並傳回所有可用區域中的執行個體。可用區域層級的 list 方法需要 project 和 zone;SHOW METHODS IN google.compute.instances 會顯示每個方法的必要參數。
憑證的適用範圍
相同的變數(或 --auth 物件)適用於 stackql shell、stackql exec、stackql srv 與 stackql mcp。對於 Claude Desktop 和類似的 MCP 用戶端,請在伺服器設定的 env 區塊中設定 GOOGLE_CREDENTIALS。在 CI 中,請從平台的祕密存放區取得金鑰,切勿提交金鑰。
相關概念
- 如何讓 StackQL 向 AWS 進行驗證:AWS 的對應做法
- 如何讓 StackQL 向 Azure 進行驗證:Azure 的對應做法
- 如何搭配 AI 代理程式使用 StackQL:MCP 部署中的憑證
- 什麼是 SQL for APIs?:為什麼必要參數會出現在 WHERE 子句中
- 常見 StackQL 錯誤:包括驗證失敗