カテゴリ：

半構造化データ関数と構造化データ関数 （マップ）

MAP_INSERT

入力 MAP 新しいキーと値のペアが挿入された新しい:doc:MAP </sql-reference/data-types-structured> を返します。つまり既存のキーは新しい値に更新されます。

構文

MAP_INSERT( <map> , <key> , <value> [ , <updateFlag> ] )

引数

map

新しいキーと値のペアが挿入されるソースマップです。

key

マップに挿入する新しいキー。updateFlag が TRUE に設定されていない限り、マップ内のすべての既存のキーと異なっている必要があります。

value

キーに関連付けられた値です。

オプション

updateFlag

ブール値フラグで、 TRUE に設定されている場合、新しいキーと値のペアを挿入するのではなく、マップ内のキーに対応する既存の値を更新するために使用される入力値を指定します。

デフォルトは FALSE です。

戻り値

新しいキーと値のペアが挿入された入力 MAP、または新しい値で更新された既存のキーで構成される MAP を返します。

使用上の注意

  • キー式の型は、マップのキーの型と一致している必要があります。型が VARCHAR の場合、型は異なる長さにすることができます。

  • 関数は JSON null 値をサポートしますが、 SQL NULL 値またはキーはサポートしません。

    • key が NULL 以外の文字列で、 value が JSON null（例: PARSE_JSON('NULL')）の場合は、キーと値のペアが返されたマップに挿入されます。

    • key が NULL 以外の文字列で、 value が SQL NULL （例: NULL）の場合は、値は JSON null に変換され、キーと値のペアは返されたマップに挿入されます。

    • key が SQL NULL の場合、キーと値のペアは返されたマップから省略されます。

  • updateFlag が TRUE に設定される場合、既存の入力 key は入力 value に更新されます。updateFlag が省略されるか FALSE に設定され、入力キーが既にマップに存在する場合、エラーが返されます。

  • updateFlag が TRUE に設定されているけれども、対応するキーがマップにまだ存在しない場合、キーと値のペアが追加されます。

例

3つのキーと値のペアを、2つのキーと値のペアを含むマップに挿入します。

SELECT MAP_INSERT({'a':1,'b':2}::MAP(VARCHAR,NUMBER),'c',3);

+------------------------------------------------------+
| MAP_INSERT({'A':1,'B':2}::MAP(VARCHAR,NUMBER),'C',3) |
|------------------------------------------------------|
| {                                                    |
|   "a": 1,                                            |
|   "b": 2,                                            |
|   "c": 3                                             |
| }                                                    |
+------------------------------------------------------+

1つのキーと値のペアを省略しながら、2つの新しいキーと値のペアを空のマップに挿入します。

  • Key_One は、 JSON null値で構成されています。

  • Key_Two はSQL NULL 値で構成され、 JSON null 値に変換されます。

  • Key_Three は、「null」を含む文字列で構成されます。

SELECT MAP_INSERT(MAP_INSERT(MAP_INSERT({}::MAP(VARCHAR,VARCHAR),
  'Key_One', PARSE_JSON('NULL')), 'Key_Two', NULL), 'Key_Three', 'null');

+---------------------------------------------------------------------------+
| MAP_INSERT(MAP_INSERT(MAP_INSERT({}::MAP(VARCHAR,VARCHAR),                |
|    'KEY_ONE', PARSE_JSON('NULL')), 'KEY_TWO', NULL), 'KEY_THREE', 'NULL') |
|---------------------------------------------------------------------------|
| {                                                                         |
|   "Key_One": null,                                                        |
|   "Key_Three": "null",                                                    |
|   "Key_Two": null                                                         |
| }                                                                         |
+---------------------------------------------------------------------------+

既存のキーと値のペア（"k1": 100）を新しい値（"string-value"）で更新します。

SELECT MAP_INSERT({'k1':100}::MAP(VARCHAR,VARCHAR), 'k1', 'string-value', TRUE) AS map;

+------------------------+
| MAP                    |
|------------------------|
| {                      |
|   "k1": "string-value" |
| }                      |
+------------------------+

MAP 値を含む仮テーブルを作成します。

CREATE OR REPLACE TEMP TABLE demo_maps(
  id INTEGER,
  attrs MAP(VARCHAR, VARCHAR),
  defaults MAP(VARCHAR, VARCHAR),
  keep_keys ARRAY(VARCHAR),
  ins_key VARCHAR,
  ins_val VARCHAR,
  update_existing BOOLEAN,
  del_key1 VARCHAR,
  del_key2 VARCHAR);

INSERT INTO demo_maps SELECT
  1,
  {'color':'red','size':'M','brand':'Acme'}::MAP(VARCHAR, VARCHAR),
  {'currency':'USD','size':'L'}::MAP(VARCHAR, VARCHAR),
  ['color','brand']::ARRAY(VARCHAR),
  'material',
  'cotton',
  TRUE,
  'size',
  'brand';

INSERT INTO demo_maps SELECT
  2,
  {'color':'blue','brand':'ZenCo'}::MAP(VARCHAR, VARCHAR),
  {'currency':'EUR','size':'M','brand':'ZenCo'}::MAP(VARCHAR, VARCHAR),
  ['brand','currency']::ARRAY(VARCHAR),
  'brand',
  'ZC',
  FALSE,
  'currency',
  'material';

テーブルをクエリしてデータを表示します。

SELECT * FROM demo_maps;

+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+
| ID | ATTRS               | DEFAULTS             | KEEP_KEYS    | INS_KEY  | INS_VAL | UPDATE_EXISTING | DEL_KEY1 | DEL_KEY2 |
|----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------|
|  1 | {                   | {                    | [            | material | cotton  | True            | size     | brand    |
|    |   "brand": "Acme",  |   "currency": "USD", |   "color",   |          |         |                 |          |          |
|    |   "color": "red",   |   "size": "L"        |   "brand"    |          |         |                 |          |          |
|    |   "size": "M"       | }                    | ]            |          |         |                 |          |          |
|    | }                   |                      |              |          |         |                 |          |          |
|  2 | {                   | {                    | [            | brand    | ZC      | False           | currency | material |
|    |   "brand": "ZenCo", |   "brand": "ZenCo",  |   "brand",   |          |         |                 |          |          |
|    |   "color": "blue"   |   "currency": "EUR", |   "currency" |          |         |                 |          |          |
|    | }                   |   "size": "M"        | ]            |          |         |                 |          |          |
|    |                     | }                    |              |          |         |                 |          |          |
+----+---------------------+----------------------+--------------+----------+---------+-----------------+----------+----------+

ins_key 列のキーと ins_val 列の値を使用して、attrs 列のマップにキーと値のペアを挿入または更新します。

SELECT id, MAP_INSERT(attrs, ins_key, ins_val, TRUE) AS attrs_insert_or_update
  FROM demo_maps;

+----+-------------------------+
| ID | ATTRS_INSERT_OR_UPDATE  |
|----+-------------------------|
|  1 | {                       |
|    |   "brand": "Acme",      |
|    |   "color": "red",       |
|    |   "material": "cotton", |
|    |   "size": "M"           |
|    | }                       |
|  2 | {                       |
|    |   "brand": "ZC",        |
|    |   "color": "blue"       |
|    | }                       |
+----+-------------------------+