ОБЪЯВЛЕНИЕ ПЕРЕМЕННОЙ

  • Статья

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

Создает частную, временную переменную сеанса, которую можно ссылать, где можно использовать константное выражение. Можно также использовать переменные в сочетании с предложением IDENTIFIER для параметризации идентификаторов в инструкциях SQL.

Переменные изменяются с помощью инструкции SET VARIABLE .

Временные переменные нельзя ссылаться в пределах:

  • ограничение проверка,
  • созданный столбец,
  • выражение по умолчанию,
  • текст сохраненного пользовательского приложения SQL,
  • Текст сохраняемого представления.

Временные переменные также называются переменными сеанса .

Синтаксис

DECLARE [ OR REPLACE ] [ VARIABLE ] variable_name
    [ data_type ] [ { DEFEAULT | = } default_expression ]

Параметры

  • OR REPLACE

    При указании переменная с тем же именем заменяется.

  • variable_name

    Имя переменной. Имя может быть квалифицировано или sessionsystem.session. Если OR REPLACE не указано, имя должно быть уникальным в сеансе.

  • data_type

    Любой поддерживаемый тип данных. Если data_type опущен, необходимо указать DEFAULTи тип, производный от него default_expression.

  • DEFAULT_EXPRESSION по умолчанию или = default_expression

    Определяет начальное значение переменной после создания. default_expression должен быть приведение к data_type. Если значение по умолчанию не задано, переменная инициализирована с NULLпомощью .

    Если выражение содержит вложенный запрос Azure Databricks, вызывает INVALID_DEFAULT_VALUE. ошибка SUBQUERY_EXPRESSION.

Примеры

-- Create a variable with a default
> DECLARE VARIABLE myvar INT DEFAULT 5;
> VALUES (myvar);
 5

-- Setting a variable
> SET VAR myvar = (SELECT sum(c1) FROM VALUES(1), (2) AS T(c1);
> VALUES (myvar);
 3

-- Variables are the outermost scope.
> SELECT myvar, t.myvar, session.myvar FROM VALUES(1) AS T(myvar);
  1  1  3

> DROP TEMPORARY VARIABLE myvar;

-- A minimalist variable declaration
> DECLARE myvar = 5;
> VALUES (myvar);
 5

-- Using a variable with an IDENTIFIER clause
> DECLARE colname STRING;
> SET VAR colname = 'c1';
> SELECT IDENTIFIER(colname) FROM VALUES(1, 2) AS T(c1, c2);
  1

> SET VAR colname = 'c2';
> SELECT IDENTIFIER(colname) FROM VALUES(1, 2) AS T(c1, c2);
  2