跳至主要內容
翻譯頁面

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

exec

用於執行 StackQL 查詢的命令,可以是單一陳述式,也可以是來自 StackQL 指令碼(IQL 檔案)的一批陳述式。


語法​

stackql exec [query] [flags]


引數​

引數描述範例
query要執行的 StackQL 查詢
或命令
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-a'"
請注意,查詢必須以單引號或雙引號括住

旗標​

旗標描述
-o
--output
輸出模式,有效值包括:table(預設)、json、jsonl(以換行字元分隔的 JSON,也接受 ndjson 作為別名)、csv、text 和 otel(OpenTelemetry 記錄項目,請參閱輸出模式),範例:--output jsonl
-i
--infile
視需要從指定的檔案執行查詢;若指定此旗標,以引數提供的任何查詢都會被忽略,範例:--infile myquery.iql
-q
--iqldata
使用 json 或 jsonnet 檔案作為命令的來源資料,範例:--iqldata vars.jsonnet
--dryrun試執行旗標;只會執行前置處理器並傳回輸出
--var由 --iqldata 旗標所指定 jsonnet 檔案取用的外部變數(可以是環境變數或祕密),範例:--var region=${AWS_REGION}
-f
--outfile
視需要寫入結果的檔案(預設行為是僅將結果輸出至主控台),範例:--outfile myoutput.csv
-h
--help
顯示說明資訊
-v
--verbose
以詳細模式執行查詢,並將額外輸出傳送至 stdout;若選取 -f 選項,這些額外的記錄資訊會連同查詢結果一起寫入輸出檔案


如需其他選項,請參閱全域旗標


範例​

以表格格式將查詢結果輸出至主控台:

stackql exec "SHOW services IN google"

以 json 格式將查詢結果輸出至主控台:

stackql exec "SHOW services IN google" -o json

以 json 格式將查詢結果輸出至檔案:

stackql exec "SHOW services IN google" -o json -f services.json

從輸入檔案(IQL 檔案)執行查詢,並以 json 格式將結果輸出至檔案:

stackql exec -i getservices.iql -o json -f services.json

結束狀態​

exec 在處理完輸入後會以狀態 0 結束;個別陳述式的錯誤會寫入主控台,因此指令碼應檢查輸出。自 v1.0 起,當 SET 或 UNSET 設定陳述式失敗、預覽 IaC 執行回報資源失敗,或在已啟用存取管理的情況下有任何陳述式失敗或遭拒時,此命令會以狀態 1 結束。