メインコンテンツまでスキップ
バージョン: 26.x

NAMED_STRUCT

説明​

与えられたフィールド名と値に基づいて構造体を構築し、返します。この関数は偶数個のパラメータを受け取り、奇数位置がフィールド名、偶数位置がフィールド値となります。

構文​

NAMED_STRUCT( <field_name> , <field_value> [ , <field_name> , <field_value> ... ] )

パラメータ​

  • <field_name>: struct構築用の奇数位置の入力内容、フィールド名、定数文字列である必要があります
  • <field_value>: struct構築用の偶数位置の入力内容、フィールドの値、複数列または定数が可能です

サポートされる要素タイプ:

  • 数値タイプ: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 文字列タイプ: CHAR, VARCHAR, STRING
  • 日付と時刻タイプ: DATE, DATETIME, DATEV2, DATETIMEV2
  • Boolean タイプ: BOOLEAN
  • IP タイプ: IPV4, IPV6
  • 複合タイプ: ARRAY, MAP, STRUCT

戻り値​

戻り値の型: STRUCT

戻り値の意味:

  • 指定されたすべてのフィールド名と値のペアを含むstructを返します
  • すべてのフィールドはNULL値をサポートします

使用方法​

  • この関数はすべてのフィールド名と値のペアをstructに結合します。奇数位置はフィールド名（定数文字列である必要があり、重複不可、大文字小文字を区別しません）、偶数位置はフィールド値（複数列または定数が可能）です
  • パラメータの数は1より大きい0以外の偶数である必要があります
  • すべてのフィールドはnullableとしてマークされます

クエリ例:

基本的な使用方法:

select named_struct('name', 'Alice', 'age', 25, 'city', 'Beijing');
+-------------------------------------------------------------+
| named_struct('name', 'Alice', 'age', 25, 'city', 'Beijing') |
+-------------------------------------------------------------+
| {"name":"Alice", "age":25, "city":"Beijing"}                |
+-------------------------------------------------------------+

null値を含む場合：

select named_struct('id', 1, 'name', null, 'score', 95.5);
+----------------------------------------------------+
| named_struct('id', 1, 'name', null, 'score', 95.5) |
+----------------------------------------------------+
| {"id":1, "name":null, "score":95.5}                |
+----------------------------------------------------+

複合型を含む場合：

select named_struct('array', [1,2,3], 'map', {'key':'value'}, 'struct', named_struct('f1',1,'f2',2));
+-----------------------------------------------------------------------------------------------+
| named_struct('array', [1,2,3], 'map', {'key':'value'}, 'struct', named_struct('f1',1,'f2',2)) |
+-----------------------------------------------------------------------------------------------+
| {"array":[1, 2, 3], "map":{"key":"value"}, "struct":{"f1":1, "f2":2}}                         |
+-----------------------------------------------------------------------------------------------+

IP アドレスを含む名前付き構造体の作成:

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

エラー例

パラメータが2個未満の場合：

select named_Struct();
ERROR 1105 (HY000): errCode = 2, detailMessage = named_struct requires at least two arguments, like: named_struct('a', 1)

select named_struct('name');
ERROR 1105 (HY000): errCode = 2, detailMessage = named_struct requires at least two arguments, like: named_struct('a', 1)

パラメータの数が奇数です:

select named_struct('name', 'Alice', 'age');
ERROR 1105 (HY000): errCode = 2, detailMessage = named_struct can't be odd parameters, need even parameters named_struct('name', 'Alice', 'age')

重複するフィールド名、フィールド名は大文字小文字を区別しません：

select named_struct('name', 'Alice', 'name', 'Bob');
ERROR 1105 (HY000): errCode = 2, detailMessage = The name of the struct field cannot be repeated. same name fields are name

select named_struct('name', 'Alice', 'Name', 'Bob');
ERROR 1105 (HY000): errCode = 2, detailMessage = The name of the struct field cannot be repeated. same name fields are name