Перейти до основного вмісту
Перекладена сторінка

Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.

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.