翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# INSERT
<a name="cql.dml.insert"></a>

`INSERT` ステートメントを使用してテーブルに行を追加します。

**[Syntax]** (構文)

```
insert_statement ::=  INSERT INTO table_name ( names_values | json_clause )
                      [ IF NOT EXISTS ]
                      [ USING update_parameter ( AND update_parameter )* ]
names_values     ::=  names VALUES tuple_literal
json_clause      ::=  JSON string [ DEFAULT ( NULL | UNSET ) ]                
names            ::=  '(' column_name ( ',' column_name )* ')'
```

**例**

```
INSERT INTO "myGSGKeyspace".employees_tbl (id, name, project, region, division, role, pay_scale, vacation_hrs, manager_id)
VALUES ('012-34-5678','Russ','NightFlight','US','Engineering','IC',3,12.5, '234-56-7890') ;
```

**パラメータを更新する**

`INSERT` は以下の値を `update_parameter` としてサポートします。
+ `TTL` — 秒単位の時間値。設定可能な最大値は 630,720,000 秒で、20 年に相当します。
+ `TIMESTAMP` — 標準基準時間 epoch 1970 年 1 月 1 日 00:00:00 GMT からのマイクロ秒数を表す `bigint` 値。Amazon Keyspaces タイムスタンプは、過去 2 日間と将来 5 分の範囲とします。

**例**

```
INSERT INTO my_table (userid, time, subject, body, user)
        VALUES (B79CB3BA-745E-5D9A-8903-4A02327A7E09, 96a29100-5e25-11ec-90d7-b5d91eceda0a, 'Message', 'Hello','205.212.123.123')
        USING TTL 259200;
```

**JSON サポート**

エンコードされた JSON データ型が Amazon Keyspaces のデータ型にマッピングされるテーブルについては、「[Amazon Keyspaces データ型の JSON エンコード](cql.elements.md#cql.data-types.JSON)」を参照してください。

`JSON` キーワードを使用すれば、エンコードされた `JSON` マップを 1 行として挿入できます。テーブル内に存在しても、JSON insert ステートメントでは省略されている列については、`DEFAULT UNSET` を使用して既存の値を保持します。`DEFAULT NULL` を使用して、省略された列の各行に NULL 値を書き込み、既存の値をオーバーライドします (標準の書き込み料金が適用されます)。`DEFAULT NULL` はデフォルトのオプションです。

**例**

```
INSERT INTO "myGSGKeyspace".employees_tbl JSON '{"id":"012-34-5678",
                                                 "name": "Russ",
                                                 "project": "NightFlight",
                                                 "region": "US",
                                                 "division": "Engineering",
                                                 "role": "IC",
                                                 "pay_scale": 3,
                                                 "vacation_hrs": 12.5,
                                                 "manager_id": "234-56-7890"}';
```

JSON データに重複するキーが含まれている場合、Amazon Keyspaces ではキーの最後の値が保存されます (Apache Cassandra と同様)。以下の例で、重複キーは `id` であり、値 `234-56-7890` を使用します。

**例**

```
INSERT INTO "myGSGKeyspace".employees_tbl JSON '{"id":"012-34-5678",
                                                 "name": "Russ",
                                                 "project": "NightFlight",
                                                 "region": "US",
                                                 "division": "Engineering",
                                                 "role": "IC",
                                                 "pay_scale": 3,
                                                 "vacation_hrs": 12.5,
                                                 "id": "234-56-7890"}';
```