INSERT

既存の行に行全体、またはupsertデータを挿入します。文には完全なPRIMARY KEYを含める必要があります。プライマリ・キーのコンポーネントごとに値が必要ですが、他のカラムの値は必須ではありません。欠落している値はNullに設定されます。IF NOT EXISTSを使用した場合を除き、結果は返されません。

構文

INSERT INTO [keyspace_name.]table_name (column_list) 
VALUES (column_values) 
[IF NOT EXISTS] 
[USING TTL seconds | TIMESTAMP epoch_in_microseconds] 

column_list

カラムのコンマ区切りリスト。PRIMARY KEYフィールドはすべて必須です。Nullはすべての静的カラムに挿入され、これらのカラムは除外されます。

column_values

カラムごとに、対応する値のリストを入力します。column_listと同じ順序を使用します。

リテラルか、コレクションの次の構文を使用してデータを入力します。

• セット：中かっこの中に値を入力します。{ literal [, ...] }.
• リスト：角かっこの中に値を入力します。[literal [, ...]].
• マップ：中かっこの中に値を入力します。{ key : value [, ...] }.

TTL seconds

TTLを秒単位で設定します。TTLの期限が切れると、挿入したデータは自動的に削除済みとマークされます（トゥームストーン付き）。TTL設定は、カラム全体ではなく、挿入したデータにのみ適用されます。それ以降はカラムを更新するたびに、TTLがリセットされます。デフォルトでは、値は期限切れになりません。

テーブルのdefault_time_to_liveプロパティを設定すると、デフォルトのTTLをテーブル全体に設定できます。テーブルTTLで定義されている時間を超えるTTLを特定のカラムに設定しようとすると、DataStax Enterpriseでエラーが返されます。

IF NOT EXISTS

PRIMARY KEY値に一致する行がない場合に、新しいデータ行を挿入します。

TIMESTAMP epoch_in_microseconds

挿入したデータに書き込み時間のTIMESTAMPを付けます。エポック（1970年1月1日）以来の経過時間をマイクロ秒単位で入力します。デフォルトでは、書き込みの実際の時刻が使用されます。

制約事項: INSERTでは、同じ文でIF NOT EXISTSとUSING TIMESTAMPを使用することはできません。

例

INSERT INTO cycling.cyclist_name (id, lastname, firstname)
  VALUES (6ab09bec-e68e-48d9-a5f8-97e6fb4c9b47, 'KRUIKSWIJK','Steven')
  USING TTL 86400 AND TIMESTAMP 123456789;

INSERT INTO cycling.cyclist_categories (id,lastname,categories)
  VALUES(
    '6ab09bec-e68e-48d9-a5f8-97e6fb4c9b47', 
    'KRUIJSWIJK', 
    {'GC', 'Time-trial', 'Sprint'});

INSERT INTO cycling.cyclist_teams (id,lastname,teams)
  VALUES(
    5b6962dd-3f90-4c93-8f61-eabfa4a803e2, 
    'VOS', 
    { 2015 : 'Rabobank-Liv Woman Cycling Team', 
      2014 : 'Rabobank-Liv Woman Cycling Team' });

INSERT INTO cycling.cyclist_name (id, lastname, firstname) 
   VALUES (c4b65263-fe58-4846-83e8-f0e1c13d518f, 'RATTO', 'Rissella') 
IF NOT EXISTS; 

 [applied]
-----------
      True

 [applied] | id                                   | firstname | lastname
-----------+--------------------------------------+-----------+----------
     False | c4b65263-fe58-4846-83e8-f0e1c13d518f |  Rissella |    RATTO