执行 SQL 指令
运行 SQL 指令并返回有关命令执行情况的信息。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
注：从发行版 21.0.2 开始，已弃用此命令。
Description
要连接到数据库，请使用以下命令：
要运行 SQL 语句，请使用运行 SQL 命令。
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
executeSql --connection(String) --command(String) --results(ExecuteSqlResults) (Boolean)=isnull (String)=value (DataTable)=table (Numeric)=rows (Numeric)=columns
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | Description |
|---|---|---|---|---|
| 连接字符串 | connection |
Required |
Text |
数据库字符串连接。 它仅支持 SQL Server 连接。 |
| 指令 | command |
Required |
Text |
SQL 指令。 |
| 结果类型 | results |
Required |
ExecuteSqlResults |
要返回的结果的类型。 请参阅 results 参数选项。 |
results 参数选项
下表显示了可用于 results 输入参数的选项。 该表显示了在脚本方式下工作时的可用选项以及在设计器方式下的等效标签。
| 设计器方式标签 | 脚本方式名称 | Description |
|---|---|---|
| 无 | None |
空值输出参数中的返回值。 |
| 标量 | Scalar |
结果输出参数中的返回值。 |
| 数据表 | DataTable |
数据表、行和列输出参数中的返回值。 |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | Description |
|---|---|---|---|
| Null | isnull |
Boolean |
如果数据库为空，那么返回 Null。 |
| 结果 | value |
Text |
返回值。 |
| 数据表 | table |
Data Table |
返回数据表中的数据。 |
| 行 | rows |
Number |
返回数据表中受影响的行数（如果有）。 |
| 列数 | columns |
Number |
返回数据表中受影响的列数（如有）。 |
示例
此命令在数据库中插入一个表，并返回该表以及受影响的行数和列数。
defVar --name connectionString --type String --value "Data Source=127.0.0.1;Initial Catalog=test;User ID=root; Password=\"\";\r\n"
defVar --name sqlCommand --type String --value "INSERT INTO book (price,title,author,publishingcompany,pagesnumber,language) \n VALUES (59.99,\'Hamlet\',\'William Shakespeare\',\'New Horizon\',300,\'EN\');"
defVar --name returnedTable --type DataTable
defVar --name tableRows --type Numeric
defVar --name tableColumns --type Numeric
executeSql --connection "${connectionString}" --command "${sqlCommand}" --results "DataTable" returnedTable=table tableRows=rows tableColumns=columns