连接到 Oracle
连接到 Oracle 数据库。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
描述
建立与 Oracle 服务器数据库的连接。
依赖关系
您需要有效的连接字符串才能连接到 Oracle 数据库。 请参阅 connectionstring 参数 部分以获取有效连接字符串的示例。
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 RPA Studio 的脚本方式下使用此语法。
oracleConnect --connectionstring(String) (DbConnection)=connection
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 RPA Studio 的脚本方式及其设计器方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 连接字符串 | connectionstring |
Required |
Text |
用于连接到 Oracle Database的连接字符串。 请参阅 连接字符串参数 部分以获取详细信息。 |
connectionstring 参数
connectionstring 参数是您输入包含键/值对的字符串的位置，这些键/值对提供连接到 Oracle 数据库所需的信息。 以下代码块是有效连接字符串的示例:
本地数据库 (基于文件)
Data Source=MyOracleDB;User Id=myUsername;Password=myPassword;
服务器数据库
Data Source=//serverName:port;User Id=myUsername;Password=myPassword;
- 数据源: Oracle 服务器和端口的名称或 IP 地址。
- 用户标识: 指定用于认证的用户名。
- 密码: 指定用于认证的密码。
将每个字段替换为实际的 Oracle 数据库服务器凭证和连接详细信息。
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | 描述 |
|---|---|---|---|
| 连接 | connection | Database Connection |
用于存储与 Oracle 数据库的连接的变量。 |
示例
此示例通过使用 断言条件 (assert) 命令来验证连接是否成功，连接到 Oracle 数据库。 如果连接为空，那么将显示消息“Could not connect to the Database!” 。
defVar --name dbConnection --type DbConnection
// Connect to the database via the connection string and store the data in the connection variable.
oracleConnect --connectionstring "Data Source=MyOracleDB;User Id=myUsername;Password=myPassword;\r\nIntegrated Security=no;" dbConnection=connection
// Check if the connection was successful
assert --message "Could not connect to the database!" --left "${dbConnection}" --operator "Is_Null" --negate