FarelDB 键值对命令 键操作类(key) 之 RENAME OLD_KEY_NAME NEW_KEY_NAME
Rename 命令用于修改 key 的名称 。
语法
FarelDB 127.0.0.1:6800 > RENAME OLD_KEY_NAME NEW_KEY_NAME
返回值
改名成功时提示 OK ,失败时候返回一个错误。
当 OLD_KEY_NAME 和 NEW_KEY_NAME 相同,或者 OLD_KEY_NAME 不存在时,返回一个错误。 当 NEW_KEY_NAME 已经存在时, RENAME 命令将覆盖旧值。
命令实例
打开一个命令行窗口,启动FarelDB服务端,再打开一个命令行窗口,启动FarelDB客户端,输入以下命令:
FarelDb 127.0.0.1:6800 > del oldName
1
(0 ms)
# 1. 当 需要修改的 key 不存在时,返回错误
FarelDb 127.0.0.1:6800 > rename oldName newName
error(2000): the specified key does not exist: key(oldName)
# 2. 当 需要需改的key 存在 且 修改名字后的key 不存在
FarelDb 127.0.0.1:6800 > set oldName "Leo"
success
(0 ms)
FarelDb 127.0.0.1:6800 > del newName
0
(0 ms)
FarelDb 127.0.0.1:6800 > rename oldName newName
success
(0 ms)
FarelDb 127.0.0.1:6800 > exists oldName #修改后,老名字key不复存在
0
(1 ms)
FarelDb 127.0.0.1:6800 > get newName #修改后,新名字key的值存储为老名字key的值
"Leo"
(0 ms)
# 3. 新名字key值存在,rename后会被覆盖
FarelDb 127.0.0.1:6800 > set oldName "Leo"
success
(0 ms)
FarelDb 127.0.0.1:6800 > set newName "Bob"
success
(0 ms)
FarelDb 127.0.0.1:6800 > rename oldName newName
success
(0 ms)
FarelDb 127.0.0.1:6800 > get newName
"Leo"
(0 ms)
API 说明
函数原型
FarelDbKvRes* queryKv(std::string Command)
输入参数说明
输入参数 | 描述 | 可选 |
---|---|---|
Command | RENAME OLD_KEY_NAME NEW_KEY_NAME 语法字符串 | 否 |
返回参数说明
调用成功返回
返回参数 | 值 | 含义 |
---|---|---|
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"mset oldKey Hello newKey World";//命令需要使用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;
}
//修改 key 的名称
kvCommand = u8"RENAME oldKey newKey";//命令需要使用utf8字符串
//执行命令
res = std::shared_ptr<FarelDbKvRes>(conn.queryKv(kvCommand));
//判断执行命令返回是否失败
//判断执行命令返回是否失败
if (res->errorInfos.size() == 0)
{
printf("修改 key 的名称成功");
}
else
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
}
补充说明
无