跳到主要内容

数据库查询

对数据库执行SQL语句并返回结果

当前模块定义​

sys:dboperation计算与比较Action
标准模块
输入 7 · 输出 7 · 枚举 2

输入参数

  • 数据库连接类型dbTypeEnum可选
    填写 固定输入
    5 个选项SQL Server、MySQL、SQLite
    SQL Serversqlserver
    MySQLmysql
    SQLitesqlite
    OleDBoledb
    ODBCodbc
  • 连接字符串connectionStringText可选

    Connection string

    填写 输入或变量
  • SQL语句sqlText可选

    要执行的SQL语句内容

    填写 输入或变量
  • 参数sqlParamObject可选

    为SQL语句提供的参数

    填写 输入或变量
  • 超时秒数timeoutSecondsInteger可选

    留空或0表示默认。

    填写 输入或变量
  • 执行方式operationTypeEnum必填
    填写 固定输入默认 Query
    Query：查询并返回结果数据默认Query
    Execute：执行并返回影响的行数Execute
    ExecuteScalar：执行并返回单个值(首行首列的值ExecuteScalar
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 影响行数rowsAffectedInteger
    条件 仅：Execute
  • 单值结果scalarResultAny
    条件 仅：ExecuteScalar
  • 查询结果(表格)dataTableResultTable

    获取表格类型的行结果

    条件 仅：Query
  • 查询结果(对象列表)listResultObject

    获得动态对象列表类型的结果

    条件 仅：Query
  • 首项结果firstItemObject

    如果只需要返回结果的第一行，可以使用此项输出，支持词典或dynamic对象。没有结果时返回null。

    条件 仅：Query
  • 结果行数rowCountInteger
    条件 仅：Query

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

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

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

  • 您需要了解数据库相关知识才能使用本模块。

  • 本模块内部使用Dapper执行查询。

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

数据库查询

对数据库执行SQL语句并返回结果
数据库连接类型
连接字符串
 
Connection string
SQL语句
 
要执行的SQL语句内容
参数
 
为SQL语句提供的参数
超时秒数
 
留空或0表示默认。
执行方式
是否成功
-- 选择变量 --
操作是否成功
查询结果(表格)
-- 选择变量 --
获取表格类型的行结果
查询结果(对象列表)
-- 选择变量 --
获得动态对象列表类型的结果
首项结果
-- 选择变量 --
如果只需要返回结果的第一行，可以使用此项输出，支持词典或dynamic对象。没有结果时返回null。
结果行数
-- 选择变量 --
步骤注释
 
运行后延迟0保存(S)取消

步骤参数​

【数据库连接类型】

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

【连接字符串】

指定数据库连接字符串（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：查询并返回结果数据​

数据库查询

对数据库执行SQL语句并返回结果
数据库连接类型
连接字符串
path
Connection string
SQL语句
select * from contacts
要执行的SQL语句内容
参数
 
为SQL语句提供的参数
超时秒数
 
留空或0表示默认。
执行方式
是否成功
-- 选择变量 --
操作是否成功
查询结果(表格)
table1
获取表格类型的行结果
查询结果(对象列表)
listResult
获得动态对象列表类型的结果
首项结果
firstItem
如果只需要返回结果的第一行，可以使用此项输出，支持词典或dynamic对象。没有结果时返回null。
结果行数
rowCount
运行后延迟0保存(S)取消

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

【查询结果（表格）】

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

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

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

【首项结果】

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

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

数据库查询

对数据库执行SQL语句并返回结果
数据库连接类型
连接字符串
path
Connection string
SQL语句
insert into contacts (first_name, last_name, email, phone) values(@FirstName, @LastName, @Email, @Phone)
要执行的SQL语句内容
参数
FirstName:李 LastName:四 Email:lisi@getquicker.net Phone:13888889999
为SQL语句提供的参数
超时秒数
 
留空或0表示默认。
执行方式
是否成功
-- 选择变量 --
操作是否成功
影响行数
rowsAffected
运行后延迟0保存(S)取消

【是否成功】

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

【影响行数】

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

ExecuteScalar：执行并返回单个值​

数据库查询

对数据库执行SQL语句并返回结果
数据库连接类型
连接字符串
path
Connection string
SQL语句
select COUNT(1) from contacts
要执行的SQL语句内容
参数
FirstName:李
为SQL语句提供的参数
超时秒数
 
留空或0表示默认。
执行方式
是否成功
-- 选择变量 --
操作是否成功
单值结果
scalarResult
运行后延迟0保存(S)取消

【是否成功】

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

【单值结果】

查询返回的单个结果。

遍历数据行​

（需要Quicker 1.28.10+版本）

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

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

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

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

每个

对列表的每项执行处理
列表
listResult
要处理的列表
线程模式
⚠通常不要选择! 请阅读文档详细了解后再使用。
项
item
列表中的每项，每次循环赋予当前项的值。在子步骤中应该对本输出进行处理。
计数
-- 选择变量 --
本次循环，处理到了第几项。
运行后延迟0保存(S)取消

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

参考​

类库使用​

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

更新于