第1章 第3讲 FarelDB 键值对数据库命令 键值对存储表操作类(Kv Table) 之 kv drop table

FarelDB 键值对数据库命令 键值对存储表操作类(Kv Table) 之 kv drop table

   系统创建后会默认创建一个内置键值对表(inner_table_kv)用户对key-value键值对的操作数据都默认存储在该数据库中。系统默认创建的内置键值对存储表(inner_table_kv)是不允许删除的。但FarelDB允许用户创建和删除自己命名的用户键值对存储表,本章节将介绍如何删除用户创建的键值对操作表。

语法

kv drop table <键值对存储表>

返回值

成功返回success ,失败则返回 错误原因 。

命令实例

打开一个命令行窗口,启动FarelDB服务端,再打开一个命令行窗口,启动FarelDB客户端,输入以下命令:

//1. 创建myKvTable键值对存储表
FarelDb 192.168.56.1:6800 > kv create table myKvTable
success, affected count: 1

//2. 系统中存在myKvTable,删除已经存在myKvTable键值对存储表,调用成功
FarelDb 192.168.56.1:6800 > kv drop table myKvTable
success, affected count: 1

//3. 系统中 不存在myKvTable键值对存储表 ,则删除失败 
FarelDb 192.168.56.1:6800 > kv drop table myKvTable 
error(1130): the specified database object is not exist: myKvTable

//4. 系统中 不存在myKvTable键值对存储表 ,删除时增加 if exists选项,调用成功,系统不操作任何键值对存储表 
FarelDb 192.168.56.1:6800 > kv drop table if exists myKvTable
success, affected count: 0


API 说明

函数原型

FarelDbKvRes* queryKv(std::string stringCommand)

输入参数说明:

输入参数描述可选
stringCommand符合语法的命令字符串

返回参数说明:

调用成功返回

返回参数含义
FarelDbKvRes->errorInfos[0]->resCode0调用成功,正常返回
FarelDbKvRes->errorInfos[0]->resInfo空字符串调用成功,空字符串

调用异常返回

返回参数含义
FarelDbKvRes->errorInfos[0]->resCode大于0的数值调用失败,返回错误代码
FarelDbKvRes->errorInfos[0]->resInfo非空字符串调用失败,返回错误信息字符串

样例代码

#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;

	//连接
	std::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;
	}

	//连接成功,可以开始进行后续操作

	//删除一个不存在的键值对存储表 ,加入 if exists 参数,则调用成功
	string Command = u8"kv drop table if exists notExistDBName ";//命令需要使用utf8字符串

	//执行命令
	std::shared_ptr<FarelDbKvRes> res(conn.queryKv(Command));

	//判断执行命令返回是否失败
	if (res->errorInfos.size() > 0)
	{
		printf("%s 调用失败,错误代码:%d  ; 错误信息: %s \n\n",Command.c_str(), res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
		return;
	}
	printf("%s 调用成功 \n\n", Command.c_str());

	删除一个存在的键值对存储表,调用返回成功
	Command = u8"kv drop table myTestKv ";//命令需要使用utf8字符串

	//执行命令
	std::shared_ptr<FarelDbKvRes> res1(conn.queryKv(Command));

	//判断执行命令返回是否失败
	if (res1->errorInfos.size() > 0)
	{
		printf("%s 调用失败,错误代码:%d  ; 错误信息: %s \n\n", Command.c_str(), res1->errorInfos[0]->resCode, res1->errorInfos[0]->resInfo.c_str());
		return;
	}
	printf("%s 调用成功 \n\n", Command.c_str());
}

补充说明:

  1. 方括号 [ ]
    方括号 ( [ ] ) 表示里面的元素(参数、值或信息)是可选的。 您可以选择一个或多个条目,也可以不选。 不要将方括号本身也输入到命令行中。
  2. 尖括号 < >
    尖括号 ( < > ) 表示里面的元素(参数、值或信息)是必需的。 您需要用相应的信息来替换尖括号里面的文本。 不要将尖括号本身也输入到命令行中。
  3. [ ,…n ] 表示前面的项可重复 n 次。每一项由逗号分隔。
  4. [ …n ] 表示前面的项可重复 n 次。每一项由空格分隔。
  5. | (竖线) 分隔括号或大括号内的语法项目。只能选择一个项目。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值