Search

dbQuery

Version 23.4.8843

dbQuery

对数据库执行查询。

必需的参数

  • conn：连接字符串或数据库 URL。
  • query: SQL 查询字符串。

可选的参数

  • commandtimeout: 命令超时，以秒为单位完成操作。零（0）表示没有超时。默认值为 60。
  • fromrow: 从开始要跳过的行数。默认值为 0。
  • maxrows: 从数据库返回的最大行数。设置为-1可获取所有结果。默认值为 -1。
  • paramname#: 参数名称。
  • paramvalue#: 参数值。
  • paramtype#: 参数类型。
  • transactionid: 此事务的 ID。
  • querypassthrough：将查询按原样传递给操作，而不是执行客户端验证和语法纠正。

输出属性

  • db:\: 输出因查询而异。

示例

此示例使用跨平台版本的知行之桥在 MySQL 数据库中执行存储过程。 它从电影表中选择评级为 PG-13 的所有电影，并为每部电影输出一个文件。 文件名是电影标题，文件内容是电影描述。 paramname/paramvalue 属性用于演示如何在脚本中工作。

<arc:set attr="db.driver" value="cdata.jdbc.mysql.MySQLDriver" />
<arc:set attr="db.conn" value="jdbc:cdata:mysql:server=localhost;port=3306;database=sakila;user=root;password=Password123;"/>
<arc:set attr="db.query" value="SELECT * FROM `film` WHERE rating = @max_rating"/>
<arc:set attr="db.paramname#1" value="max_rating" />
<arc:set attr="db.paramvalue#1" value="PG-13" />

<arc:call op="dbQuery" in="db" out="results" >
  <!-- 可选的日志记录步骤，用于在应用程序日志中查看查询的输出 -->
  <arc:set attr="_log.info" value="[results.*]" />
  <!-- 将每个输出文件的数据设置为影片的描述 -->
  <arc:set attr="output.data" value="[results.db:description]" />
  <!-- 将输出文件名设置为每部电影的标题 -->
  <arc:set attr="output.filename" value="[results.db:title].txt" />
  <arc:push item="output" />
</arc:call>

只要在安装并运行知行之桥的计算机上安装驱动程序，就可以修改上面的示例以定位其他数据库。 针对 .NET 调整此示例涉及更改 driver 和 conn 输入，如下所示：

<arc:set attr="db.driver" value="System.Data.CData.MySql" /> 
<arc:set attr="db.conn" value="Server=localhost;Database=sakila;UID=root;Password=Password123;"/>