Condividi tramite

Tipo STRUCT

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Rappresenta i valori con la struttura descritta da una sequenza di campi.

Sintassi

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

  • fieldName: identificatore che denomina il campo. I nomi non devono essere univoci.

  • fieldType: qualsiasi tipo di dati.

  • NOT NULL: se specificato, la struttura garantisce che il valore di questo campo non venga mai NULL.

  • COLLATE collationName: specifica facoltativamente le regole di confronto da utilizzare per un fieldType di STRING.

    Se non sono specificate le regole di confronto, vengono ereditate dal contesto in cui STRUCT è definito.

    • All'interno di un CREATE o ALTER, TABLE, VIEW o FUNCTION, le regole di confronto predefinite corrispondono alle regole di confronto predefinite di quel TABLE, VIEW o FUNCTION.
    • Nel contesto di una query di primo livello UPDATE, DELETE, INSERT, MERGE o , l'istruzione di query è regolata dalle regole di confronto predefinite UTF8_BINARY.

  • COMMENT str: stringa letterale facoltativa che descrive il campo.

Limiti

Il tipo supporta un numero qualsiasi di campi maggiore o uguale a 0.

Valori letterali

Per informazioni dettagliate su come produrre valori di matrice letterali, vedere struct funzione e named_struct funzione .

Esempi

> 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>)
 UNICODE_CI