Tipo STRUCT
Aplica-se a: Databricks SQL
Databricks Runtime
Representa valores com a estrutura descrita por uma sequência de campos.
Sintaxe
STRUCT < [fieldName [:] fieldType [NOT NULL] [COLLATE collationName] [COMMENT str] [, …] ] >
fieldName
: Um identificador que nomeia o campo. Os nomes não precisam ser exclusivos.fieldType
: Qualquer tipo de dados.NOT NULL
: Quando especificado, o struct garante que o valor deste campo nunca éNULL
.COLLATE
collationName: Opcionalmente, especifica a ordenação a ser usada para umfieldType
deSTRING
.Se não for especificado, o agrupamento é herdado do contexto no qual o
STRUCT
é definido:- Dentro de um
CREATE
ouALTER
de umTABLE
ouVIEW
, o agrupamento padrão corresponde ao agrupamento padrão desseTABLE
, ouVIEW
. - No contexto de um nível superior UPDATE, DELETE, INSERT, MERGE ou instrução de consulta, o agrupamento padrão é
UTF8_BINARY
.
- Dentro de um
COMMENT str
: Um literal de cadeia opcional que descreve o campo.
Limites
O tipo suporta qualquer número de campos maior ou igual a 0.
Literais
Consulte a função struct
e a função named_struct
para obter detalhes sobre como produzir valores de matriz literal.
Exemplos
> 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