複数行のデータを同時に書き込む - Tablestore - Alibaba Cloud ドキュメントセンター

複数行のデータを同時に書き込みます。この操作を呼び出して、データ行の挿入、変更、または削除を行うことができます。

リクエスト構文

message BulkImportRequest {
    // データテーブルの名前。
    required string table_name = 1;
    // 管理するデータの行。
    repeated RowInBulkImportRequest rows = 2;
}

パラメーター	タイプ	必須	説明
table_name	string	はい	データテーブルの名前。
rows	repeated RowInBulkImportRequest	はい	管理するデータの行。

レスポンス構文

message BulkImportResponse {
    // データテーブルの名前。
    required string table_name = 1;
    // 書き込み操作が成功したかどうか、エラーメッセージ、および消費された容量ユニット (CU) を示します。詳細については、「読み取りおよび書き込みスループット」を参照してください。
    repeated RowInBulkImportResponse rows = 2;
}

パラメーター	タイプ	必須	説明
table_name	string	はい	データテーブルの名前。
rows	repeated RowInBulkImportResponse	はい	書き込み操作が成功したかどうか、エラーメッセージ、および消費された容量ユニット (CU) を示します。詳細については、読み取りおよび書き込みスループットを参照してください。

Tablestore SDK の使用

Java 用 Tablestore SDK: オフラインでデータをバッチ書き込みする

CU 消費量

操作が失敗した場合、CU は消費されません。
リクエストがタイムアウトし、結果が未定義の場合、CU が消費される場合とされない場合があります。
内部エラーが発生し、HTTP ステータスコード 5xx が返された場合、操作は CU を消費しません。その他のエラーが発生した場合、1 CU が消費されます。
その他の場合、RowInBulkImportRequest は挿入、更新、および削除操作を指定し、消費される CU は実行される操作に基づいて個別に計算されます。次の内容は、データ行に対して挿入、更新、および削除操作を実行することで消費される CU の計算方法について説明しています。
- データ行を挿入する場合、消費される書き込み CU の数は、次の式に基づいて計算された値から切り上げられます。(行のすべてのプライマリキー列のデータサイズ + 挿入された属性列のデータサイズ)/4 KB。
- データ行を更新する場合、消費される書き込み CU の数は、次の式に基づいて計算された値から切り上げられます。(行のすべてのプライマリキー列のデータサイズ + 更新された属性列のデータサイズ)/4 KB。データ行を更新するときに属性列を削除する場合、列名の長さのみが属性列のデータサイズに含まれます。
- データ行を削除する場合、消費される書き込み CU の数は、次の式に基づいて計算された値から切り上げられます。行のすべてのプライマリキー列のデータサイズ/4 KB。
データサイズの計算方法の詳細については、ストレージ使用量を参照してください。