On this page
...
Use this account type to connect PostgreSQL Snaps with datasources data sources that use PostgreSQL accounts.
...
Parameter Name | Data Type | Description | Default Value | Example | ||||||
---|---|---|---|---|---|---|---|---|---|---|
Label | String | The name for the account. We recommend that you update the account name if there is more than one account in your project. | N/A | PostgreSQL_Account_Type | ||||||
Account properties | NA | Required.The account information required to create a connection to the PostgreSQL database. | N/A | N/A | ||||||
Hostname | String | Required.The PostgreSQL server's address.
| N/A | acc-postgresql-us-test-rsd.amazonaws.com | ||||||
Port Number | Integer | Required.The port number that you want to use to make the server connection.
| 3306 | 1234 | ||||||
Database name | String/Expression | Required.The name of the database to which you want to connect.
| N/A | TestDB | ||||||
Username | String/Expr | Required. The username that is allowed to connect to the database. This username will be used as the default username when retrieving connections. The username must be valid in order to set up the data source.
| N/A | testaccount | ||||||
Password | String | Required. The password associated with the username listed above. The password must be valid in order to set up the data source.
| N/A | N/A | ||||||
JDBC Jars | N/A | The list of JDBC jar files that must be loaded for the account to work. | N/A | N/A | ||||||
JDBC Driver | String | The JDBC driver that must be loaded for the account to work. By default, this field has one row populated. Click the icon to add more rows. | {Default Driver postgres 9.4.1207} | postgresql-9.3-1104.jdbc4.jar | ||||||
JDBC Driver Class | String | The JDBC driver class that you want to use with the account. | org.postgresql.Driver | N/A | ||||||
Configure SSH Tunnel | Checkbox | Select this checkbox if the Snap needs to create an SSH tunnel for connecting the Snaplex to the PostgreSQL server. After the operation is completed, the tunnel is closed. If you select true, you must provide the configuration details of the SSH tunnel. Learn more about Setting Up SSH Tunneling with PostgreSQL. | Deselected | Selected | ||||||
SSH Auth Mode | String/Expression | Select an option to specify the mode for authenticating the user on the SSH tunnel. The available options are:
This option is available only if the Configure SSH Tunnel checkbox is selected.
| Password | KeyFile | ||||||
SSH Hostname | String/Expression | Specify either the IP address or the domain name of the SSH server to which you want to connect. or use an expression for this field. | None | _SSH_Hostname | ||||||
SSH Username | String/Expression | Specify the SSH username for connecting to the SSH tunnel. | None | _SSH_User | ||||||
SSH Password | String/Expression | Specify the password for the specified SSH username for connecting to the SSH tunnel. This field is required if the SSH Auth Mode is Password. | None | <Encrypted> | ||||||
Private Key File URL | String/Expression | Specify the location of the keystore file. This field is required if the SSH Auth Mode is KeyFile (Private Key File). The file can be in SLDB, on the host machine that is hosting the JCC, or at any other remote location. For a local file, click to select the appropriate file using the file browser. You can also upload the file using any protocol such as | None | _PK_File | ||||||
Private Key | String/Expression | Specify the private key for authentication. This field is required if the SSH Auth Mode is KeyFile (Private Key String). | None | _PrivateKey | ||||||
Private Key Passphrase | String/Expression | Specify the password is to be used to access the Key File URL or to decrypt the Private Key. If no value is provided, the keystore password is used. This field is required if the SSH Auth Mode is KeyFile. | None | :y<>6[[]gMssb^rM | ||||||
SSH Port | Integer/Expression | Specify the SSH port to connect to the PostgreSQL Server.
| None | 22222 | ||||||
Advanced Properties | N/A | Advanced properties associated with the PostgreSQL account type. | N/A | N/A | ||||||
Auto commit | Checkbox | Select this check box to commit batches as soon as they are executed. If the Snap fails, only the batch being executed at that moment is rolled back. Deselect the check box to commit Snap execution output only after all the batches are executed. If the Snap fails, the entire transaction is rolled back unless the Snap finds invalid input data before it sends the insert request to the server and routes the error documents to the Error view. | Selected | N/A | ||||||
Batch size | Integer | Required. The number of statements to execute at a time.
| 50 | 20 | ||||||
Fetch size | Integer | Required.The number of rows that you want the Snap to fetch at a time when executing a query.
| 100 | 50 | ||||||
Min pool size | Integer | Required. The minimum number of connections that a pool should maintain at a time. | 3 | 5 | ||||||
Max pool size | Integer | Required. The maximum number of connections that a pool should maintain at a time. | 50 | 30 | ||||||
Max life time | Integer | Required. The maximum lifetime (in minutes) of a connection in the pool. Ensure that the value you enter is less than any database or infrastructure-imposed connection time limit. A value of 0 indicates an infinite lifetime, subject to the Idle Timeout value.
| 30 | 50 | ||||||
Idle Timeout | Integer | Required. The maximum amount of time (in minutes) for which a connection is allowed to sit idle in the pool. A value of 0 indicates that idle connections are never removed from the pool. | 5 | 10 | ||||||
Checkout timeout | Integer | Required. The number of milliseconds for which the Snap waits for a connection to be available when the pool is exhausted. A value of 0 indicates an infinite timeout. The Snap throws an exception after the wait time expires. | 10000 | 8000 | ||||||
URL properties | Fieldset | Use this fieldset to configure the URL that connects to your account. | N/A | N/A | ||||||
URL property name | String | The name of the URL property. | N/A | socketTimeout | ||||||
URL property value | string | The value of the URL property. | N/A | 10 |
...
Excerpt | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Auto-commit with Execute SnapsFor a DB Execute Snap, assume that a stream of documents enters the input view of the Snap and the SQL statement property has JSON paths in the WHERE clause. If the number of documents is large, the Snap executes in more than one batches rather than executing one per each document. Each batch would contain a certain number of WHERE clause values. If Auto commit is turned on, a failure would only roll back the records in the current batch. If Auto commit is turned off, the entire operation would be rolled back. For a single execute statement (with no input view), the setting has no practical effect. |
...