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ụ |
|---|---|---|
query | Truy vấn StackQL cần thực hiện hoặc lệnh cần thực thi | "SELECT * FROM google.compute.instancesWHERE 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 |
--dryrun | Cờ chạy thử; chỉ bộ tiền xử lý chạy và đầu ra sẽ được trả về |
--var | Biế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.