Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.
IDENTIFIER
Mengubah nilai string, biasanya variabel sesi, menjadi nama kolom. Gunakan fungsi ini jika $variable polos di posisi tersebut akan dibaca sebagai nilai skalar. Tersedia mulai StackQL v1.0.
Lihat juga:
[SET] [ Variabel sesi ]
Sintaksis
SELECT IDENTIFIER($variable) FROM <multipartIdentifier> ORDER BY IDENTIFIER($variable);
Argumen
variable
Variabel sesi, atau literal string, yang berisi nama kolom. Nama yang dikualifikasi seperti t.name diterima. Fungsi ini menerima tepat satu argumen, dan argumen tersebut harus berupa satu nilai string; penggabungan seperti 't.' || $column_name, argumen kedua, atau nilai numerik ditolak dengan IDENTIFIER requires one string value. Nilai kosong, atau nilai yang berisi pernyataan, ditolak dengan invalid identifier value, dan variabel yang tidak terdefinisi gagal sebagai tidak terdefinisi. Semua pemeriksaan ini dilakukan sebelum permintaan apa pun dikirim ke provider.
Nilai yang dikembalikan
Dalam pernyataan yang telah diurai, fungsi ini diganti dengan referensi ke kolom yang dinamai, sehingga fungsi ini mengembalikan nilai kolom tersebut. Nama dikonversi menjadi pengidentifikasi dan tidak pernah disisipkan ke dalam teks SQL. Referensi kolom yang dihasilkan dapat digunakan di mana pun kolom dapat digunakan: daftar select, klausa WHERE, GROUP BY, dan ORDER BY, argumen fungsi, serta di dalam CTE dan subkueri.
Contoh
Memproyeksikan dan mengurutkan menurut kolom yang namanya ada dalam variabel
Kolom yang dikembalikan dan kolom yang menjadi dasar pengurutan sama-sama diambil dari column_name, dan kolom output diberi nama baru dari output_name. IDENTIFIER diperlukan di daftar select dan di ORDER BY karena $column_name polos di posisi tersebut akan menjadi string 'name', bukan kolom tersebut. Alias menggunakan bentuk dengan tanda kutip ganda sebagai gantinya. Setelah variabel diganti dengan nilainya, pernyataan tersebut sama dengan SELECT name AS bucket FROM aws.s3.buckets WHERE region = 'ap-southeast-2' ORDER BY name.
SET column_name = 'name';
SET output_name = 'bucket';
SELECT IDENTIFIER($column_name) AS "$output_name"
FROM aws.s3.buckets
WHERE region = 'ap-southeast-2'
ORDER BY IDENTIFIER($column_name);
Memfilter menurut kolom yang namanya ada dalam variabel
Referensi yang dihasilkan berfungsi dalam predikat maupun proyeksi. Di sini, field yang difilter dan nilai yang dicocokkan sama-sama berasal dari variabel: IDENTIFIER($filter_column) menjadi kolom status, sedangkan $filter_value diteruskan sebagai literal string 'RUNNING'. Kedua bentuk ini sengaja dibuat berbeda, karena bentuk pertama menamai kolom dan bentuk kedua memberikan nilai.
SET filter_column = 'status';
SET filter_value = 'RUNNING';
SELECT name, zone
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a'
AND IDENTIFIER($filter_column) = $filter_value;
Mengualifikasi kolom dengan alias tabel
Nilai yang mengandung titik menghasilkan referensi kolom yang dikualifikasi. Tabel diberi alias w, dengan alias itu sendiri diambil dari variabel, dan IDENTIFIER($column_name) menjadi w.name. Bentuk ini yang perlu digunakan jika nama kolom yang sama ada di kedua sisi join dan referensi tersebut akan ambigu jika tidak dikualifikasi.
SET table_alias = 'w';
SET column_name = 'w.name';
SELECT IDENTIFIER($column_name) AS bucket
FROM aws.s3.buckets AS "$table_alias"
WHERE w.region = 'ap-southeast-2';
Nilai yang ditolak
Karena nilai tersebut menjadi nama, bukan teks kueri, apa pun yang bukan nama yang dapat digunakan akan ditolak sebelum pernyataan direncanakan, dan tidak ada permintaan yang sampai ke provider. Dua pernyataan pertama di bawah gagal dengan invalid identifier value dan pernyataan ketiga dengan IDENTIFIER requires one string value.
/*
SET column_name = '';
SELECT IDENTIFIER($column_name) FROM aws.s3.buckets;
-- FAILS with invalid identifier value
SET column_name = 'name; DROP TABLE imaginary';
SELECT IDENTIFIER($column_name) FROM aws.s3.buckets;
-- FAILS with invalid identifier value
SET column_name = 17;
SELECT IDENTIFIER($column_name) FROM aws.s3.buckets;
-- FAILS with IDENTIFIER requires one string value
*/
$variabledi klausaFROMmenjadi relasi tanpaIDENTIFIER, dan"$variable"dengan tanda kutip ganda digunakan untuk alias, nama kolom DDL, daftar kolomINSERT, dan targetUPDATE.