Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
SET
Menetapkan variabel sesi, atau mengonfigurasi pengaturan runtime untuk sesi saat ini. Tersedia mulai StackQL v1.0.
Lihat juga:
[UNSET] [ Variabel sesi ] [ Sesi provider ] [IDENTIFIER]
Sintaksis
setStatement::=
setExpression::=
SET [ SESSION ] <target> = { <literal> | DEFAULT | <reference> } [, <target> = { <literal> | DEFAULT | <reference> } ...];
target
Pengidentifikasi biasa (region), nama yang diapit tanda kutip ganda ("providers.saved"), atau jalur konfigurasi berawalan tanda dolar yang diapit tanda kutip ganda ("$.auth.aws.password").
literal
String, angka, boolean, atau null. String diapit tanda kutip tunggal. Array dan objek bukan nilai skalar; simpan dokumen JSON sebagai string.
DEFAULT
Mengatur ulang target, setara dengan UNSET. null yang eksplisit adalah nilai yang disimpan, bukan pengaturan ulang.
reference
Referensi "$name" yang diapit tanda kutip ganda ke variabel yang sudah ada, misalnya SET "$.providers.production" = "$providers.saved";.
SESSION
Opsional, dan merupakan satu-satunya cakupan yang dimiliki StackQL. SET SESSION name = ... dan SET name = ... adalah pernyataan yang sama: setiap penetapan berlaku untuk sesi saat ini dan tidak untuk yang lain. Kata kunci ini ada agar skrip terbaca sama seperti pada database yang membedakan SET SESSION dan SET GLOBAL. SET GLOBAL dapat diurai, tetapi ditolak dengan configuration scope "global" is not supported; use SESSION, karena tidak ada status yang dibagikan antarsesi.
Penetapan dalam satu daftar SET diterapkan secara berurutan dan bukan merupakan transaksi: jika penetapan kedua dalam daftar gagal, penetapan pertama tetap berlaku.
Target
| Target | Efek |
|---|---|
name atau "name" | Menyimpan variabel sesi skalar, yang didereferensi sebagai $name dalam pernyataan berikutnya. Titik saja tidak memilih konfigurasi: "providers.saved" adalah variabel bernama providers.saved. Ejaan lama "variables.name" adalah alias untuk name. |
"$.auth.<provider>.<field>" | Menetapkan satu field dari konteks autentikasi provider untuk sesi ini. Field yang tersedia adalah kunci objek --auth untuk provider tersebut, misalnya credentialsenvvar, password, atau token_url. |
"$.providers.<alias>" | Mengikat alias provider dengan kredensial, label tenancy, nilai default parameter, dan penyetelan miliknya sendiri. Nilainya berupa dokumen JSON dalam string; lihat Sesi provider. |
"$.secrets.<name>" | Menyimpan rahasia di penyimpanan rahasia sesi. Nilainya berupa string literal, biasanya dokumen JSON auth, yang dirujuk dari alias provider sebagai auth_secret. |
"$.secret_store" | Memilih penyimpanan rahasia OS yang persisten, {"backend":"os","namespace":"..."}. Memerlukan flag operator --allow-persistent-secrets. |
Setiap bentuk hanya memengaruhi sesi saat ini. Koneksi independen ke server srv tidak melihat penetapan satu sama lain, dan setiap permintaan MCP merupakan sesi tersendiri, jadi lakukan konfigurasi dan kueri dalam satu batch pernyataan saat menggunakan server MCP.
Contoh
Menetapkan variabel sesi
Setiap pernyataan menyimpan satu nilai skalar dengan nama yang diberikan, dan nilai tersebut mempertahankan tipenya: region adalah string, minimum_count bilangan bulat, dan enabled boolean. null disimpan sebagai nilai, sehingga $optional_value kemudian dievaluasi menjadi NULL SQL, bukan gagal karena tidak terdefinisi. Pernyataan terakhir menetapkan dua variabel dalam satu daftar.
SET region = 'ap-southeast-2';
SET minimum_count = 3;
SET enabled = true;
SET optional_value = null;
SET suffix = 'East', some_id = 42;
Menyatakan cakupan sesi secara eksplisit
Dua pernyataan pertama identik: SESSION menyebut satu-satunya cakupan yang ada, dan kedua penetapan berlaku hingga variabel dihapus atau sesi berakhir. Gunakan kata kunci ini jika skrip perlu terbaca sama seperti pada database yang membedakan pengaturan sesi dari pengaturan global. Pernyataan yang dijadikan komentar ditampilkan sebagai pembanding: pernyataan tersebut tidak menetapkan apa pun dan gagal dengan configuration scope "global" is not supported; use SESSION, karena tidak ada status yang dibagikan antarsesi.
SET region = 'ap-southeast-2';
SET SESSION region = 'ap-southeast-2';
/*
SET GLOBAL region = 'ap-southeast-2';
-- FAILS with configuration scope "global" is not supported; use SESSION
*/
Menggunakan variabel dalam kueri
Gunakan $name, tanpa tanda kutip, untuk mendereferensi variabel di posisi ekspresi mana pun. Nilai mempertahankan tipenya: string di-escape sebagai literal SQL, sedangkan angka, boolean, dan null diteruskan apa adanya. Variabel dalam klausa WHERE dievaluasi sebelum permintaan direncanakan, sehingga variabel tersebut diteruskan ke provider seperti literal.
SET project = 'stackql-demo';
SET zone = 'australia-southeast1-a';
SELECT name, status FROM google.compute.instances
WHERE project = $project AND zone = $zone;
Mengatur ulang variabel
DEFAULT menghapus variabel, persis seperti UNSET, sehingga $region setelahnya gagal dengan variable "$region" is not defined hingga variabel itu ditetapkan lagi; kueri yang dijadikan komentar menunjukkan kegagalan tersebut. Hal ini berbeda dengan menetapkan null, yang membiarkan variabel tetap ada dengan nilai NULL.
SET region = 'ap-southeast-2';
SET region = DEFAULT;
/*
SELECT name FROM aws.s3.buckets WHERE region = $region;
-- FAILS with variable "$region" is not defined
*/
Menyalin nilai dari variabel lain
Sisi kanan dapat berupa referensi yang diapit tanda kutip ganda ke variabel yang sudah ada, yang menyalin nilai yang dimiliki variabel tersebut pada saat itu. Di sini, pengikatan provider pertama-tama disimpan sebagai variabel biasa bernama providers.saved (titik di dalamnya tidak menjadikannya konfigurasi), lalu diaktifkan dengan menyalinnya ke jalur $.providers.production. Menghapus salinan tersimpan setelahnya tidak memengaruhi pengikatan yang aktif.
SET "providers.saved" = '{"provider":"aws","tenancy":"production-account","auth":{"type":"aws_signing_v4","access_key_id_env_var":"PRODUCTION_AWS_ACCESS_KEY_ID","secret_access_key_env_var":"PRODUCTION_AWS_SECRET_ACCESS_KEY"}}';
SET "$.providers.production" = "$providers.saved";
UNSET "providers.saved";
Mengganti field kredensial untuk sesi ini
Konteks autentikasi provider adalah objek yang diberikan untuk provider tersebut melalui --auth saat proses dimulai. Jalur di bawah $.auth mengganti satu field dari objek tersebut selama sisa sesi dan membiarkan field lainnya tetap seperti semula. Di sini, provider GitHub diarahkan ke variabel lingkungan lain yang berisi token hanya baca; variabel tersebut dibaca dari lingkungan proses StackQL, dan kueri berikutnya terhadap github.* menggunakannya hingga field tersebut dihapus atau sesi berakhir.
SET "$.auth.github.credentialsenvvar" = 'GITHUB_TOKEN_READONLY';
Mengikat alias provider
Alias provider adalah instance kedua dari suatu provider yang dikonfigurasi secara independen, yang digunakan sebagai pengganti nama provider dalam kueri. Nilainya berupa dokumen JSON dalam string: provider menyebutkan provider yang mendasarinya, tenancy memberi label pada akun, auth adalah blok kredensial dengan bentuk yang sama seperti --auth, dan params menyediakan nilai default untuk parameter permintaan seperti region. Kueri terhadap production.s3.buckets kemudian dijalankan dengan kredensial tersebut, sedangkan aws.s3.buckets tetap menggunakan konfigurasi awal. Daftar lengkap kunci terdapat di Sesi provider.
SET "$.providers.production" = '{
"provider": "aws",
"tenancy": "production-account",
"auth": {
"type": "aws_signing_v4",
"access_key_id_env_var": "PRODUCTION_AWS_ACCESS_KEY_ID",
"secret_access_key_env_var": "PRODUCTION_AWS_SECRET_ACCESS_KEY"
},
"params": {"region": "ap-southeast-2"}
}';
SELECT name FROM production.s3.buckets;