Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
IDENTIFIER
Перетворює рядкове значення, зазвичай змінну сеансу, на ім'я стовпця. Використовуйте її там, де окрему змінну $variable інакше було б прочитано як скалярне значення. Доступно в StackQL v1.0 і новіших версіях.
Див. також:
[SET] [ Змінні сеансу ]
Синтаксис
SELECT IDENTIFIER($variable) FROM <multipartIdentifier> ORDER BY IDENTIFIER($variable);
Аргументи
variable
Змінна сеансу або рядковий літерал, що містить ім'я стовпця. Допускається повне ім'я, наприклад t.name. Функція приймає рівно один аргумент, і це має бути одне рядкове значення; конкатенацію, як-от 't.' || $column_name, другий аргумент або числове значення StackQL відхиляє з помилкою IDENTIFIER requires one string value. Порожнє значення або значення, що містить інструкцію, StackQL відхиляє з помилкою invalid identifier value, а невизначена змінна призводить до помилки про невизначену змінну. Усі ці перевірки виконуються до надсилання будь-якого запиту до провайдера.
Значення, що повертається
Після синтаксичного аналізу інструкції функцію замінено посиланням на вказаний стовпець, тому вона повертає значення цього стовпця. Імена перетворюються на ідентифікатори й ніколи не вставляються в текст SQL. Отримане посилання на стовпець можна використовувати всюди, де можна використовувати стовпець: у списку вибірки, у реченнях WHERE, GROUP BY і ORDER BY, в аргументах функцій, а також усередині CTE і підзапитів.
Приклади
Проєкція та сортування за стовпцем, ім'я якого вказано в змінній
І стовпець, який потрібно повернути, і стовпець для сортування беруться з column_name, а вихідний стовпець отримує нове ім'я з output_name. Функція IDENTIFIER потрібна в списку вибірки та в ORDER BY, бо окрема змінна $column_name у цих позиціях була б рядковим значенням 'name', а не стовпцем. Для псевдоніма натомість використано форму в подвійних лапках. Після визначення змінних інструкція збігається з 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);
Фільтрування за стовпцем, ім'я якого вказано в змінній
Визначене посилання працює і в предикаті, і в проєкції. Тут і поле для фільтрування, і значення для порівняння беруться зі змінних: IDENTIFIER($filter_column) стає стовпцем status, а $filter_value передається як рядковий літерал 'RUNNING'. Ці дві форми навмисно різні, бо перша називає стовпець, а друга надає значення.
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;
Уточнення стовпця псевдонімом таблиці
Значення з крапкою відповідає посиланню на стовпець із повним ім'ям. Таблиця має псевдонім w, сам псевдонім береться зі змінної, а IDENTIFIER($column_name) стає w.name. Цю форму слід використовувати, коли стовпець із тим самим ім'ям є з обох боків з'єднання і посилання інакше було б неоднозначним.
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';
Відхилені значення
Оскільки значення стає ім'ям, а не текстом запиту, усе, що не є придатним ім'ям, StackQL відхиляє ще до планування інструкції, і жоден запит не доходить до провайдера. Перші дві інструкції нижче завершуються помилкою invalid identifier value, а третя - помилкою 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
*/
Змінна
$variableу реченніFROMвідповідає відношенню й безIDENTIFIER, а"$variable"у подвійних лапках використовується для псевдонімів, імен стовпців DDL, списків стовпцівINSERTі цілейUPDATE.