FarelDB 第7章 第12讲 键值对命令 键操作类(key) 之 RANDOMKEY

FarelDB 键值对命令 键操作类(key) 之 RANDOMKEY

RANDOMKEY 命令从当前kv数据表中随机返回一个 key 。

语法

FarelDB 127.0.0.1：6800 > RANDOMKEY 

返回值

当kv数据表不为空时，返回一个 key 。 当kv数据表为空时，返回 nil 。

命令实例

打开一个命令行窗口，启动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数据表是“系统默认kv数据表” 在默认kv数据表中创建5个key
FarelDb 127.0.0.1:6800 > mset key1 a key2 b key3 c key4 d key5 e

# 4. 在当前使用的kv数据表中（系统默认kv数据表 inner_table_kv）查询有哪些key存在
FarelDb 127.0.0.1:6800 > keys *
1) key1
2) key2
3) key3
4) key4
5) key5
(0 ms)

# 5. 从当前kv数据表（系统默认kv数据表 inner_table_kv）中随机返回一个 key
FarelDb 127.0.0.1:6800 > randomkey
"key5"
(0 ms)

# 6.创建一个新的kv数据表 new_kv_table 
FarelDb 127.0.0.1:6800 > kv create table new_kv_table                      
success
(0 ms)

# 7.切换使用当前kv数据表为：新创建的kv数据表 new_kv_table 
FarelDb 127.0.0.1:6800 > kv use table new_kv_table               
success
(0 ms)

# 8. 在当前使用的kv数据表中（new_kv_table）查询有哪些key存在
FarelDb 127.0.0.1:6800 > keys *
(empty)
(0 ms)

# 9. 从当前kv数据表（new_kv_table）中随机返回一个 key
FarelDb 127.0.0.1:6800 > randomkey
"nil"
(0 ms)
 

---

API 说明

函数原型

FarelDbKvRes* queryKv(std::string Command)

输入参数说明

输入参数	描述	可选
Command	RANDOMKEY 语法字符串	否

返回参数说明

调用成功返回

返回参数	值	含义
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 key1 \\\"value1\\\"  key2 \\\"value2\\\" key3 \\\"value3\\\"";//命令需要使用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"RANDOMKEY";//命令需要使用utf8字符串

	//执行命令
	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_STRING == res->getType()) // RANDOMKE 返回数据存储在子类(FARELDB_KV_RES_STRING)中
	{
		// 父类智能指针转子类智能指针，通过子类获取命令返回数据集 
		std::shared_ptr<FarelDbKvResString> resData(std::dynamic_pointer_cast<FarelDbKvResString>(res));
		printf(" 随机返回的key为：%s \n", resData->val.c_str());
	}
	else
	{
		printf("正确返回类型为：%d, 调用返回类型不匹配，返回类型错误：%d \n", FARELDB_KV_RES_STRING, res->getType());
	}
}

补充说明

无