BulkExport
調(diào)用BulkExport接口批量導(dǎo)出數(shù)據(jù)。
請(qǐng)求消息結(jié)構(gòu)
message BulkExportRequest {
required string table_name = 1;
repeated string columns_to_get = 2;
required bytes inclusive_start_primary_key = 3;
required bytes exclusive_end_primary_key = 4;
optional bytes filter = 5;
optional DataBlockType data_block_type_hint = 6 [default = DBT_SIMPLE_ROW_MATRIX];
}
參數(shù) | 類型 | 是否必選 | 描述 |
table_name | string | 是 | 數(shù)據(jù)表名稱。 |
columns_to_get | string | 否 | 要返回的列。如果不設(shè)置要返回的列,則返回所有列。 |
inclusive_start_primary_key | bytes | 是 | 起始主鍵,由Plainbuffer編碼,詳見Plainbuffer編碼。 如果該行存在,則返回結(jié)果中會(huì)包括該行。 |
exclusive_end_primary_key | bytes | 是 | 結(jié)束主鍵,由Plainbuffer編碼,詳見Plainbuffer編碼。 如果該行存在,則返回結(jié)果也不會(huì)包括該行。 |
filter | bytes | 否 | 過濾條件,由Plainbuffer編碼,詳見Plainbuffer編碼。 |
data_block_type_hint | 否 | 返回結(jié)果的數(shù)據(jù)塊類型。 |
響應(yīng)消息結(jié)構(gòu)
message BulkExportResponse {
required ConsumedCapacity consumed = 1;
required bytes rows = 2;
optional bytes next_start_primary_key = 3;
optional DataBlockType data_block_type = 4;
}
參數(shù) | 類型 | 是否必選 | 描述 |
consumed | 是 | 本次操作消耗的服務(wù)能力單元。更多信息,請(qǐng)參見服務(wù)能力單元消耗。 | |
rows | bytes | 是 | 獲取到的行數(shù)據(jù),包括主鍵和屬性列,由Plainbuffer編碼,詳見Plainbuffer編碼。 |
next_start_primary_key | bytes | 否 | 下一次讀取的起始主鍵,由Plainbuffer編碼,詳見Plainbuffer編碼。 如果返回值為空,則表示已讀取全部數(shù)據(jù)。 |
data_block_type | 否 | 返回結(jié)果的數(shù)據(jù)塊類型。 |
使用SDK
服務(wù)能力單元消耗
如果請(qǐng)求的行不存在,則消耗1讀CU(讀服務(wù)能力單元)。
如果請(qǐng)求的行存在,則消耗的讀服務(wù)能力單元為指定行所有主鍵列數(shù)據(jù)大小與實(shí)際讀取的屬性列數(shù)據(jù)大小之和除以4 KB向上取整。關(guān)于數(shù)據(jù)大小計(jì)算的更多信息,請(qǐng)參見數(shù)據(jù)存儲(chǔ)量。
如果請(qǐng)求超時(shí),結(jié)果未定義,則服務(wù)能力單元有可能被消耗,也可能未被消耗。
如果返回內(nèi)部錯(cuò)誤(HTTP狀態(tài)碼:5XX),則此次操作不消耗服務(wù)能力單元,其他錯(cuò)誤情況消耗1讀服務(wù)能力單元。