第8章 第7讲 FarelDB 关系数据库命令 数据库操作类(database) 之 Show databases

FarelDB 关系数据库命令 数据库操作类(database) 之 Show databases

FarelDB的系统内置数据库和用户数据库的库信息都存储在 inner_db_sys.inner_table_databases 表中,如果想查询系统内所有数据库信息,可以使用 show databases 快捷查询显示, 该命令等同于

select * from inner_db_sys.inner_table_databases

语法

show databases

返回值

成功返回系统内置库和用户创建的用户数据库信息 ,失败则返回 错误原因 。
数据库信息参见下表:

列名列含义返回列类型说明
name数据库名称char *
tables数据库包含表个数int
inner_flag内置数据库标志bool系统创建的内置数据库:true 用户创建的数据库:false
create_time创建时间long整数表示,定义为从格林威治时间1970年1月1日0时0分0秒0毫秒起到创建表的时刻总毫秒数
last_modified_time最后修改时间long整数表示,定义为从格林威治时间1970年1月1日0时0分0秒0毫秒起到创建表的时刻总毫秒数

命令实例

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

// 显示所有数据库信息 
FarelDb 10.7.6.209:6800 > show databases
name        tables size inner_flag  create_time              last_modified_time
inner_db_sys  0     0   true       2020-10-08 20:13:18.188    2020-10-11 15:16:22.024
tdb           0     0   false      2020-10-09 11:45:38.279    2020-10-09 11:45:38.279
hess          0     0   false      2020-10-10 12:37:39.211    2020-10-11 15:17:25.396
[3 rows]

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 (0 != get<0>(resConn))
	{
		printf("连接失败,错误代码:%d : 错误信息:%s\n", get<0>(resConn), get<1>(resConn).c_str());
		return;
	}

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

	//显示说有数据库名称
	string Command = u8"show databases ";//命令需要使用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;
	}
	//打印返回数据表的信息
	if (res->fields.size() > 0)  //返回数据表的列信息(表头信息数据字典)在FarelDbRes->fields数组中存储
	{
		for (size_t i = 0; i < res->fields.size(); i++)
		{
			FarelDbField* field = res->fields[i];
			printf("%s\t", field->name.c_str());
			if (res->fields.size() - 1 == i)
			{
				printf("\n");
			}
		}
		//返回数据表的行信息(记录数据)在FarelDbRes->rows 的数组中存储
		for (size_t i = 0; i < res->rows.size(); i++)
		{
			FarelDbRow& row = res->rows[i];
			for (size_t j = 0; j < row.size(); j++)
			{
				if (nullptr != row[j]->data)
				{
				    //根据列类型信息,获取表格对应单元格的字符串格式数据
					string strVal = conn.getStrValFromColVal(res->fields[j], row[j]->data);
					strVal = strVal.length() == 0 ? "\"\"" : strVal;
					printf("%s    ", strVal.c_str());
				}
				else
				{
					printf("NULL\t");
				}
			}
			if (i < res->rows.size())
			{
				printf("\n");
			}
		}
		printf("[%llu rows]\n", res->rows.size());
	}
}

补充说明:

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

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值