数据库查询

因软件更新较快，部分文档内容与软件最新版本有所出入，请知悉。

【本功能为预览状态，欢迎反馈问题】

对指定的数据库执行SQL查询并返回结果。

支持的数据库连接类型包含：SQLServer、MySQL、SQLite、OleDb、ODBC。

您需要了解数据库相关知识才能使用本模块。
本模块内部使用Dapper执行查询。

更新、删除数据可能会造成重大损失，请谨慎操作。

步骤参数

【数据库连接类型】

选择所要访问的数据库连接类型。

【连接字符串】

指定数据库连接字符串（ConnectionString）。每种数据库有自己的格式规范，您可以参考https://www.connectionstrings.com/ 网站了解对应数据库连接字符串的写法。

为了方便您的使用，Quicker对以下情况做了特殊处理：

对SQLite数据库，可以直接指定SQLite数据库文件的完整路径。Quicker会自动补全连接字符串，格式为：Data Source=SQLite数据库文件完整路径;Version=3;
在使用OleDb类型时，对于Access文件（扩展名为.mdb或.accdb）也可以直接指定文件路径。Quicker会自动补全连接字符串，格式为：Provider=Microsoft.ACE.OLEDB.12.0;Data Source=Access文件路径;Persist Security Info=False;

【SQL语句】

要执行的SQL语句。在语句中，可以通过@参数名的方式指定参数。

例如：

select * from contacts Where first_name = @FirstName

【参数】

仅仅在SQL语句中使用参数的情况下提供。

在指定参数名时不需要写前面的@符号。

支持通过如下方式指定参数：

（1）词典变量。词典的键为SQL语句中的参数名称。

（2）可以转换为词典的文本格式的内容：

简单格式：每行一个参数，格式为：“参数名:参数值”
Json格式：{"文本参数名":"参数值","数字参数2":参数值2}

（3）C# DataRow类型的对象。

（4）匿名对象。$= new { ParamName= value }

【超时秒数】

执行查询的超时时间。

【执行方式】

（1）Query：查询并返回结果数据。主要用于使用SELECT语句获取行数据，例如：SELECT * FROM Table1

（2）Execute：执行并返回影响的行数。主要用于INSERT、UPDATE、DELETE等语句更新数据的情况。

（3）ExecuteScalar：执行并返回单值结果。例如：SELECT COUNT(1) FROM Table1

各执行方式的输出值信息请参考下面的章节。

【失败后停止】

当遇到异常情况时是否停止动作。请注意：查询结果为空不一定会产生异常造成失败，请以实际测试结果为准。

各执行方式与输出

Query：查询并返回结果数据

【是否成功】是否成功执行查询（不代表一定有返回结果）。

【查询结果（表格）】

得到表格类型(DataTable)的查询结果。可使用 “表格数据操作” 模块查看表格内容或进行其他处理。

【查询结果（对象列表）】

得到动态对象的列表。每行为一个对象。

【首项结果】

查询结果中的第一行数据。可以输出到动态对象或词典类型变量中。

Execute：执行并返回影响的行数

【是否成功】

执行查询是否未出现异常。不代表实际更新了数据库。

【影响行数】

创建、更新或删除的数据行数。

ExecuteScalar：执行并返回单个值

【是否成功】

执行查询是否未出现异常。不代表实际更新了数据库。

【单值结果】

查询返回的单个结果。

遍历数据行

（需要Quicker 1.28.10+版本）

当通过SQL查询到一些数据以后，可以将结果输出到表格或者一个动态对象的列表，然后通过“每个”模块循环。

（1）对表格的每行进行循环。

请参考表格变量类型文档中的说明。

（2）对动态对象的列表进行循环。

此时，“项”应该输出到一个动态对象类型的变量中。在循环中，使用 {行对象}.列名 的方式访问某一列的数据。

参考

类库使用

MySQL使用的库为MySqlConnector，SQLite使用的库为System.Data.SQLite 。

常见连接字符串格式参考

SQLServer

标准：Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;
连接到某个数据库实例：Server=myServerName\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword;

使用非标准端口：Server=myServerName,myPortNumber;Database=myDataBase;User Id=myUsername;Password=myPassword;

MySQL

Server=myserver;User ID=mylogin;Password=mypass;Database=mydatabase

创建SQLite数据库

可以使用这个子程序创建SQLite数据库，参数为要数据库文件的完整路径。

示例动作

示例动作：https://getquicker.net/Sharedaction?code=3eba3790-6c37-41c7-7aff-08d9bf67e5c4