通過命令列工具您可以在資料表中插入新資料、更新一行資料、讀取資料、刪除一行資料、掃描資料以及匯入匯出資料。
插入新資料
在表中插入新資料。您也可以通過匯入JSON格式的設定檔來插入新資料到表中。
- 命令格式
put --pk '[primaryKeyValue, primaryKeyValue]' --attr '[{"c":"attributeColumnName", "v":"attributeColumnValue"}, {"c":"attributeColumnName", "v":"attributeColumnValue", "ts":timestamp}]' --condition condition配置項說明請參見下表。
參數 是否必填 樣本值 說明 -p，--pk 是 ["86", 6771] 資料表主鍵的值，以數組表示。 重要- 設定的主鍵個數和類型必須和資料表的主鍵個數和類型一致。
- 當主鍵為自增列時，只需將自增列的值設定為預留位置null。
--attr 是 [{"c":"name", "v":"redchen"}, {"c":"country", "v":"china", "t":"string", "ts":1626860469000}] 資料表屬性列，以JSON格式的數組表示。每個屬性列包含如下欄位： - c（必選）：屬性列名稱。
- v（必選）：屬性列的值。
- t（可選）：屬性列類型，取值範圍為integer、string（UTF-8編碼字串）、binary、boolean、double五種。當屬性列類型為binary時必須設定此欄位不可省略。
- ts（可選）：時間戳記即資料的版本號碼，可以由系統自動產生或者自訂，如果不設定此參數，則預設由系統自動產生。更多資訊，請參見資料版本和生命週期。
--condition 否 ignore 使用條件更新，可以設定原行的存在性條件。取值範圍如下： - ignore（預設）：表示無論此行是否存在均會插入新資料，如果之前行已存在，則寫入資料時會覆蓋原有資料。
- exist：表示只有此行存在時才會插入新資料，寫入資料時會覆蓋原有資料。
- not_exist：表示只有此行不存在時才會插入資料。
關於條件更新的更多資訊，請參見條件更新。
-i, --input 否 /temp/inputdata.json 通過JSON格式的設定檔插入資料。 您也可以通過設定檔插入資料，命令格式如下：- Windows平台
put -i D:\\localpath\\filename.json - Linux和Mac平台
put -i /localpath/filename.json
設定檔的樣本如下：{ "PK":{ "Values":[ "86", 6771 ] }, "Attr":{ "Values":[ { "C":"age", "V":32, "TS":1626860801604, "IsInt":true } ] } } - 樣本
在資料表中插入一行資料。該行的第一主鍵列值為“86”，第二主鍵列值為6771，屬性列有name（string類型）和country（string類型）兩列。
put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'在資料表中插入一行資料，該行的第一主鍵列值為“86”，第二主鍵列值為6771，屬性列有name（string類型）和country（string類型）兩列。無論此行是否存在均會插入新資料，如果之前行已存在，則寫入資料時會覆蓋原有資料。put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition ignore在資料表中插入一行資料，該行的第一主鍵列值為“86”，第二主鍵列值為6771，屬性列有name（string類型）和country（string類型）兩列，並且country列的時間戳記為15327798534。put --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china", "t":"string", "ts":15327798534}]'當資料表中第二主鍵列為自增列時，在資料表中插入一行資料。該行的第一主鍵列值為“86”，第二主鍵列值為null，屬性列有name（string類型）和country（string類型）兩列。put --pk '["86", null]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'
讀取資料
讀取表中的資料。您也可以將讀取的資料匯出到本地JSON格式的檔案中。
说明 如果讀取的資料行不存在，則返回結果為空白。
- 命令格式
get --pk '[primaryKeyValue,primaryKeyValue]'配置項說明請參見下表。
配置項 是否必填 樣本值 說明 -p，--pk 是 ["86",6771] 資料表主鍵的值，以數組表示。 重要 設定的主鍵個數和類型必須和資料表的主鍵個數和類型一致。--columns 否 name,uid 讀取的列集合，列名可以是主鍵列或屬性列。如果不設定返回的列名，則返回整行資料。 --max_version 否 1 最多讀取的版本數。 --time_range_start 否 1626860469000 讀取版本號碼範圍內的資料。time_range_start和time_range_end分別表示起始時間戳記和結束時間戳記，範圍為左閉右開區間。 --time_range_end 否 1626865270000 --time_range_specific 否 1626862870000 讀取特定版本號碼的資料。 -o, --output 否 /tmp/querydata.json 輸出查詢結果到本地JSON格式的檔案中。 - 樣本
讀取第一主鍵列值為“86”，第二主鍵列值為6771的行資料。
get --pk '["86",6771]'
更新一行資料
更新表中的資料。您也可以通過匯入JSON格式的設定檔來更新表中資料。
- 命令格式
update --pk '[primaryKeyValue, primaryKeyValue]' --attr '[{"c":"attributeColumnName", "v":"attributeColumnValue"}, {"c":"attributeColumnName", "v":"attributeColumnValue", "ts":timestamp}]' --condition condition配置項說明請參見下表。參數 是否必填 樣本值 說明 -p，--pk 是 ["86", 6771] 資料表主鍵的值，以數組表示。 重要 設定的主鍵個數和類型必須和資料表的主鍵個數和類型一致。--attr 是 [{"c":"name", "v":"redchen"}, {"c":"country", "v":"china", "ts":15327798534}] 資料表屬性列，以JSON格式的數組表示。每個屬性列包含如下欄位： - c（必選）：屬性列名稱。
- v（必選）：屬性列的值。
- t（可選）：屬性列類型，取值範圍為是integer、string（UTF-8編碼字串）、binary、boolean、double五種。當屬性列類型為binary時必須設定此欄位不可省略。
- ts（可選）：時間戳記即資料的版本號碼，可以由系統自動產生或者自訂，如果不設定此參數，則預設由系統自動產生。
--condition 否 ignore 使用條件更新，可以設定原行的存在性條件。取值範圍如下： - ignore（預設）：表示無論此行是否存在均會插入新資料，如果之前行已存在，則寫入資料時會覆蓋原有資料。
- exist：表示只有此行存在時才會插入新資料，寫入資料時會覆蓋原有資料。
- not_exist：表示只有此行不存在時才會插入資料。
關於條件更新的更多資訊，請參見條件更新。
-i, --input 否 /tmp/inputdata.json 通過JSON格式的設定檔更新資料。 您也可以通過設定檔更新資料，命令格式如下：- Windows平台
update -i D:\\localpath\\filename.json - Linux和Mac平台
update -i /localpath/filename.json
設定檔的樣本如下：{ "PK":{ "Values":[ "86", 6771 ] }, "Attr":{ "Values":[ { "C":"age", "V":32, "TS":1626860801604, "IsInt":true } ] } } - 樣本
更新第一主鍵列為“86”，第二主鍵列為6771的行資料。無論此行是否存在均會插入新資料，如果之前行已存在，則寫入資料時會覆蓋原有資料。
update --pk '["86", 6771]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]' --condition ignore
刪除一行資料
根據主鍵刪除一行資料。
- 命令格式
delete --pk '[primaryKeyValue,primaryKeyValue]' - 樣本
刪除第一主鍵列值為“86”，第二主鍵列值為6771的行資料。
delete --pk '["86", 6771]'
掃描資料
掃描擷取整表中所有資料或者擷取最多指定個數的行資料。
- 命令格式
scan --limit limit配置項說明請見下表。配置項 是否必填 樣本值 說明 --limit 否 10 本次掃描返回的最大行數，可不配置。如果不設定此項，則表示掃描整表中所有資料。 - 樣本
掃描擷取資料表中的最多10行資料。
scan --limit 10
匯出資料
匯出表中資料到本地JSON檔案中。
- 命令格式
scan -o /localpath/filename.json -c attributeColumnName,attributeColumnName,attributeColumnName配置項說明請參見下表。
配置項 是否必填 樣本值 說明 -c, --columns 是 uid,name 匯出的列集合，列名可以是主鍵列或屬性列。如果不設定列名，則匯出整行資料。 --max_version 否 1 最多匯出的版本數。 --time_range_start 否 1626865596000 匯出版本號碼範圍內的資料。time_range_start和time_range_end分別表示起始時間戳記和結束時間戳記，範圍為前閉後開區間。 --time_range_end 否 1626869196000 --time_range_specific 否 1626867396000 匯出特定版本號碼的資料。 --backward 否 不涉及 匯出資料按照主鍵降序排列。 -o, --output 是 /tmp/mydata.json 輸出查詢結果到本地指定路徑的JSON格式檔案中。 -l，--limit 否 10 本次查詢最多返回的行數。 -b，--begin 否 1000 匯出範圍起始點和結束點之間的資料。 -e，--end 否 2000 - 樣本
匯出當前表中全部資料到本地檔案mydata.json。
scan -o /tmp/mydata.json匯出當前表中uid和name列的資料到本地檔案mydata.json。scan -o /tmp/mydata.json -c uid,name
匯入資料
匯入本地JSON檔案中的資料到表中。
- 命令格式
import -i /localpath/filename.json --ignore_version配置項說明請參見下表。
配置項 是否必填 樣本值 說明 -a，--action 否 put 匯入資料的模式。取值範圍如下： - put（預設）：如果某行資料已存在，則先刪除原行資料（原行的所有列以及所有版本的資料），再寫入新行資料。
- update：如果某行資料已存在，可以增加和刪除一行中的屬性列，刪除屬性列指定版本的資料，或者更新已存在的屬性列的值。如果某行資料不存在，則新增一行資料。
-i, --input 是 /tmp/inputdata.json 通過JSON格式的本地檔案匯入資料到當前表。 --ignore_version 否 不涉及 忽略時間戳記檢查，使用目前時間作為時間戳記。 本地檔案的配置樣本如下：{"PK":{"Values":["redchen",0]},"Attr":{"Values":[{"C":"country","V":"china0"},{"C":"name","V":"redchen0"}]}} {"PK":{"Values":["redchen",1]},"Attr":{"Values":[{"C":"country","V":"china1"},{"C":"name","V":"redchen1"}]}} - 樣本
匯入mydata.json檔案的資料到當前表。
import -i /tmp/mydata.json匯入mydata.json檔案的資料到當前表，且使用目前時間作為時間戳記。import -i /tmp/mydata.json --ignore_version