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 um fieldType de STRING.

  Se não for especificado, o agrupamento é herdado do contexto no qual o STRUCT é definido:

  • Dentro de um CREATE, ALTER ou TABLE, VIEW ou FUNCTION, o agrupamento padrão corresponde ao agrupamento padrão desse TABLE, VIEW ou FUNCTION.
  • No contexto de um nível superior UPDATE, DELETE, INSERT, MERGE ou instrução de consulta, o agrupamento padrão é UTF8_BINARY.

• 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>).name);
 SYSTEM.BUILTIN.UNICODE_CI

Relacionado

• ARRAY tipo
• MAP tipo
• struct Função
• named_struct Função
• cast Função