Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Field Name

Field Type

Description

Label*

Default Value: N/A
ExampleAzure SQL Active Directory Dynamic Account

String

Specify a unique name for the account instance.

Account properties*

Enter in the information to create a connection to the database.

Hostname*

Default Value: N/A
Example191.235.87.130

String/Expression

Specify the server's address to connect to.

 

Port Number*

Default Value1433
Example3306

String/Expression

Specify the database server's port to connect to.

 

Database name*

Default Value: N/A
Examplesldatabase

String/Expression

Specify the database name to connect to.

 

Authentication Mode*

 

Default Value:
Active Directory Password

Example: Active Directory Service Principal

Dropdown list

Select either of the following options for Azure SQL Authentication:

  • Active Directory Password: Provide Username and Password for authentication.

  • Active Directory Service Principal: Provide Client ID and Client Secret from service principals for authentication.

  • An Azure Active Directory (Azure AD) service principal is the local representation of an application object in a single tenant or directory. 

  • Service principals define who can access the application, and what resources the application can access.

Username

Default Value: N/A
Examplesladmin

String/Expression

Specify the username to connect to the database. The username is used as the default username when retrieving connections. The username must be valid in order to set up the data source.

 

Password

Default Value: N/A
Example<Encrypted>

String/Expression

Specify the password to connect to the data source. The password is used as the default password when retrieving connections. The password must be valid in order to set up the data source.

 

Trust all certificates

Default ValueDeselected 

Checkbox

Select this checkbox to allow all SSL certificates for connecting to the database.

 

Advanced properties

Specify advanced properties for connecting to the database.

Auto commit

Default ValueSelected
 

Checkbox

Select this checkbox to commit each of the batches immediately after it is executed. If the Snap fails, only the batch being executed at that moment is rolled back.

Deselect this checkbox to commit the 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.

Batch size*

Default Value50
Example90

Integer

Specify the number of statements to execute at a time.

Note
  • Select queries are not batched.

  • Using a large batch size could use up the JDBC placeholder limit of 2100.

Fetch size*

Default Value: 100
Example300

Integer

Specify the Number of rows to fetch at a time when executing a query.

Large values could cause the server to run out of memory.

 

Max pool size*

Default value: 50
Example: 90

Integer

Specify the maximum number of connections a pool will maintain at a time.

 

Max life time*

Default value: 30

Integer

Specify the maximum lifetime (in minutes) of a connection in the pool. Ensure that the value you enter is a few seconds shorter than any database or infrastructure-imposed connection time limit. A value of 0 indicates an infinite lifetime, subject to the Idle Timeout value. An in-use connection is never retired. Connections are removed only after they are closed.

 

Idle Timeout*

Default Value: 5

Integer

Specify the maximum amount of time (in minutes) a connection is allowed to sit idle in the pool. A value of 0 indicates that idle connections are never removed from the pool.

 

Checkout timeout*

Default value: 10000

Integer

Specify the number of timeout (in milliseconds) to wait for a connection to be available when the pool is exhausted. Zero waits forever. An exception will be thrown after the wait time has expired.

If you specify 0, the Snap waits infinitely until the connection is available. Therefore, we recommend you not to specify 0 for Checkout Timeout.

URL Properties

Use this field set to set additional URL properties if any.

URL property name

Default value: N/A
Example: Example corp

String

URL property name

 

URL property value

Default value: N/A
Example: https://www.example.com

String

URL property value

...