INSERT

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

構文

INSERT [ JSON ] INTO [keyspace_name.]table_name
  [ column_list VALUES column_values ] 
  [ IF NOT EXISTS ] 
  [ USING [ TTL seconds ] [ [ AND ] TIMESTAMP epoch_in_microseconds ] ] ;

column_list

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

column_values

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

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

• セット：中かっこの中に値を入力します。 { literal [, ...] }という同等のHOCON構文でフォーマットされています。
• リスト：角かっこの中に値を入力します。[literal [, ...]].
• Map: 中かっこの中に値を入力します。 { key : value [, ...] }という同等のHOCON構文でフォーマットされています。

TTL seconds

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

テーブルのdefault_time_to_liveプロパティを設定すると、デフォルトのTTLをテーブル全体に設定できます。INSERTまたはUPDATEコマンドを使用してカラムにTTLを設定すると、テーブルTTLはオーバーライドされます。

警告: 2038年問題のため、データベース・ストレージ・エンジンでは、January 19 2038 03:14:07 UTCのみをエンコードできます。TTL日付オーバーフローポリシーによって、有効期限が最長の日付よりも後のタイムスタンプの要求を拒否するか、受け入れるかどうかが決定します。-Dcassandra.expiration_date_overflow_policyを参照してください。

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_sponsors_expire (cyclist_name, sponsorship) 
  VALUES ('PRIETO, Marcela',  {'Castrelli', 'Alfa Romeo'}) 
  USING TIMESTAMP 100 AND TTL 10000;

INSERT INTO cycling.cyclist_career_teams (
  id,lastname,teams
 ) VALUES (
  5b6962dd-3f90-4c93-8f61-eabfa4a803e2, 
  'VOS', 
  { 'Rabobank-Liv Woman Cycling Team','Rabobank-Liv Giant','Rabobank Women Team','Nederland bloeit' }
 );

INSERT INTO cycling.cyclist_teams (
  id,firstname,lastname,teams
) VALUES (
  5b6962dd-3f90-4c93-8f61-eabfa4a803e2, 
  'Marianne',
  '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