TypeSTRUCT

S’applique à : Databricks SQL Databricks Runtime

Représente des valeurs avec la structure décrite par une séquence de champs.

Syntaxe

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

• fieldName : identificateur qui nomme le champ. Les noms doivent être uniques.

• fieldType : n’importe quel type de données.

• NOT NULL: lorsqu’il est spécifié, le struct garantit que la valeur de ce champ n’est jamais NULL.

• COLLATE collationName: spécifie éventuellement le classement à utiliser pour une fieldType de STRING.

  S’il n’est pas spécifié, le classement est hérité du contexte dans lequel le STRUCT classement est défini :

  • Dans un CREATE ou ALTER d’un TABLE, VIEW ou FUNCTION, le classement par défaut correspond au classement par défaut de ce TABLE, VIEW ou FUNCTION.
  • Dans le contexte d’un niveau supérieur de UPDATE, DELETE, INSERT, MERGE ou instruction de requête, le classement par défaut est UTF8_BINARY.

• COMMENT str : littéral de chaîne facultatif qui décrit le champ.

limites

Le type prend en charge un nombre quelconque de champs supérieur ou égal à 0.

Littéraux

Pour des détails sur la façon de produire des valeurs de tableau littérales, consultez la struct fonction et la named_struct fonction.

Exemples

> 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

Rubriques connexes

• Type ARRAY
• Type MAP
• Fonction struct
• Fonction named_struct
• Fonction cast