Freigeben über

SET VARIABLE

  • Artikel

Gilt für: Häkchen ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 14.1 und höher

Ändert den Wert einer oder mehrerer temporärer Variablen.

Verwenden Sie SET, um einen Konfigurationsparameter festzulegen.

Syntax

SET { VAR | VARIABLE } { variable_name = { expression | DEFAULT } } [, ...]

SET { VAR | VARIABLE } ( variable_name [, ...] ) = ( query ) }

Parameter

  • variable_name

    Gibt den Namen einer temporären Variable an.

    Wenn die Variable nicht gefunden werden kann, löst Azure Databricks einen Fehler vom Typ UNRESOLVED_VARIABLE aus.

    Wenn Sie doppelte Variablen angeben, löst Azure Databricks einen Fehler vom Typ DUPLICATE_ASSIGNMENTS aus.

  • expression

    Jeder wohlgeformte Ausdruck, der den neuen Variablenwert berechnet.

  • DEFAULT

    Es wurde der Standardausdruck der Variable verwendet oder NULL, wenn keiner angegeben wurde, um den neuen Variablenwert zu berechnen.

  • query

    Jede wohlgeformte Abfrage mit den folgenden Einschränkungen:

    Wenn die Abfrage keine Zeilen zurückgibt, legt Azure Databricks alle angegebenen Variablen auf NULL fest.

    Sie können das Schlüsselwort DEFAULT anstelle eines Ausdrucks zur Listenauswahl verwenden, um eine Variable auf ihren Standardwert festzulegen.

Beispiele

> DECLARE VARIABLE myvar1 INT DEFAULT 7;
> DECLARE VARIABLE myvar2 STRING DEFAULT ‘hello’;

-- Set a SQL variable to a value
> SET VAR myvar1 = 5;
> VALUES (myvar1);
  5

-- Set a SQL variable back to DEFAULT
> SET VARIABLE myvar1 = DEFAULT;
> VALUES (myvar1);
  7

-- Set a SQL variable to the result of a scalar subquery.
> SET VARIABLE myvar1 = (SELECT max(c1) FROM VALUES(1), (2) AS T(c1));
> VALUES (myvar1);
  2

-- Set multiple variables from a query
> SET VAR (myvar1, myvar2) = (VALUES(10, 'world'));
> VALUES (myvar1, myvar2);
  10   world

-- Set multiple variables from expressions
> SET VAR myvar1 = 11, myvar2 = 'hello';
> VALUES (myvar1, myvar2);
  11   hello

-- Set multiple variables based on a query
> SET VARIABLE (myvar1, myvar2)
    = (SELECT max(c1), CAST(min(c1) AS STRING) FROM VALUES(1), (2) AS T(c1));
> VALUES (myvar1, myvar2);
  2    1

-- Assign NULLs on empty query
> SET VAR (myvar1, myvar2)
    = (SELECT max(c1), CAST(min(c1) AS STRING) FROM VALUES(1), (2) AS T(c1) HAVING max(c1) = 0);
> VALUES (myvar1, myvar2);
  NULL  NULL

-- 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 VARIABLE colname = 'c2';
> SELECT IDENTIFIER(colname) FROM VALUES(1, 2) AS T(c1, c2);
  2

-- Variable defaults are recomputed
> DECLARE VARIABLE val DEFAULT RAND();
> SELECT val;
  0.1234...

> SET VARIABLE val = DEFAULT;
> SELECT val;
  0.9876...