FarelDB 关系数据库命令 数据库操作类(database) 之 Use Database
删除数据库命令用于删除一个用户数据库,删除数据库后将删除该数据库中的所有数据对象,包括该数据库中的表,脚本,结构和实时数据。系统内置数据库(inner_db_sys)不支持删除操作。
语法
drop database [ if exists] <数据库名> |
---|
返回值
成功返回大于0的操作影响数 ,失败则返回 错误原因 。
命令实例
打开一个命令行窗口,启动FarelDB服务端,再打开一个命令行窗口,启动FarelDB客户端,输入以下命令:
//1. 系统中存在studentDB数据库,删除已经存在studentDB数据库,调用成功
FarelDb 192.168.56.1:6800 > drop database studentDB
success, affected count: 1
//2. 系统中 不存在studentDB ,删除不存在studentDB数据库,删除失败
FarelDb 192.168.56.1:6800 > drop database studentDB
error(1130): the specified database object is not exist: studentDB,line:1
//3. 系统中 不存在studentDB ,删除不存在studentDB数据库,加 if exists选项,调用成功,系统不操作任何数据库
FarelDb 192.168.56.1:6800 > drop database if exists studentDB
success, affected count: 0
//切换不存在的数据库
FarelDb 192.168.56.1:6800 > use database noExistDatabase
error(1130): the specified database object is not exist: this database(noExistDatabase) is not exist,line:1
API 说明
函数原型
FarelDbRes* query(std::string Command) |
---|
输入参数说明
输入参数 | 描述 | 可选 |
---|---|---|
Command | 符合语法的命令字符串 | 否 |
返回参数说明
调用成功返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbRes->errorInfos.size() | 0 | 调用成功,无错误信息 |
调用异常返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbRes->errorInfos.size() | 大于0 | 调用失败,errorInfos对象数组包含1个或多个错误信息 |
FarelDbRes->errorInfos[0]->resCode | 大于0的数值 | 调用失败,返回错误代码 |
FarelDbRes->errorInfos[0]->resInfo | 非空字符串 | 调用失败,返回错误信息字符串 |
返回数据获取方法
FarelDbRes* query(std::string Command)接口调用成功后,接口将根据不同种类的Sql语句返回不同的结果,具体不同Sql语句返回结果的获取方法,请参考下面的样例代码。
样例代码
#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"drop database if exists notExistDBName ";//命令需要使用utf8字符串
//执行增加一个新的查询的命令
std::shared_ptr<FarelDbRes> res(conn.query(Command));
//判断执行命令返回是否失败
if (res->errorInfos.size() > 0)
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
printf("%s 调用成功 \n", Command.c_str());
删除一个存在的数据库,调用返回成功
Command = u8"drop database studentDB ";//命令需要使用utf8字符串
//执行命令
std::shared_ptr<FarelDbRes> res1(conn.query(Command));
//判断执行命令返回是否失败
if (res1->errorInfos.size() > 0)
{
printf("调用失败,错误代码:%d ; 错误信息: %s \n", res1->errorInfos[0]->resCode, res1->errorInfos[0]->resInfo.c_str());
return;
}
printf("%s 调用成功 \n", Command.c_str());
};
---
### 补充说明:
1. 方括号 [ ]
方括号 ( [ ] ) 表示里面的元素(参数、值或信息)是可选的。 您可以选择一个或多个条目,也可以不选。 不要将方括号本身也输入到命令行中。
2. 尖括号 < >
尖括号 ( < > ) 表示里面的元素(参数、值或信息)是必需的。 您需要用相应的信息来替换尖括号里面的文本。 不要将尖括号本身也输入到命令行中。
3. [ ,...n ] 表示前面的项可重复 n 次。每一项由逗号分隔。
4. [ ...n ] 表示前面的项可重复 n 次。每一项由空格分隔。
5. | (竖线) 分隔括号或大括号内的语法项目。只能选择一个项目。