数据库查询

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

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

对指定的数据库执行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

语雀在语雀上查看