Tipo STRUCT

Si applica a: Databricks SQL 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>).name);
 SYSTEM.BUILTIN.UNICODE_CI

Elementi correlati

• tipo
• tipo
• struct Funzione
• named_struct Funzione
• cast Funzione