Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

Menggunakan StackQL

Lihat juga:
[exec] [shell]

StackQL memiliki beberapa mode penggunaan, yaitu: shell interaktif StackQL, baris perintah StackQL dengan pernyataan StackQL, atau menjalankan satu atau beberapa pernyataan StackQL dalam file input (file IQL). Setiap mode dijelaskan lebih rinci di bawah ini:

Menggunakan shell interaktif StackQL​

Shell StackQL menyediakan lingkungan pemrograman interaktif bagi engineer untuk men-deploy dan berinteraksi dengan sumber daya cloud, serta memungkinkan analisis interaktif (menggunakan pernyataan SELECT) atas lingkungan cloud mereka. Secara fungsional, shell ini mirip dengan shell MySQL atau shell REPL (Read Evaluate Print Loop) lainnya. Shell menerima pernyataan StackQL yang valid dan mengembalikan hasil kepada pengguna. Pernyataan dapat mencakup beberapa baris dan dijalankan setelah titik koma penutup dimasukkan.

Shell StackQL dapat dipanggil menggunakan perintah shell seperti yang ditunjukkan di bawah ini (lihat StackQL Provider Registry untuk informasi tentang autentikasi provider):

# Launching the StackQL Interactive Shell
stackql shell --auth="${AUTH}"

Setelah berada di shell yang terautentikasi ke penyedia cloud, Anda dapat mulai menjalankan kueri StackQL (kueri SELECT atau operasi DDL, yaitu infrastruktur sebagai kode).

Secara default, shell StackQL mengembalikan hasil dalam bentuk tabel, tetapi format output json, jsonl, csv, dan text tersedia melalui flag --output, lihat Mode output.

Anda dapat mengubah skema warna shell StackQL menggunakan flag --colorscheme, seperti yang ditunjukkan di bawah ini:

# Changing the Shell Color Scheme
./stackql shell --colorscheme light

File inisialisasi .stackqlrc​

Nilai default untuk opsi perintah StackQL, seperti format output dan skema warna yang dibahas sebelumnya, dapat diatur menggunakan file inisialisasi .stackqlrc. Jika file ini ada di direktori saat ini yang digunakan oleh file executable StackQL, file tersebut akan dimuat secara otomatis, atau sebagai alternatif dapat dirujuk menggunakan flag --configfile seperti yang ditunjukkan di bawah ini:

# Specifying an Initialization (.stackqlrc) File
./stackql shell --configfile /tmp/.stackqlrc

Informasi selengkapnya tentang opsi perintah tersedia di Flag global.

Menggunakan utilitas baris perintah StackQL​

Perintah StackQL dapat dijalankan secara noninteraktif menggunakan perintah exec dari file executable StackQL. Lebih dari satu perintah dapat dijalankan dalam satu batch asalkan setiap perintah diakhiri dengan titik koma (;). Flag perintah, seperti flag --output, dapat ditentukan di baris perintah atau menggunakan file inisialisasi .stackqlrc yang dibahas sebelumnya.

Output dari file executable StackQL dikirim ke stdout pada sistem yang digunakan, dan output ini dapat diurai dalam skrip BASH atau PowerShell.

Berikut contoh skrip Windows PowerShell yang berisi perintah StackQL:

$gcp_project = "stackql-demo"
$gcp_zone = "australia-southeast1-a"
$env:GOOGLE_CREDENTIALS = Get-Content -Raw "C:\tmp\stackql-demo.json"

Write-Output "Selecting instances in ${gcp_zone}..."

$query = "`"select id, name, machineType `
from google.compute.instances `
where project = '${gcp_project}' `
and zone = '${gcp_zone}';`""
$flags = "--output json"
$cmd = "stackql.exe exec"

$select = $cmd, $query, $flags -join " "

(iex $select | ConvertFrom-Json) | Out-GridView -Title 'StackQL Query Results'

Perintah PowerShell di atas menunjukkan cara memilih instance Compute Engine dan menampilkan output menggunakan Out-GridView.

Menggunakan file input (file IQL)​

File input StackQL dapat digunakan untuk menjalankan beberapa perintah yang diakhiri dengan titik koma. Ini adalah opsi lain untuk pemrograman infrastruktur noninteraktif atau batch. File input ditentukan dengan opsi -i atau --infile seperti yang ditunjukkan di bawah ini:

# create an iql file
echo "select id, name from google.compute.instances \
where project = 'stackql-demo' \
and zone = 'australia-southeast1-a'" > listinstances.iql
# execute an iql file
./stackql exec -i listinstances.iql \
--auth '{ "google": { "type": "service_account", "credentialsfilepath": "/mnt/c/tmp/stackql-demo.json" } }' \
--output json | jq '.[] | .name'