Lewati ke konten utama
Halaman terjemahan

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​

ArgumenDeskripsiContoh
queryKueri StackQL yang akan diproses
atau perintah yang akan dijalankan
"SELECT * FROM google.compute.instances
WHERE project = 'myproject' AND zone = 'us-east1-a'"
Perhatikan bahwa kueri harus diapit tanda kutip tunggal atau ganda

Flag​

FlagDeskripsi
-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
--dryrunFlag uji coba; hanya praprosesor yang akan berjalan dan output akan dikembalikan
--varVariabel 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.