Переменные

  • Статья

Область применения: Databricks Runtime check marked yes 14.1 и более поздних версий

Переменные являются типизированными и квалифицированными объектами схемы, которые хранят значения, закрытые для сеанса. В Azure Databricks переменные являются временными и объявлены в сеансе с помощью инструкции DECLARE VARIABLE .

Термины временные переменные и переменные сеанса взаимозаменяемы.

Схема, в которой находятся system.sessionвременные переменные.

Переменная удаляется неявно в конце сеанса, определяющего его. Но вы можете явно удалить его ранее с помощью инструкции DROP VARIABLE .

Если переменная определяется ее значением NULL , или результатом необязательно указанного выражения по умолчанию. Значение любого числа переменных можно изменить с помощью инструкции SET VARIABLE в любое время во время сеанса.

Когда имена переменных запроса ссылаются на их пространство имен с именами столбцов, псевдонимами столбцов и именами параметров функции. Переменные являются последними в порядке разрешения в случае конфликтов имен.

Переменные отличаются семантической от маркеров параметров тремя способами:

  • Маркеры параметров существуют только в одной инструкции. Вызывающий API должен указать значение и тип. Переменные существуют в течение сеанса, что позволяет ссылаться на них в нескольких инструкциях без необходимости передавать значение для каждой инструкции.
  • Переменные можно задать без выхода из контекста SQL.
  • На переменные можно ссылаться в телах временных представлений и функций SQL. При ссылке на временное представление или временную функцию SQL будет использоваться текущее значение любой переменной в тексте.

Предложение IDENTIFIER принимает переменные в качестве аргументов. Это позволяет параметризировать идентификаторы с помощью переменных и результатов запросов, используемых для задания этих переменных.

Примеры

-- A verbose definition of a temporary variable
> DECLARE OR REPLACE VARIABLE myvar INT DEFAULT 17;

-- A dense definition, including derivation of the type from the default expression
> DECLARE address = named_struct('street', 'Grimmauld Place', 'number', 12);

-- Referencing a variable
> SELECT myvar, session.address.number;
 17  12

-- Setting a single variable
> SET VAR myvar = (SELECT max(c1) FROM VALUES (1), (2) AS t(c1));
> SELECT myvar;
  2

-- Setting multiple variables
> SET VAR (myvar, address) = (SELECT address.number, named_struct('street', address.street, 'number', 10));
> SELECT myvar, address;
  12    {"street":"Grimmauld Place","number":10}

-- Drop a variable
> DROP TEMPORARY VARIABLE myvar;
> DROP TEMPORARY VARIABLE IF EXISTS address;

-- Use the IDENTIFIER clause with a variable
> DECLARE view = 'tempv';
> CREATE OR REPLACE TEMPORARY VIEW IDENTIFIER(view) (c1) AS SELECT 1;
> SELECT * FROM IDENTIFIER(view);
  1