Sdílet prostřednictvím


Typ STRUCT

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime

Představuje hodnoty se strukturou popsanou posloupností polí.

Syntaxe

STRUCT < [fieldName [:] fieldType [NOT NULL] [COLLATE collationName] [COMMENT str] [, …] ] >
  • fieldName: Identifikátor pojmenovávající pole. Názvy nemusí být jedinečné.

  • fieldType: Libovolný datový typ.

  • NOT NULL: Při zadání struktura zaručuje, že hodnota tohoto pole není nikdy NULL.

  • COLLATE collationName: Tímto můžete volitelně určit kolaci, která se použije pro fieldTypeSTRING.

    Pokud není řazení výslovně zadáno, přebírá se z kontextu, ve kterém je STRUCT definován:

    • CREATE, ALTER nebo TABLE má výchozí kolaci, která odpovídá výchozí kolaci tohoto VIEW, FUNCTION nebo TABLE.
    • V kontextu UPDATE nejvyšší úrovně , DELETE, INSERT, MERGE nebo příkaz dotazu výchozí kolace je UTF8_BINARY.
  • COMMENT str: Volitelný řetězcový literál popisující pole.

Omezení

Typ podporuje libovolný počet polí větších nebo rovnajících se 0.

Literály

Podrobnosti o tom, jak vytvořit hodnoty literálového pole, najdete v tématu struct funkce a named_struct funkce.

Příklady

> 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