OBJECT_INSERT¶

構文¶

OBJECT_INSERT( <object> , <key> , <value> [ , <updateFlag> ] )

引数¶

必須：

object

新しいキー値のペアが挿入されるか、既存のキー値のペアが更新されるソース OBJECT 値。

key

OBJECT 値に挿入する新しいキー、または値を更新する既存のキー。指定されたキーは、 updateFlag が TRUE に設定されている場合を除き、 OBJECT 値にある既存のすべてのキーと異なっている必要があります。

value

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

オプション：

updateFlag

ブールフラグ。 TRUE に設定すると、入力値は、新しいキーと値のペアを挿入するのではなく、 OBJECT 値にある既存のキーの値を更新することを指定します。

デフォルトは FALSE です。

戻り値¶

この関数は、 OBJECT データ型を持つ値を返します。

使用上の注意¶

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

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

  • key または value のいずれかが SQL NULL の場合は、返される OBJECT 値からキーと値のペアが省略されます。

• オプションの updateFlag 引数が TRUE に設定されている場合、既存の入力 key は入力 value に更新されます。 updateFlag が省略されているか、 FALSE に設定されている場合は、 OBJECT 値にすでに存在する入力キーでこの関数を呼び出すとエラーになります。

• 更新フラグが TRUE に設定されているが、対応するキーが OBJECT 値にまだ存在しない場合は、キーと値のペアが追加されます。

• 構造化 OBJECT 値 の場合:

  • キーとなる引数には、定数を指定する必要があります。

  • updateFlag 引数が FALSE の場合（新しいキーと値のペアを挿入する場合）:

    • OBJECT 値にすでに存在するキーを指定するとエラーになります。

      SELECT OBJECT_INSERT(
        {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR,state VARCHAR),
        'city',
        'San Jose',
        false
      );
      

      Copy

      093202 (23001): Function OBJECT_INSERT:
        expected structured object to not contain field city but it did.
      

    • この関数は、構造化 OBJECT 値を返します。OBJECT 値の型には、新しく挿入されたキーが含まれます。例えば、 FLOAT 値の 94402 を持つ zipcode キーを追加するとします。

      SELECT
        OBJECT_INSERT(
          {'city':'San Mateo','state':'CA'}::OBJECT(city VARCHAR,state VARCHAR),
          'zip_code',
          94402::FLOAT,
          false
        ) AS new_object,
        SYSTEM$TYPEOF(new_object) AS type;
      

      Copy

      +-------------------------------------+---------------------------------------------------------------------------------------+
      | NEW_OBJECT                          | TYPE                                                                                  |
      |-------------------------------------+---------------------------------------------------------------------------------------|
      | {                                   | OBJECT(city VARCHAR(16777216), state VARCHAR(16777216), zip_code FLOAT NOT NULL)[LOB] |
      |   "city": "San Mateo",              |                                                                                       |
      |   "state": "CA",                    |                                                                                       |
      |   "zip_code": 9.440200000000000e+04 |                                                                                       |
      | }                                   |                                                                                       |
      +-------------------------------------+---------------------------------------------------------------------------------------+
      

      挿入される値の型は OBJECT 型の定義に追加される型を決定します。この場合、 zipcode の値は FLOAT にキャストされた値であるため、 zipcode の型は FLOAT になります。

  • updateFlag 引数が TRUE の場合（既存のキーと値のペアを置き換える場合）:

    • OBJECT 値に存在しないキーを指定するとエラーになります。

    • この関数は、同じ型の構造化 OBJECT 値を返します。

    • 挿入された値の型は、既存のキーの型に 強制 されます。

例¶

例では、次のテーブルを使用します。

CREATE OR REPLACE TABLE object_insert_examples (object_column OBJECT);

INSERT INTO object_insert_examples (object_column)
  SELECT OBJECT_CONSTRUCT('a', 'value1', 'b', 'value2');

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "value2"  |
| }                |
+------------------+

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'c', 'value3');

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "value2", |
|   "c": "value3"  |
| }                |
+------------------+

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'd', PARSE_JSON('null'));

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'e', NULL);

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'f', 'null');

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "value2", |
|   "c": "value3", |
|   "d": null,     |
|   "f": "null"    |
| }                |
+------------------+

UPDATE object_insert_examples
  SET object_column = OBJECT_INSERT(object_column, 'b', 'valuex', TRUE);

SELECT * FROM object_insert_examples;

+------------------+
| OBJECT_COLUMN    |
|------------------|
| {                |
|   "a": "value1", |
|   "b": "valuex", |
|   "c": "value3", |
|   "d": null,     |
|   "f": "null"    |
| }                |
+------------------+