Bulk Update

UiPath.Database.Activities.BulkUpdate

Description

Updates a compatible DataTable in an existing database table. The activity also updates all the columns that are not in the collection of column names used as a primary key. Returns the number of rows affected.

Project compatibility

Windows - Legacy | Windows | Cross-platform

Windows - Legacy, Windows configuration

Designer panel

• Configure Connection... - Select an existing database connection or add a new one using the Connection Wizard.
• Target table name - The target database table. This field supports only String variables.
• Input data table - The DataTable object that is used in updating the table. The DataTable columns descriptions must match the columns from the database table and be a subset of them. This field supports only DataTable variables.
• Column used for matching rows - The collection of column names used for row matching. This field supports only String[] variables.

Properties panel

Common

• Continue on error - This field only supports Boolean values (True, False). The default value in this field is False. As a result, if this field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
• DisplayName - The display name of the activity. This field supports only String variables.

Connection Configuration

• Bulk/batch update - Check this box to enable the creation of a temp table using Bulk insert and to update using join between tables. Otherwise, bulk updates are issued in batch.
• Connection string - The connection string used to establish a database connection. This field supports only String variables.
• Existing connection - An already open database connection. If such a connection is provided, the ConnectionString and SecureConnectionString properties are ignored. This field supports only DatabaseConnection variables.
• Provider name - The name of the database provider used to access the database. This field supports only String variables.
• Secure connection string - The connection string used to establish a database connection as Secure String. This field supports only SecureString variables.

Input

• Column used for matching rows - The collection of column names used for row matching. This field supports only String[] variables.
• Input data table - The DataTable object that is used in updating the table. The DataTable columns descriptions must match the columns from the database table and be a subset of them. This field supports only DataTable variables.
• Target table name - The target database table. This field supports only String variables.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Output

• Affected rows count - The number of updated rows. This field supports only Int64 variables.

Cross-platform configuration

• Existing connection - An already opened database connection obtained from the Connect to Database activity.
• Input data table - The DataTable variable that is used to update the database table. The DataTable columns' name and description must match the columns from the database table and be a subset of them.
• Target table name - The target database table in which the data is to be updated.
• Columns used for matching rows - The collection of column names used for row matching. These column names is be changed by the Bulk Update activity.

Advanced options

Other

• Continue On Error - Specifies if the automation should continue even when the activity throws an error.

Output

• Affected rows count - The number of affected rows stored in an Int64 variable.