第11章 第2讲 FarelDB 脚本调用 之 键值对类接口调用

FarelDB 脚本调用 之 键值对类接口调用

用于查询二维表中符合查询条件（where子句）的0行或多行数据集。

语法

方法1 查询表中所有列的符合条件数据记录：

select * from [数据库名.]二维表名 [where where条件子句] [order by 列名1 desc | asc] [LIMIT N][ OFFSET M]

方法2 查询表中某几列的符合条件数据记录：

select 列名1,列名2,列名3 [数据库名.]二维表名 [where where条件子句] [order by 列名1 desc | asc] [LIMIT N][ OFFSET M]

方法3 统计查询

**select count(*) from [数据库名.]二维表名 [where where条件子句] **

返回值

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

1） order by 列名 说明：
order by 列名是指查询的数据集按照列名排序，目前指支持1个列作为排序依据，并且除blob类型列不支持排序外，其他类型列可以支持作为排序依据，支持排序作为依据的列类型包括： short,int, long,float,double,varchar,text,TimeStamp. 如果需要对数据集按照类型列排序升序,则使用 order by 列名1 asc, 如果需要对数据集按照类型列排序降序,则使用 order by 列名1 desc，其中排序规则对于数字类型（ short,int, long,float,double,TimeStamp）采用数值比较大小排序，对于字符类型（varchar,text）采用字符字典序排序。
2） [LIMIT N][ OFFSET M] 说明：
可以使用 LIMIT 属性来设定返回的记录数，通过OFFSET指定SELECT语句开始查询的数据偏移量，返回从N开始的M条记录。默认情况下偏移量为0。

3）统计查询是指查询统计符合条件记录的个数

命令实例

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

//显示student表年龄在40到60岁之间的数据记录，并且如果有多个数据记录，查询从N开始的M条记录
FarelDb 10.7.6.209:6800 >select * from studentDB.Student where (age >40 and age <60) limit 10
success, affected count: 0

//显示 student表年龄在40到60岁之间的数据记录
FarelDb 10.7.6.209:6800 >select count(*) from studentDB.Student where (age >40 and age <60)  
 

---

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"select * from studentDB.student where ID>0 ";//命令需要使用utf8字符串

	//执行命令
	std::shared_ptr<FarelDbRes> res(conn.query(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;
	}
	//打印返回数据表的信息
	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. where条件子句说明：

1）. 支持等值条件 where 条件列=值 语句

FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID = 1;
success, affected count: 1

2）. 支持多值条件 where 条件列 in (值1,值2,…n) 语句

FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID in (1,2,3) and (name in ('Alix','Tom'));
success, affected count: 3

3）. 支持多个条件间的逻辑条件 and 和 or 语句
and运算符用于将两个或多个条件组合起来，只有当所有条件都满足时，结果才为真。Or运算符用于将两个或多个条件组合起来，只要有一个条件满足，结果就为真。

FarelDb 10.7.6.209:6800 >delete from studentDB.Student where (ID = 1) and (score >450 or score < 500)
success, affected count: 1

4）. 支持单个条件的逻辑条件 :
a) 不等于: < >
b) 大于 : >
c) 小于 : <
d)大于等于: >=
e)小于等于: <=
f) 不等于: ! =

FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID <> 1
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score > 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score < 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score >= 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score <= 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where  ID != 1
success, affected count: 1

逻辑条件优先级：逻辑运算的优先级只是决定了表达式的结合次序，而不是运算顺序，因此请对复杂的逻辑运算需要用括号对表达式进行显示组合。例如：

//查询 成绩大于500 并且年龄在40到60岁之间的数据集
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where (score >500) and (age >40 or age <60)
success, affected count: 1

---

2. 语法符号说明：

1. 方括号 [ ]
   方括号 ( [ ] ) 表示里面的元素（参数、值或信息）是可选的。 您可以选择一个或多个条目，也可以不选。 不要将方括号本身也输入到命令行中。

2. 尖括号 < >
   尖括号 ( < > ) 表示里面的元素(参数、值或信息）是必需的。 您需要用相应的信息来替换尖括号里面的文本。 不要将尖括号本身也输入到命令行中。

3. [ ,…n ] 表示前面的项可重复 n 次。每一项由逗号分隔。

4. [ …n ] 表示前面的项可重复 n 次。每一项由空格分隔。

5. | （竖线） 分隔括号或大括号内的语法项目。只能选择一个项目。

6. | （竖线） 分隔括号或大括号内的语法项目。只能选择一个项目。