第9章第12讲 FarelDB 关系二维表操作命令(table) 之 Batch Select

本文链接：https://blog.csdn.net/weixin_53142030/article/details/134429807

FarelDB 关系数据库命令数据库操作类(database) 之高性能批量查询 Select

高性能批量查询用于需要快速的批量查询大量数据的应用场景，该命令仅能被API接口调用。

API 说明

函数原型

FarelDbRes* batchSelect(std::string dbName, std::string tableName, std::vector<std::vector<std::string>>& keyLists, std::vector<std::string>& selectFieldNames)

输入参数说明

输入参数	类型	描述	可选
dbName	字符串	操作表所属数据名称	否
tableName	字符串	操作表名称	否
keyLists	二维数组向量	需要查询的行的行主键值	否
selectFieldNames	一维度数组向量	需要查询的列的列名	否

返回参数说明

调用成功返回

返回参数	值	含义
FarelDbRes->errorInfos.size()	0	调用成功，无错误信息

调用异常返回

返回参数	值	含义
FarelDbRes->errorInfos.size()	大于0	调用失败，errorInfos对象数组包含1个或多个错误信息
FarelDbRes->errorInfos[0]->resCode	大于0的数值	调用失败，返回错误代码
FarelDbRes->errorInfos[0]->resInfo	非空字符串	调用失败，返回错误信息字符串

返回数据获取方法参考样例代码

样例代码

#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;
	}

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

	//第1步.传入需要查询的行的行主键值
	vector<vector<string> > keyLists;
	vector<string> IDKeyValue;
	IDKeyValue.clear();
	IDKeyValue.emplace_back("1");  //所有主键以字符串传入
	keyLists.emplace_back(IDKeyValue);

	IDKeyValue.clear();
	IDKeyValue.emplace_back("3");  //所有主键以字符串传入
	keyLists.emplace_back(IDKeyValue);

	IDKeyValue.clear();
	IDKeyValue.emplace_back("4");  //所有主键以字符串传入
	keyLists.emplace_back(IDKeyValue);

	IDKeyValue.clear();
	IDKeyValue.emplace_back("5");  //所有主键以字符串传入
	keyLists.emplace_back(IDKeyValue);

	//本例中student只有一个主键，即ID，如果查询行的主键存在多个(联合主键)，则按照下面例子以此插入keyLists即可。 
	//vector<string> OthersKeyValue;
	//OthersKeyValue.clear();
	//OthersKeyValue.emplace_back("a");  //所有主键以字符串传入
	//keyLists.emplace_back(OthersKeyValue);

	//OthersKeyValue.clear();
	//OthersKeyValue.emplace_back("b");  //所有主键以字符串传入
	//keyLists.emplace_back(OthersKeyValue);

	//OthersKeyValue.clear();
	//OthersKeyValue.emplace_back("c");  //所有主键以字符串传入
	//keyLists.emplace_back(OthersKeyValue);

	//OthersKeyValue.clear();
	//OthersKeyValue.emplace_back("d");  //所有主键以字符串传入
	//keyLists.emplace_back(OthersKeyValue);

	 //第2步. 传入查询列的列信息
	 std::vector<std::string> selectFieldNames;
	 selectFieldNames.emplace_back("ID");
	 selectFieldNames.emplace_back("Name");
	 selectFieldNames.emplace_back("Scholarship");
	 selectFieldNames.emplace_back("Age");
	 selectFieldNames.emplace_back("Score");
 
	  
	 //第3步 调用批量更新接口
	 std::shared_ptr<FarelDbRes> res(conn.batchSelect("studentDB", "student", keyLists, selectFieldNames));

	 //判断执行命令返回是否失败
	 if (res->errorInfos.size() > 0)
	 {
		 printf("batchUpdate 调用失败，错误代码:%d  ; 错误信息: %s \n\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());
	}
}