Chuyển tới nội dung chính
Trang được dịch

Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.

exec

Lệnh dùng để chạy một truy vấn StackQL, dưới dạng một câu lệnh hoặc một lô câu lệnh từ tập lệnh StackQL (tệp IQL).


Cú pháp​

stackql exec [query] [flags]


Đối số​

Đối sốMô tảVí dụ
queryTruy vấn StackQL cần thực hiện
hoặc lệnh cần thực thi
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-a'"
Lưu ý rằng truy vấn phải được đặt trong dấu nháy đơn hoặc nháy kép

Cờ​

CờMô tả
-o
--output
Chế độ đầu ra, các giá trị hợp lệ gồm: table (mặc định), json, jsonl (JSON phân tách bằng ký tự dòng mới, ndjson được chấp nhận làm bí danh), csv, text và otel (bản ghi nhật ký OpenTelemetry, xem Chế độ đầu ra), ví dụ: --output jsonl
-i
--infile
Chạy truy vấn từ tệp được chỉ định nếu cần; nếu cờ này được chỉ định, mọi truy vấn được cung cấp dưới dạng đối số sẽ bị bỏ qua, ví dụ: --infile myquery.iql
-q
--iqldata
Dữ liệu nguồn cho lệnh, sử dụng tệp json hoặc jsonnet, ví dụ: --iqldata vars.jsonnet
--dryrunCờ chạy thử; chỉ bộ tiền xử lý chạy và đầu ra sẽ được trả về
--varBiến bên ngoài (có thể là biến môi trường hoặc bí mật) được các tệp jsonnet chỉ định bằng cờ --iqldata sử dụng, ví dụ --var region=${AWS_REGION}
-f
--outfile
Tệp để ghi kết quả vào nếu cần (hành vi mặc định là chỉ xuất kết quả ra bảng điều khiển), ví dụ --outfile myoutput.csv
-h
--help
In thông tin trợ giúp
-v
--verbose
Chạy truy vấn ở chế độ chi tiết với đầu ra bổ sung được gửi tới stdout; nếu chọn tùy chọn -f, thông tin nhật ký bổ sung này sẽ được ghi vào tệp đầu ra cùng với kết quả truy vấn


xem Cờ toàn cục để biết các tùy chọn bổ sung


Ví dụ​

Xuất kết quả truy vấn ra bảng điều khiển ở định dạng bảng:

stackql exec "SHOW services IN google"

Xuất kết quả truy vấn ra bảng điều khiển ở định dạng json:

stackql exec "SHOW services IN google" -o json

Xuất kết quả truy vấn ra tệp ở định dạng json:

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

Thực thi truy vấn từ tệp đầu vào (tệp IQL) và xuất kết quả ra tệp ở định dạng json:

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

Trạng thái thoát​

Lệnh exec thoát với trạng thái 0 sau khi đã xử lý xong đầu vào; lỗi từ từng câu lệnh riêng lẻ được ghi ra bảng điều khiển, vì vậy các tập lệnh nên kiểm tra đầu ra. Từ v1.0, lệnh thoát với trạng thái 1 khi một câu lệnh cấu hình SET hoặc UNSET thất bại, khi quản lý truy cập được bật và một câu lệnh bị từ chối hoặc khi một lần chạy IaC bản xem trước báo cáo một tài nguyên thất bại.