翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何讓 StackQL 向 AWS 進行驗證
StackQL 使用標準的 AWS 憑證環境變數向 AWS 驗證。請在啟動 StackQL shell、exec 命令、伺服器或 MCP 伺服器之前設定這些變數;不需要任何設定檔。
步驟
-
建立或找出具有您的查詢所需權限的 IAM 主體(使用者或角色)。若只需唯讀查詢,使用
ReadOnlyAccess受管政策或範圍更小的同等政策即可。 -
將憑證匯出為環境變數:
export AWS_ACCESS_KEY_ID=YOURACCESSKEYID
export AWS_SECRET_ACCESS_KEY=YOURSECRETACCESSKEY
若使用臨時憑證(透過 sts assume-role 擔任的角色,或會自動設定這些變數的 AWS CloudShell 工作階段),也需匯出工作階段權杖:
export AWS_SESSION_TOKEN=YOURSESSIONTOKEN
- 提取 AWS Provider(僅首次使用時需要):
REGISTRY PULL aws;
- 以查詢確認:
SELECT instance_id, instance_type
FROM aws.ec2.instances
WHERE region = 'us-east-1';
傳回成功的結果集即確認驗證成功。請注意,AWS 查詢需要在 WHERE 子句中加入 region 述詞,這是路由參數,而不是憑證設定。
變數的適用範圍
相同的環境變數適用於所有 StackQL 執行模式:
- 互動式 shell:
stackql shell - 批次:
stackql exec "..." - 伺服器模式:
stackql srv(PostgreSQL 線路協定) - MCP 伺服器:
stackql mcp,或透過 MCP 用戶端設定(例如claude_desktop_config.json)中的env區塊
在 CI 系統中,請從平台的祕密存放區取得這些變數,而不要將其寫死在程式碼中。中繼資料作業(SHOW、DESCRIBE、REGISTRY)不需要憑證即可運作;只有資料作業(SELECT、INSERT、UPDATE、DELETE、EXEC)需要已驗證的工作階段。
相關概念
- 如何使用 StackQL 查詢 AWS EC2 執行個體:驗證後的第一批查詢
- 如何使用 StackQL 查詢 S3 儲存貯體:S3 查詢模式
- 如何讓 StackQL 向 Azure 進行驗證:Azure 的對應做法
- 如何讓 StackQL 向 Google Cloud 進行驗證:GCP 的對應做法
- 常見 StackQL 錯誤:包括驗證失敗