FarelDB 键值对命令 键操作类(key) 之 MOVE KEY_NAME DESTINATION_KV_TABLE
MOVE 命令用于将当前KV数据表中的 key 移动到给定的目标KV数据表当中。
语法
FarelDB 127.0.0.1:6800 > MOVE KEY_NAME DESTINATION_KV_TABLE
返回值
移动成功返回 1 ,失败则返回 0 。
命令实例
打开一个命令行窗口,启动FarelDB服务端,再打开一个命令行窗口,启动FarelDB客户端,输入以下命令:
# 1.查询当前kv数据表有哪些 # 2.查询到当前只有系统默认kv数据表(inner_table_kv)
FarelDb 127.0.0.1:6800 > select name from inner_db_sys.inner_table_kv_tables
name
inner_table_kv
# 3.创建一个新的kv数据表 new_kv_table
FarelDb 127.0.0.1:6800 > kv create table new_kv_table
success
(0 ms)
# 4.查询当前kv数据表有哪些 # 5.查询到当前有系统默认kv数据表inner_table_kv和新创建的kv数据表 new_kv_table
FarelDb 127.0.0.1:6800 > select name from inner_db_sys.inner_table_kv_tables
name
inner_table_kv
new_kv_table
# 6.切换使用当前kv数据表为:系统默认kv数据表
FarelDb 127.0.0.1:6800 > kv use table inner_table_kv
success
(0 ms)
# 7.在当前使用的kv数据表中(系统默认kv数据表)创建一个key
FarelDb 127.0.0.1:6800 > set moveKey "create key in inner_table_kv"
success
(0 ms)
# 8.在当前使用的kv数据表中(系统默认kv数据表)查询key是否存在
FarelDb 127.0.0.1:6800 > exists moveKey
1 # 9.存在
(0 ms)
# 10.切换使用当前kv数据表为:新创建的kv数据表 new_kv_table
FarelDb 127.0.0.1:6800 > kv use table new_kv_table
success
(0 ms)
# 11.在当前使用的kv数据表(新创建的kv数据表 new_kv_table )中查询key是否存在
FarelDb 127.0.0.1:6800 > exists moveKey
0 # 12.不存在,新创建的kv数据表,还没有key
(0 ms)
# 13.切换使用当前kv数据表为:系统默认kv数据表
FarelDb 127.0.0.1:6800 > kv use table inner_table_kv
success
(0 ms)
# 14.将当前使用的kv数据表(系统默认kv数据表)中的key移动到新创建的kv数据表 new_kv_table中
FarelDb 127.0.0.1:6800 > move moveKey new_kv_table
1
(0 ms)
# 15.在当前使用的kv数据表中(系统默认kv数据表)查询key是否存在
FarelDb 127.0.0.1:6800 > exists moveKey
0 # 16.moveKey移动走了,key不存在了
(0 ms)
# 17.切换使用当前kv数据表为:新创建的kv数据表 new_kv_table
FarelDb 127.0.0.1:6800 > kv use table new_kv_table
success
(0 ms)
# 18.在当前使用的kv数据表(新创建的kv数据表 new_kv_table )中查询key是否存在
FarelDb 127.0.0.1:6800 > exists moveKey
1 # 19.moveKey移动过来了,key存在了
(0 ms)
API 说明
函数原型
FarelDbKvRes* queryKv(std::string Command)
输入参数说明
输入参数 | 描述 | 可选 |
---|---|---|
Command | MOVE KEY_NAME DESTINATION_KV_TABLE 语法字符串 | 否 |
返回参数说明
调用成功返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbKvRes->errorInfos.size() | 0 | 调用成功,无错误信息 |
调用异常返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbKvRes->errorInfos.size() | 大于0 | 调用失败,errorInfos对象数组包含1个或多个错误信息 |
FarelDbKvRes->errorInfos[0]->resCode | 大于0的数值 | 调用失败,返回错误代码 |
FarelDbKvRes->errorInfos[0]->resInfo | 非空字符串 | 调用失败,返回错误信息字符串 |
返回数据获取方法
FarelDbKvRes* queryKv(std::string stringCommand)接口调用成功后,接口将不同种类命令需要返回的不同种类数据集存储在FarelDbKvRes的众多不同子类对象中返回给调用者,调用者可以根据不同的命令类型将接口返回的父类FarelDbKvRes指针转换成具体存储返回数据集的子类对象指针来取得数据集,具体获取方法,请参考下面的样例代码。
时间复杂度
O(logN)
样例代码
#include <iostream>
#include <functional>
#include <memory>
#include "fareldb_connection.h"
using namespace std;
using namespace fareldb_connection;
int main(int argc,char *argv[])
{
//创建连接
FarelDbConnection conn;
//连接
tuple<int, string> resConn = conn.connect("127.0.0.1", 6800, "root", "root");
//连接失败
if (0 != get<0>(resConn))
{
printf("连接失败,错误代码:%d : 错误信息:%s\n", get<0>(resConn), get<1>(resConn).c_str());
return;
}
//SET key value (设置指定 key 的值)
string kvCommand = u8"set myKey somevalue";//命令需要使用utf8字符串
//执行增加一个新的KV的命令
std::shared_ptr<FarelDbKvRes> res(conn.queryKv(kvCommand));
//判断执行命令返回是否失败
if (res->errorInfos.size() > 0)
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
//kv create table a (创建一个新的kv数据表)
kvCommand = u8"kv create table if not exists b";//命令需要使用utf8字符串
//执行创建表1的命令
res = std::shared_ptr<FarelDbKvRes>(conn.queryKv(kvCommand));
if (res->errorInfos.size() > 0)
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
//挪动键值到另一个表中
kvCommand = u8"move myKey b";//命令需要使用utf8字符串
//执行挪动键值到另一个kev数据表中的命令
res = std::shared_ptr<FarelDbKvRes>(conn.queryKv(kvCommand));
//判断执行命令返回是否失败
if (res->errorInfos.size() > 0)
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
//调用成功,不同命令返回不同类型数据集,不同的数据集分类存储在不同子类之中
if (FARELDB_KV_RES_ULONG == res->getType()) // MOVE_key_table 返回数据存储在子类(FARELDB_KV_RES_ULONG)中
{
// 父类智能指针转子类智能指针,通过子类获取命令返回数据集
std::shared_ptr<FarelDbKvResUlong> resData(std::dynamic_pointer_cast<FarelDbKvResUlong>(res));
string rtn = (1 == resData->val) ? "成功" : "失败";
printf("移动key到给定的kv数据表 %s\n", rtn.c_str());
}
else
{
printf("正确返回类型为:%d, 调用返回类型不匹配,返回类型错误:%d \n", FARELDB_KV_RES_ULONG, res->getType());
}
}
补充说明
无