第8章 第3讲 FarelDB 关系数据库命令 数据库操作类(database) 之 Use Database

FarelDB 关系数据库命令 数据库操作类(database) 之 Use Database

切换选择当前使用数据库用于简化对数据库对象的操作命令。FarelDB允许用户创建若干个用户数据库，以及在创建数据库中创建各类对象，包括表，脚本等。在对多个数据库中各对象进行各种SQL操作时，需要通过数据库名.对象名来进行唯一标识。为了简化使用，可以直接使用对象名。如果登录系统后，不设置选择当前使用数据库，则默认操作系统内置数据库（inner_db_sys），如果要切换其他数据库，可使用本命令进行切换；

语法

use database <数据库名>

返回值

成功返回大于0的操作影响数 ，失败则返回 错误原因 。

命令实例

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

//1. 登录FarelDB服务端后，系统默认选择的数据库是 inner_db_sys, 下面查询的student表不属于inner_db_sys数据库中
FarelDb 192.168.56.1:6800 > select ID,Name,Age,Score from student
error(1130): the specified database object is not exist: this table(student) is not exist in the database of inner_db_sys

//2. 在表名称前加上所属数据库名查询
FarelDb 192.168.56.1:6800 > select ID,Name,Age,Score from studentDB.student
ID      Name    Age     Score
0    Bob_0    0    0.0000000
1    Bob_1    20    1.0010000
[2 rows]

//3.切换选择默认数据库为 studentDB
FarelDb 192.168.56.1:6800 > use database studentDB
success, affected count: 1

//4.  简化命令查询
FarelDb 192.168.56.1:6800 > select ID,Name,Age,Score from student
ID      Name    Age     Score
0    Bob_0    0    0.0000000
1    Bob_1    20    1.0010000
[2 rows]

//切换不存在的数据库
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;
	}
	
	//连接成功，可以开始进行后续操作
	
	//切换选择一个存在的数据库，返回调用成功
	string Command = u8"use database studentDB ";//命令需要使用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"use database notExistDatabase ";//命令需要使用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. | （竖线） 分隔括号或大括号内的语法项目。只能选择一个项目。