共用方式為

STRUCT 類型

適用於：選取是Databricks SQL 選取是Databricks Runtime

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

語法

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

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

  • fieldType：任何數據類型。

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

  • COLLATE 定序名稱：這選擇性地指定要用於 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
  • Last updated on