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

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

UNSET

Видаляє змінну сеансу або скидає конфігурацію середовища виконання, встановлену для поточного сеансу за допомогою SET. Доступно в StackQL v1.0 і новіших версіях.

Див. також: [SET] [ Змінні сеансу ] [ Сеанси провайдерів ]


Синтаксис​

unsetStatement::=

UNSETSESSIONvariableNameconfigurationPath','variableNameconfigurationPath';'

 
 

UNSET [ SESSION ] <target> [, <target> ...];

target
Будь-яка ціль, яку приймає інструкція SET: ім'я змінної, просте або в подвійних лапках, чи шлях конфігурації в подвійних лапках із префіксом у вигляді знака долара.

SESSION
Необов'язкове ключове слово, що позначає єдину наявну область: UNSET SESSION name і UNSET name - та сама інструкція, оскільки кожна змінна й кожне налаштування конфігурації належать до поточного сеансу. Інструкція UNSET GLOBAL відхиляється з помилкою configuration scope "global" is not supported; use SESSION.

Інструкція UNSET name еквівалентна інструкції SET name = DEFAULT. Цілі в одному списку видаляються в порядку переліку, а видалення імені, яке не встановлено, не є помилкою. Розіменування змінної після скасування її значення завершується помилкою ще до надсилання будь-якого запиту до провайдера.

ЦільДія
nameВидаляє змінну сеансу.
"$.auth.<provider>.<field>"Видаляє це поле з контексту автентифікації провайдера в сеансі. Значення, чинне до перевизначення, не відновлюється.
"$.providers.<alias>"Видаляє прив'язку псевдоніма провайдера.
"$.secrets.<name>"Видаляє секрет зі сховища сеансу. Для постійного сховища ОС це видаляє збережене значення.
"$.secret_store"Скасовує поточну прив'язку сховища й починає з порожньої пам'яті сеансу. Значення, уже збережені в сховищі ОС, не видаляються.

Приклади​

Видалення змінної​

Змінну видалено із сеансу, тому закоментований запит завершується помилкою variable "$region" is not defined, а не виконується з неактуальним або порожнім значенням. Щоб знову використовувати це ім'я, встановіть його ще раз.

SET region = 'ap-southeast-2';
UNSET region;

/*
SELECT name FROM aws.s3.buckets WHERE region = $region;
-- FAILS with variable "$region" is not defined
*/

Видалення кількох цілей​

Одна інструкція може видаляти змінні й шляхи конфігурації разом, а цілі обробляються послідовно. Тут в одному списку видаляються проста змінна, змінна з іменем, що містить крапки, і перевизначення облікових даних.

UNSET region, "providers.saved", "$.auth.github.password_var";

Явне зазначення області сеансу​

Ці дві інструкції роблять те саме: SESSION називає єдину наявну область. Явна форма підходить для скриптів, які також виконуються в базах даних, що розрізняють стан сеансу й глобальний стан. Закоментована інструкція завершується помилкою, оскільки спільного стану немає.

UNSET region;
UNSET SESSION region;

/*
UNSET GLOBAL region;
-- FAILS with configuration scope "global" is not supported; use SESSION
*/

Скасування перевизначення облікових даних​

Поле, раніше встановлене за допомогою SET "$.auth.github.password_var", видаляється з контексту автентифікації провайдера GitHub у сеансі, а інші поля цього контексту залишаються незмінними. Значення, чинне до перевизначення, не відновлюється, тому встановіть поле знову, якщо воно ще потрібне провайдеру.

UNSET "$.auth.github.password_var";

Видалення псевдоніма провайдера та його секрету​

Псевдонім production прив'язано за допомогою SET "$.providers.production", і через auth_secret він посилається на секрет, збережений у $.secrets.production. Видалення обох в одній інструкції скасовує прив'язку, тож production.s3.buckets більше не є допустимим відношенням, і видаляє секрет зі сховища сеансу. Ключове слово SESSION тут, як і скрізь, необов'язкове.

UNSET SESSION "$.providers.production", "$.secrets.production";