Skip to main content
Version: 5.6

DB Update

The DB Update transfer object updates one or more existing records in a table or database view during data transfer. The transfer object thus acts as a transfer destination.

Dialog Overview

DB Update transfer object dialog

General Properties

PropertyDescription
DB ConnectionAll relational database connections created in the Plug-ins area are available for selection here. If your desired database connection is not listed, you can create it in the Plug-ins area as Microsoft SQL Server, Oracle, SAP HANA, ODBC, OLE DB, MySQL, or PostgreSQL.
TableTable or database view on which the update is performed.
Available ColumnsColumns in the table that have not yet been used.
Used ColumnsColumns whose values are updated during the update.

The distinction between available and used columns serves to provide clarity in the design area. Move columns by double-clicking the column name or using the <, >, <<, and >> buttons.

Filter

The update requires a filter to clearly define which records are updated.

Filter tab of the DB Update transfer object

PropertyDescription
FilterGraphically displays filters and filter groups. The OPC Router uses this to generate the appropriate database statement at runtime.
LinkDefines the AND and OR operators between filters and filter groups.
ColumnColumn used for filtering.
Comparison OperatorOperator for value comparison.
PreviewDisplays the resulting filter condition, for example WHERE (TIMESTAMP > ?) AND (VALUE = ?).

An explanation of the various filter operators can be found here.

Return Value

The transfer object provides the number of rows actually updated as a data source.

Notes

warning

Use the update only with filters that are appropriate for the business context. A filter that is too broad or missing can unintentionally modify many records.

note

The transfer object can also be selected for database views.