# exec

> Perintah stackql exec menjalankan satu pernyataan StackQL atau skrip berisi beberapa pernyataan, dengan flag untuk format output, autentikasi, dan registri provider.

Source: https://stackql.io/id/command-line-usage/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.instances` `WHERE 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](/getting-started/output-modes#otel-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](/command-line-usage/global-flags) untuk opsi tambahan

* * *

### Contoh

Menampilkan hasil kueri di konsol dalam format tabel:
```shell
stackql exec "SHOW services IN google"
```

Menampilkan hasil kueri di konsol dalam format json:
```shell
stackql exec "SHOW services IN google" -o json
```

Menulis hasil kueri ke file dalam format json:
```shell
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:
```shell
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`](/language-spec/set) atau [`UNSET`](/language-spec/unset) gagal, ketika [manajemen akses](/command-line-usage/access-management) diaktifkan dan sebuah pernyataan ditolak, atau ketika eksekusi IaC pratinjau melaporkan sumber daya yang gagal.
