STRUCT

説明

指定された値に基づいて構造体を構築し、返します。この関数は1つ以上のパラメータを受け取り、すべての入力要素を含む構造体を返します。

構文

STRUCT( <expr1> [ , <expr2> ... ] )

パラメータ

<expr1>, <expr2>, ...: structを構築するための入力コンテンツ、1つまたは複数のパラメータをサポート

サポートされる要素の型:

数値型: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
文字列型: CHAR, VARCHAR, STRING
日付と時間型: DATE, DATETIME, DATEV2, DATETIMEV2
ブール型: BOOLEAN
IP型: IPV4, IPV6
複合型: ARRAY, MAP, STRUCT

戻り値

戻り値の型: STRUCT

戻り値の意味:

すべての入力要素を含むstructを返し、フィールド名はデフォルトでcol1, col2, col3, ...の形式
すべてのフィールドはNULL値をサポート

使用方法

この関数はすべての入力要素をstructに結合します
少なくとも1つのパラメータが必要です
すべてのフィールドはnullableとしてマークされます

例

クエリ例:

基本的な使用方法: nullフィールドを含む混合型を含むstructの作成

select struct(1, 'a', "abc"),struct(null, 1, null),struct(cast('2023-03-16' as datetime));
+--------------------------------------+--------------------------------------+----------------------------------------+
| struct(1, 'a', "abc")                | struct(null, 1, null)                | struct(cast('2023-03-16' as datetime)) |
+--------------------------------------+--------------------------------------+----------------------------------------+
| {"col1":1, "col2":"a", "col3":"abc"} | {"col1":null, "col2":1, "col3":null} | {"col1":"2023-03-16 00:00:00"}         |
+--------------------------------------+--------------------------------------+----------------------------------------+

複合型を含む構造体の作成:

select struct([1,2,3], {'name':'Alice','age':20}, named_struct('f1',1,'f2',2));
+----------------------------------------------------------------------------------+
| struct([1,2,3], {'name':'Alice','age':20}, named_struct('f1',1,'f2',2))          |
+----------------------------------------------------------------------------------+
| {"col1":[1, 2, 3], "col2":{"name":"Alice", "age":"20"}, "col3":{"f1":1, "f2":2}} |
+----------------------------------------------------------------------------------+

IP アドレスを含む構造体の作成:

select struct(cast('192.168.1.1' as ipv4), cast('2001:db8::1' as ipv6));
+------------------------------------------------------------------+
| struct(cast('192.168.1.1' as ipv4), cast('2001:db8::1' as ipv6)) |
+------------------------------------------------------------------+
| {"col1":"192.168.1.1", "col2":"2001:db8::1"}                     |
+------------------------------------------------------------------+

エラー例

サポートされていない型はエラーを報告します： Json/Variant型を含む構造体の作成

select struct(v) from var_with_index;
ERROR 1105 (HY000): errCode = 2, detailMessage = struct does not support jsonb/variant type

select struct(cast(1 as jsonb)) from var_with_index;
ERROR 1105 (HY000): errCode = 2, detailMessage = struct does not support jsonb/variant type

空のstructを作成するとエラーが報告されます。少なくとも1つのパラメータが必要で、これはhiveの動作と一致しています：

select struct();
ERROR 1105 (HY000): errCode = 2, detailMessage = struct requires at least one argument, like: struct(1)

説明​

構文​

パラメータ​

戻り値​

使用方法​

例​

説明

構文

パラメータ

戻り値

使用方法

例