Dela via

Typ: STRUCT

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Representerar värden med den struktur som beskrivs av en sekvens med fält.

Syntax

STRUCT < [fieldName [:] fieldType [NOT NULL] [COLLATE collationName] [COMMENT str] [, …] ] >

  • fieldName: En identifierare som namnger fältet. Namnen behöver inte vara unika.

  • fieldType: Alla datatyper.

  • NOT NULL: När det är angivet garanterar strukturen att värdet för det här fältet aldrig är NULL.

  • COLLATE collationName: Detta anger eventuellt vilken sortering som ska användas för en fieldType av STRING.

    Om inte anges ärvs sorteringen från kontexten där STRUCT definieras:

    • Inom en CREATE eller ALTER av en TABLE, VIEW eller FUNCTION, matchar den standardsorteringen standardsorteringen för det TABLE, VIEW eller FUNCTION.
    • I kontexten av ett toppnivå UPDATE , DELETE, INSERT, MERGE eller frågekommando är standardsorteringen UTF8_BINARY.

  • COMMENT str: En valfri strängliteral som beskriver fältet.

Gränser

Typen stöder valfritt antal fält som är större eller lika med 0.

Literaler

Mer information om hur du skapar matrisvärden finns i struct funktion och named_struct funktion.

Exempel

> SELECT struct('Spark', 5);
  {Spark, 5}

> SELECT typeof(named_struct('Field1', 'Spark', 'Field2', 5));
  struct<Field1:string,Field2:int>

> SELECT typeof(struct('Spark', 5));
  struct<col1:string,col2:int>

> SELECT typeof(CAST(NULL AS STRUCT<Field1:INT NOT NULL COMMENT 'The first field.',Field2:ARRAY<INT>>));
  struct<Field1:int,Field2:array<int>>

> SELECT collation(cast(struct('hello')) AS STRUCT<name STRING COLLATE UNICODE_CI>).name);
 SYSTEM.BUILTIN.UNICODE_CI