Partager via

TypeSTRUCT

  • Article

S’applique à :case marquée oui Databricks SQL case marquée oui 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.

    Si ce n’est pas spécifié, l'ordre de tri 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

Consultez Fonction struct et Fonction named_struct pour plus d’informations sur la manière de produire des valeurs de tableau de littéraux.

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