Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
Struktur leksikal
Lihat juga:
[ Hierarki sumber daya StackQL ] [ Kata kunci ] [ Tipe data ] [ DESCRIBE ]
Struktur leksikal dan tata bahasa StackQL dimodelkan berdasarkan implementasi bahasa MySQL (adaptasi dari standar ANSI SQL-92) dengan beberapa ekstensi. Pernyataan StackQL digunakan untuk mengkueri sumber daya cloud (menggunakan tata bahasa SELECT) atau untuk membuat, mengubah, atau menghapus infrastruktur menggunakan pernyataan bahasa manipulasi data (DML) standar seperti INSERT, UPDATE, REPLACE, dan DELETE. Selain itu, operasi non-DML, misalnya memulai instance, atau mengambil objek dari bucket di AWS S3 atau menaruh objek ke dalamnya, diimplementasikan sebagai prosedur bawaan provider (mirip dengan prosedur tersimpan di DBMS). Prosedur bawaan provider dipanggil menggunakan pernyataan EXEC.
Bahasa SQL khusus domain dari StackQL memungkinkan pemrograman infrastruktur secara deklaratif maupun prosedural.
Sintaksis
Operasi StackQL terdiri atas satu atau beberapa pernyataan yang diakhiri titik koma (;). Pernyataan mencakup kata kunci, pengidentifikasi, parameter, dan nilai; contoh pernyataan StackQL untuk membuat disk 10GB di GCP adalah sebagai berikut:
INSERT INTO google.compute.disks (project, zone, name, sizeGb)
SELECT 'myProject', 'australia-southeast1-a', 'my10GbDisk', 10;
Pada contoh di atas, INSERT, INTO, dan SELECT adalah kata kunci, google.compute.disks adalah pengidentifikasi, project, zone, name, sizeGb adalah parameter, dan 'myProject', 'australia-southeast1-a', 'my10GbDisk', 10 adalah nilai.
Kata kunci
Kata kunci tidak peka huruf besar-kecil, artinya INSERT dan insert diperlakukan sama, tetapi kata kunci sering ditulis dengan huruf kapital sesuai konvensi. Daftar lengkap kata kunci dapat ditemukan di bagian Kata kunci.
Pengidentifikasi
Pengidentifikasi adalah simbol yang merepresentasikan objek dalam hierarki sumber daya penyedia cloud. Pengidentifikasi terdiri atas beberapa bagian; informasi selengkapnya tentang pengidentifikasi dapat ditemukan di topik Hierarki sumber daya StackQL.
Parameter dan nilai
Parameter ditentukan oleh sumber daya; parameter ini dapat ditemukan dengan menggunakan pernyataan DESCRIBE untuk sumber daya penyedia cloud tertentu. Nilai adalah objek skalar atau kompleks bertipe yang dipetakan ke parameter. Untuk informasi selengkapnya tentang parameter dan nilai, lihat topik DESCRIBE dan Tipe data.
Variabel
Pengidentifikasi berawalan tanda dolar seperti $region mendereferensi variabel sesi yang ditetapkan dengan SET; pengidentifikasi tersebut diganti dengan nilai bertipe dari variabel itu sebelum pernyataan direncanakan. '$region' yang diapit tanda kutip tunggal adalah literal string. Dalam klausa FROM, $variable dievaluasi menjadi nama relasi, dan IDENTIFIER($variable) dievaluasi menjadi nama kolom di posisi ekspresi. Jalur berawalan tanda dolar yang diapit tanda kutip ganda, seperti "$.auth.aws.password", adalah target konfigurasi runtime yang diterima oleh SET dan UNSET. Variabel sesi tersedia mulai StackQL v1.0; lihat Variabel sesi.
Operator
|| adalah operator penggabungan string dan memiliki prioritas lebih tinggi daripada operator perbandingan. OR adalah disjungsi boolean. Rilis StackQL sebelum v1.0 mengenali || sebagai token OR.
Komentar
StackQL mendukung komentar multibaris dan komentar sebaris di dalam pernyataan StackQL; contoh komentar ditunjukkan di bawah ini:
/* This
Is a
Multiline
Comment
*/
--This is an inline comment