通过

STRUCT 类型

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime

表示多个值，其结构通过一系列字段来描述。

语法

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

  • fieldName：给字段命名的标识符。 名称不必是唯一的。

  • fieldType：任何数据类型。

  • NOT NULL：指定时，结构保证此字段的值永远不会 NULL。

  • COLLATE collationName：可以选择性地指定用于 fieldType 的 STRING 的排序规则。

    如果未指定此项，则排序规则将从定义 STRUCT 的上下文中继承：

    • 在某个CREATE、ALTER或者TABLE、VIEW、FUNCTION内部，其默认排序规则与该TABLE、VIEW或者FUNCTION的默认排序规则匹配。
    • 在顶级 UPDATE 、 DELETE、 INSERT、 MERGE 或 查询语句 的上下文中，默认排序规则为 UTF8_BINARY。

  • COMMENT str：描述字段的可选字符串字面量。

限制

类型支持任何大于或等于 0 的字段数。

文本

有关如何生成文本数组值的详细信息，请参阅 struct 函数 和 named_struct 函数 。

示例

> 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