[TcaplusDB知識庫]TcaplusDB客戶端及常用命令

TcaplusDB君發表於2021-05-29

資料庫大都支援命令列訪問,TcaplusDB也不例外,通過安裝TcaplusDB客戶端,您可以方便快捷地從命令列管理與訪問資料庫。

TcaplusDB客戶端

首先在 TcaplusServiceApi3.36下載最新的TcaplusDB API 3.36程式包並解壓該檔案,該步驟應在安裝TcaplusDB應用程式的同一VPC中的CVM上執行所有操作。安裝客戶端命令如下:

# 解壓TcaplusDB API包
tar -zxvf TcaplusServiceApi3.36.0.192960.x86_64_release_20200115.tar.gz

# 重新命名TcaplusDB目錄
mv TcaplusServiceApi3.36.0.192960.x86_64_release_20200115 TcaplusDBServiceApi3.0

# 找到TcaplusDB客戶端
cd TcaplusDBServiceApi3.0/release/x86_64/bin

# 連線TcaplusDB應用
./tcaplus_client -a {APP ID} -z {ZONE ID} -s {TcaplusDB PASSWORD} -d {Tcapdir IP}:{Tcapdir PORT}

# 例子:
 ./tcaplus_client -a 21 -z 1 -s "Changeme12" -d 10.0.0.2:9999

上述命令中TcaplusDB_client連線引數獲取方式如下:

1) 在騰訊雲開啟表控制檯,進入叢集列表頁面, 從頁面獲取Tcapdir IP(對應: Private Address/內網地址), Tcapdir PORT(對應:Private Port/內網埠),獲取Zone ID (對應頁面 : Table Group ID/表格組ID) 。

img

2) 點選上述截圖的叢集ID,進入應用詳情頁面, 獲取 APP ID(對應: Access ID/接入ID), 以及TcaplusDB password(對應:Connection Password/連線密碼)。 具體截圖如下所示:

img

TcaplusDB客戶端命令

TcaplusDB提供了一種類似SQL的查詢語言,使您能像使用關聯式資料庫一樣操作TcaplusDB表。

命令含義 
desc {table name} 描述表欄位  
count {table_name} 返回表記錄數目  
clean {table_name} 清空(truncate)表, 此操作高度敏感,需要開白使用  
select 查詢表記錄,示例: select * from BattleInfo where game_id = 100 and area_id=200 \G; \G標記符類似MySQL命令列格式化查詢輸出  
update 更新表記錄,若該記錄不存在,則會插入該條記錄,示例: update BattleInfo set player_number = 10 where game_id = 100 and area_id=200;  
delete 刪除1條或多條記錄,where語句需指定全部主鍵欄位或索引欄位。示例: delete from BattleInfo where game_id = 100 and area_id=200;  
dump 遍歷表並將資料匯出到文字檔案,示例:dump * from BattleInfo into BattleInfo.csv;  
load 從文字檔案匯入資料到表,示例:load BattleInfo from BattleInfo.csv;  

注意: 使用tcaplus_client在操作PB型別(protobuf)的表時有一些限制,如下所示:

  • load: 不支援, 預計Q2支援;

  • select:部分不支援,預計Q2支援,如下:

    • 基於索引欄位作為where查詢條件暫不支援;
    • select *不支援顯示巢狀欄位的值, 需要用點分模式指定巢狀欄位才行如select pay.amount from …;
    • update: 部分不支援,對於repeated型別的欄位無法用update 更新插入;
  • insert: 暫不支援, 可用update替代,預計Q2支援。

您可以通過執行help或help +命令獲得更多的TcaplusDB語法。 請注意,上表中未列出的命令正在逐步淘汰或不建議使用。

tcaplus_client命令支援詳情:

img

tcaplus_client命令幫助示例:

img


TcaplusDB是騰訊出品的分散式NoSQL資料庫,儲存和排程的程式碼完全自研。具備快取+落地融合架構、PB級儲存、毫秒級時延、無損水平擴充套件和複雜資料結構等特性。同時具備豐富的生態、便捷的遷移、極低的運維成本和五個九高可用等特點。客戶覆蓋遊戲、網際網路、政務、金融、製造和物聯網等領域。

相關文章