跳至主要內容
翻譯頁面

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

如何讓 StackQL 向 AWS 進行驗證

StackQL 使用標準的 AWS 憑證環境變數向 AWS 驗證。請在啟動 StackQL shell、exec 命令、伺服器或 MCP 伺服器之前設定這些變數;不需要任何設定檔。

步驟​

  1. 建立或找出具有您的查詢所需權限的 IAM 主體(使用者或角色)。若只需唯讀查詢,使用 ReadOnlyAccess 受管政策或範圍更小的同等政策即可。

  2. 將憑證匯出為環境變數:

export AWS_ACCESS_KEY_ID=YOURACCESSKEYID
export AWS_SECRET_ACCESS_KEY=YOURSECRETACCESSKEY

若使用臨時憑證(透過 sts assume-role 擔任的角色,或會自動設定這些變數的 AWS CloudShell 工作階段),也需匯出工作階段權杖:

export AWS_SESSION_TOKEN=YOURSESSIONTOKEN
  1. 提取 AWS Provider(僅首次使用時需要):
REGISTRY PULL aws;
  1. 以查詢確認:
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)需要已驗證的工作階段。