共用方式為

STRUCT 類型

  • 發行項

適用於：核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime

表示具有欄位序列所描述結構的值。

語法

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

  • fieldName：為欄位命名的標識碼。 名稱不一定是唯一的。

  • fieldType：任何數據類型。

  • NOT NULL：指定時，結構會保證此欄位的值永遠不會 NULL。

  • COLLATE 定序名稱：這選擇性地指定要用於 fieldType之 STRING 的定序。

    如果未指定，排序規則為 UTF8_BINARY。

  • COMMENT str：描述欄位的選擇性字串常值。

限制

此類型支援任意數目大於或等於 0 的欄位。

常值

如需如何產生常值陣列值的詳細資訊，請參閱 結構函式 和 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>)
 UNICODE_CI