Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
exec
Perintah yang digunakan untuk menjalankan kueri StackQL, baik sebagai satu pernyataan maupun sebagai batch pernyataan dari skrip StackQL (file IQL).
Sintaksis
stackql exec [query] [flags]
Argumen
| Argumen | Deskripsi | Contoh |
|---|---|---|
query | Kueri StackQL yang akan diproses atau perintah yang akan dijalankan | "SELECT * FROM google.compute.instancesWHERE project = 'myproject' AND zone = 'us-east1-a'"Perhatikan bahwa kueri harus diapit tanda kutip tunggal atau ganda |
Flag
| Flag | Deskripsi |
|---|---|
-o--output | Mode output, nilai yang valid meliputi: table (default), json, jsonl (JSON yang dipisahkan baris baru, ndjson diterima sebagai alias), csv, text, dan otel (catatan log OpenTelemetry, lihat Mode output), contoh: --output jsonl |
-i--infile | Menjalankan kueri dari file yang ditentukan jika diperlukan; jika flag ini ditentukan, kueri apa pun yang diberikan sebagai argumen akan diabaikan, contoh: --infile myquery.iql |
-q--iqldata | Data sumber untuk perintah menggunakan file json atau jsonnet, contoh: --iqldata vars.jsonnet |
--dryrun | Flag uji coba; hanya praprosesor yang akan berjalan dan output akan dikembalikan |
--var | Variabel eksternal (dapat berupa variabel lingkungan atau rahasia) yang digunakan oleh file jsonnet yang ditentukan dengan flag --iqldata, contoh --var region=${AWS_REGION} |
-f--outfile | File tujuan penulisan hasil jika diperlukan (perilaku default adalah menampilkan hasil hanya di konsol), contoh --outfile myoutput.csv |
-h--help | Menampilkan informasi bantuan |
-v--verbose | Menjalankan kueri dalam mode verbose dengan output tambahan yang dikirim ke stdout; jika opsi -f dipilih, informasi log tambahan ini akan ditulis ke file output bersama hasil kueri |
lihat Flag global untuk opsi tambahan
Contoh
Menampilkan hasil kueri di konsol dalam format tabel:
stackql exec "SHOW services IN google"
Menampilkan hasil kueri di konsol dalam format json:
stackql exec "SHOW services IN google" -o json
Menulis hasil kueri ke file dalam format json:
stackql exec "SHOW services IN google" -o json -f services.json
Menjalankan kueri dari file input (file IQL) dan menulis hasilnya ke file dalam format json:
stackql exec -i getservices.iql -o json -f services.json
Status keluar
Perintah exec keluar dengan status 0 setelah input selesai diproses; error dari setiap pernyataan ditulis ke konsol, sehingga skrip harus memeriksa output. Mulai v1.0, perintah ini keluar dengan status 1 ketika pernyataan konfigurasi SET atau UNSET gagal, ketika manajemen akses diaktifkan dan sebuah pernyataan ditolak, atau ketika eksekusi IaC pratinjau melaporkan sumber daya yang gagal.