批量寫入資料 - Tablestore

調用BulkImport介面批量寫入資料。寫入資料時支援插入一行資料、修改行資料以及刪除行資料。

請求訊息結構

message BulkImportRequest {
    required string table_name = 1;
    repeated RowInBulkImportRequest rows = 2;
}

參數	類型	是否必選	描述
table_name	string	是	資料表名稱。
rows	repeated RowInBulkImportRequest	是	要操作的資料行。

message BulkImportResponse {
    required string table_name = 1;
    repeated RowInBulkImportResponse rows = 2;
}

參數	類型	是否必選	描述
table_name	string	是	資料表名稱。
rows	repeated RowInBulkImportResponse	是	是否成功匯入、出錯資訊以及消耗的CU。

如果本次操作整體失敗，則不消耗任何服務能力單元。
如果請求逾時，結果未定義，則服務能力單元有可能被消耗，也可能未被消耗。
如果返回內部錯誤（HTTP狀態代碼：5xx），則此次操作不消耗服務能力單元，其他錯誤情況消耗1寫服務能力單元。
其他情況將每個RowInBulkImportRequest視作相對應的寫操作獨立計算讀寫服務能力單元。RowInBulkImportRequest中會包括插入、更新和刪除行的操作。
- 當插入一行資料時，消耗的寫服務能力單元為本行的主鍵資料大小與要插入屬性列資料大小之和除以4 KB向上取整。
- 當更新一行資料時，消耗的寫服務能力單元為本行的主鍵資料大小與要更新的屬性列資料大小之和除以4 KB向上取整。如果更新操作中包含有需要刪除的屬性列，只有其列名長度計入該屬性列資料大小。
- 當刪除一行資料時，消耗的寫服務能力單元為本行主鍵資料大小除以4 KB向上取整。
關於資料大小計算的更多資訊，請參見資料存放區量。