FarelDB 关系数据库命令 数据库操作类(database) 之 Show databases
FarelDB的系统内置数据库和用户数据库的库信息都存储在 inner_db_sys.inner_table_databases 表中,如果想查询系统内所有数据库信息,可以使用 show databases 快捷查询显示, 该命令等同于
select * from inner_db_sys.inner_table_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 ";
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)
{
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");
}
}
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());
}
}
补充说明:
- 方括号 [ ]
方括号 ( [ ] ) 表示里面的元素(参数、值或信息)是可选的。 您可以选择一个或多个条目,也可以不选。 不要将方括号本身也输入到命令行中。 - 尖括号 < >
尖括号 ( < > ) 表示里面的元素(参数、值或信息)是必需的。 您需要用相应的信息来替换尖括号里面的文本。 不要将尖括号本身也输入到命令行中。 - [ ,…n ] 表示前面的项可重复 n 次。每一项由逗号分隔。
- [ …n ] 表示前面的项可重复 n 次。每一项由空格分隔。
- | (竖线) 分隔括号或大括号内的语法项目。只能选择一个项目。