UPDATE

1つ以上のカラム値を変テーブルの行に変更します。

構文

UPDATE [keyspace_name.]table_name
  [ USING TTL time_value ]
  [ [ AND ] USING TIMESTAMP timestamp_value ]
  SET assignment [ , assignment ... ] 
  WHERE row_specification
  [ IF EXISTS | IF condition [ AND condition ] ] ;

UPDATEは、1つまたは複数のカラム値をテーブル内の1つの行に書き込みます。INSERTと同様、UPDATEはupsert操作です。指定した行が存在しない場合、行はコマンドによって作成されます。同じパーティション・キー内のUPDATEはすべて、アトミックに独立して適用されます。

USING句は、time to live（TTL）値を行に追加することができます。TTLをカウンター・カラムに適用することはできません。

WHERE句は、更新対象の行を指定します。行を指定するには、WHERE句で行のプライマリ・キーの各カラムの値を指定する必要があります。複数の行を指定するには、INキーワードを使用して使用可能な値のリストを指定します。この方法は、プライマリ・キーの最後のカラムに対してのみ行うことができます。

IF EXISTSが含まれている場合を除き、UPDATEコマンドは結果を返しません。

keyspace_name

更新するテーブルが含まれているキースペースの名前。USEコマンドを使用してそのセッションにキースペースが設定されている場合は必要ありません。

table_name

更新するテーブルの名前。

time_value

TTLの値は秒数です。TTLのマークが付いたコマンドのカラム値は、指定の秒数が経過すると、自動的に削除済みのマーク（トゥームストーン）が付きます。TTLはカラム自体ではなく、マークが付いたカラム値に適用されます。カラムのその後の更新で、この値は更新で指定されたTTLにリセットされます。デフォルトでは、値は期限切れになりません。カウンター・カラムのデータのtime_valueを設定することはできません。

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

さらに、time_valueを0に設定することで、カラムのTTLを削除することができます。

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

timestamp_value

TIMESTAMPを使用すると、挿入したカラムにはその値（マイクロ秒単位のタイムスタンプ）のマークが付けられます。TIMESTAMPの値が設定されていない場合は、カラムが更新された時間（マイクロ秒単位）が使用されます。

assignment

既存の要素に値を割り当てます。

以下のいずれかを使用できます。

column_name = column_value [, column_name = column_value] . . . 
| counter_column_name = counter_column_name + | - counter_offset
| list_name = ['list_item' [, 'list_item'] . . . ]
| list_name = list_name + | - ['list_item' [, 'list_item'] . . . ] 
| list_name = ['list_item' [, 'list_item'] . . . ] + list_name  
| map_name = map_name + | - { map_key : map_value [, map_key : map_value . . . }
| map_name[ index ] = map_value
| set_name = set_name + | - { ['set_item'] } 

変数	説明
column_name	更新するカラムの名前。
column_value	指定したカラム名に対して挿入する値。
counter_column_name	更新するカウンター・カラムの名前。
counter_offset	指定したカウンターをインクリメントまたはデクリメントする値（counter_offsetの前に「=」と「-」のどちらが付いているかによって異なります）。
list_name	更新するリストの名前。リストの形式： [list_item , list_item , list_item] 角かっこが使用されていることにご注意ください。
list_item	リストに追加する、またはリストから削除する値。
map_name	更新するマップの名前。マップの形式： { key : value , key: value , key: value . . . } 中かっこ（{ }）が使用されていることにご注意ください。
map_key	マップ・エントリーの最初の用語またはキー。
map_value	マップ・エントリーの2番目の用語または値。
set_name	更新するセットの名前。セットの形式： { set_item , set_item , set_item . . . } 中かっこ（{ }）が使用されていることにご注意ください。
set_item	セットに含めるリテラル値。 注: リストとセットの違い：セット内の各項目は一意である必要があります。

row_specification

WHERE句は、プライマリ・キーで更新する行を特定する必要があります。

• 1行を指定するには、primary_key_name = primary_key_valueを使用します。プライマリ・キーが要素の組み合わせである場合は、この後にAND primary_key_name = primary_key_value ...を追加します。WHERE句は、プライマリ・キーのコンポーネントごとに値を指定する必要があります。
• 複数の行を指定するには、primary_key_name IN ( primary_key_value, primary_key_value … )を使用します。これはプライマリ・キーの最後のコンポーネントにのみ使用できます。

注: 静的カラムを更新するには、パーティション・キーのみを指定する必要があります。

IF EXISTS | IF条件

レコードを更新する前に検証を実行します（軽量トランザクション）。次のように使用します。

• IF EXISTS：1つ以上の行がクエリーと一致している必要があります。一致する行がない場合、この文は失敗します。

  UPDATE cycling.cyclist_name
  SET comment = 'Rides hard, gets along with others, a real winner'
  WHERE id = fb372533-eb95-4bb4-8685-6ef61e994caa 
  IF EXISTS;

  ヒント: IF EXISTSがないUPDATE文に一致する行がない場合は、新しいレコードが作成されます。
• IF conditional_statement：クエリーに一致する行の非プライマリ・キー・カラムをテストします。trueを返した行に更新を適用します。クエリーに一致する行がなく、条件文でNULLをテストする場合は、新しいレコードが挿入されます。

  UPDATE cycling.cyclist_name
  SET comment = 'Rides hard, gets along with others, a real winner'
  WHERE id = fb372533-eb95-4bb4-8685-6ef61e994caa 
  IF comment = NULL;

警告: IF文を使用するとパフォーマンスに影響を及ぼす可能性があります。「linearizable consistency」を参照してください。

たとえば「カラムの条件付き更新」を参照してください。

例

UPDATE cycling.cyclist_name
SET firstname = NULL
WHERE id IN (
  5b6962dd-3f90-4c93-8f61-eabfa4a803e2, fb372533-eb95-4bb4-8685-6ef61e994caa
);

UPDATE cycling.cyclist_name
SET
  firstname = 'Marianne',
  lastname = 'VOS'
WHERE id = 88b8fd18-b1ed-4e96-bf79-4280797cba80;

UPDATE cycling.cyclist_sponsors_expire 
  USING TIMESTAMP 200 AND TTL 20000 
  SET sponsorship += {'Tag Heuer'} 
  WHERE cyclist_name='PRIETO, Marcela';

UPDATE cycling.popular_count 
SET popularity = popularity + 2 
WHERE id = 6ab09bec-e68e-48d9-a5f8-97e6fb4c9b47;