连接到 PostgreSQL
连接到 PostgreSQL 数据库。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
描述
建立与 PostgreSQL 服务器数据库的连接。
依赖关系
您需要有效的连接字符串才能连接到 PostgreSQL 数据库。 请参阅 connectionstring 参数 以获取有效连接字符串的示例。
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 RPA Studio 的脚本方式下使用此语法。
postgreConnect --connectionstring(String) (DbConnection)=connection
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 RPA Studio 的脚本方式及其设计器方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 连接字符串 | connectionstring |
Required |
Text |
用于连接到 PostgreSQL 数据库的 连接字符串 。 请参阅 connectionstring 参数 部分以获取详细信息。 |
connectionstring 参数
connectionstring 参数是您输入包含键/值对的字符串的位置，这些键/值对提供连接到 PostgreSQL 数据库所需的信息。 以下代码块是有效连接字符串的示例:
本地数据库 (基于文件)
Data Source=myLocalPostgreSQLDB;User Id=myUsername;Password=myPassword;
服务器数据库
User Id=myUsername;Password=myPassword;Data Source=//serverName:port/myserverDatabase;
- 数据源: 指示数据源，其中包含服务器信息。
- 用户标识: 指定用于认证的用户名。
- 密码: 指定用于认证的密码。
- serverName: PostgreSQL 服务器的名称或 IP 地址。
将每个字段替换为实际的 PostgreSQL 数据库服务器凭证和连接详细信息。
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | 描述 |
|---|---|---|---|
| 连接 | connection | Database Connection |
从与 PostgreSQL 数据库的连接返回数据。 |
示例
此示例通过使用 断言条件 (assert) 命令来验证连接是否成功，连接到 PostgreSQL 数据库。 如果连接为空，那么将显示消息“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.
postgreConnect --connectionstring "User ID=root;Password=myPassword;Host=localhost;Port=5432;Database=myDataBase;\r\nPooling=true;Min Pool Size=0;Max Pool Size=100;Connection Lifetime=0;" dbConnection=connection
// Check if the connection was successful
assert --message "Could not connect to the Database!" --left "${dbConnection}" --operator "Is_Null" --negate