VALUES-clausule

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Produceert een inline tijdelijke tabel voor gebruik in de query.

Syntaxis

VALUES {expression | ( expression [, ...] ) } [, ...] [table_alias]

SELECT expression [, ...] [table_alias]

Parameterwaarden

  • uitdrukking

    Een combinatie van een of meer waarden, operators en SQL-functies die een waarde opleveren.

  • table_alias

    Een optioneel label waarmee naar de resultatenset kan worden verwezen op naam.

Elke tuple vormt een rij.

Als er meer dan één rij is, moet het aantal velden in elke tuple overeenkomen.

Wanneer u de VALUES syntaxis gebruikt en er geen tuples worden opgegeven, is elke expressie gelijk aan één veld-tuple.

Wanneer u de SELECT syntaxis gebruikt, vormen alle expressies één tijdelijke rijtabel.

Het nde veld van elke tuple moet een minst gangbaar type hebben. Als table_alias kolomnamen opgeeft, moet hun aantal overeenkomen met het aantal expressies per tuple.

Het resultaat is een tijdelijke tabel waarbij het type van elke kolom het minst gangbare type is van de overeenkomende tuplesvelden.

Als de rijen verschillende getallen kolommen hebben, wordt Azure Databricks INVALID_INLINE_TABLE. NUM_COLUMNS_MISMATCH. Als een expressie niet kan worden geëvalueerd tijdens de analyse, wordt Azure Databricks INVALID_INLINE_TABLE. CANNOT_EVALUATE_EXPRESSION_IN_INLINE_TABLE.

Algemene foutvoorwaarden

Voorbeelden

-- single row, without a table alias
> VALUES ("one", 1);
  one    1

-- Multiple rows, one column
> VALUES 1, 2, 3;
 1
 2
 3

-- three rows with a table alias
> SELECT data.a, b
    FROM VALUES ('one', 1),
                ('two', 2),
                ('three', NULL) AS data(a, b);
   one    1
   two    2
 three NULL

-- complex types with a table alias
> SELECT a, b
  FROM VALUES ('one', array(0, 1)),
              ('two', array(2, 3)) AS data(a, b);
 one [0, 1]
 two [2, 3]

-- Using the SELECT syntax
> SELECT 'one', 2
 one 2

-- Rows have different numbers of columns.
> VALUES (1, 2), (3);
  Error: INVALID_INLINE_TABLE
  • Last updated on