DB Data Sink Update properties list

The following tables list the required and optional properties of the DB Data Sink Update component.


Required properties

Property

Description

Interface

Specify the method or driver to use to connect to the data source.

Host Name

Identify the data source. The options that appear on the host name list depend on the interface you select.

Destination Table

Select the destination table from a set of existing tables, or enter the destination table manually.

You can also create a new Destination table based on a component’s port structure. See “Adding a Destination table”.

Key

Select the columns of the Destination table that identify the records to update.

You must select a Destination table before you can select a key, and you can select multiple key columns.


Optional properties

Property

Description

User and Password

Identify an authorized database user, and protect the database against unauthorized access.

Shared Connection

Select this option to allow the component to share a single connection to the database with other target components that have identical connection and database parameters.

A connection can be shared only between components within the same project. Components in different projects within the same job cannot share a connection

Components that use the same database interface and login information, but have differing database options cannot share a connection, and generate an error when the project is executed or simulated.

Update Options

Select the attributes (key attributes are not listed) to include in the update. By default, all attributes are selected. Unselect the attributes to exclude from the update.

In the SQL UPDATE SET clause column, you can overwrite the value of the incoming attribute with a new one.

In SQL language notation the, contents of the columns are processed as:

UPDATE customersSET cu_createdate = '2005-02-26'WHERE ….

You can use any expression allowed in the SQL language of the underlying database. SBN expressions are evaluated during initialization of the component, so the value or expression is always constant during a single execution.

Write Block Size

Specify the number of records to be written to the file or pipe in a single write operation.

Pre Processing SQL

Create a script that runs during component initialization.

Scripts can include one or more SQL statements. If you use multiple statements, separate them with a semicolon (;).

Post Processing SQL

Create a script that runs after all components execute.

Scripts can include one or more SQL statements. If you use multiple statements, separate them with a semicolon (;).

Opening Attribute Quote

Specify a prefix for attribute names in SQL statements.

Closing Attribute Quote

Specify a postfix for attribute names in SQL statements.

Database

Specify the database to use as data source.

If you select this option, you must also select an appropriate interface, and in some cases, specify an appropriate user ID and password.

Schema

Identify the schema/owner you want to use as data source. The objects that appear are restricted accordingly and new tables are created in that schema.

Standardize Data Format

Convert incoming DATE and NUMBER information into a standard format that Sybase ETL can move between systems that support different formats.

Dates are converted into a format that includes the year, month, day, hour, minute, seconds, and fraction of a second: YYYY-MM-DD hh:mm:ss.s.

For example:

2005-12-01 16:40:59.123

Numbers are converted using a period (“.”) as the decimal separator.

IQ Lock Table in Exclusive Mode

Lock the target table and prevent it from being updated by concurrent transactions. When an exclusive table lock is applied, no other transaction can execute queries or perform any updates against the locked table. The IQ Lock Table in Exclusive Mode option also queues multiple projects that load the same table in Sybase IQ.

Wait Time for IQ Lock Table

Specify the maximum blocking time that the project should wait before acquiring an Exclusive lock.

Specify the time argument in the format hh:nn:ss.sss. If you do not enter a time argument, the server waits indefinitely until an Exclusive lock is available or an interruption occurs. When you specify “00:00:00.000” as the time argument, an Exclusive lock is acquired as soon as the project starts.

Load Stage Path

Specify a data file path. The load stage file must reside on the same machine as the IQ Server.

When using a Sybase IQ database, if you specify a Load Stage Path, the component uses the LOAD TABLE statement instead of using SQL statements. This leads to faster performance.

NoteYou do not have to enter the Load Stage Path if client side load balancing capability is available on your IQ Server. If available, it is automatically used with the LOAD TABLE statement to add records from files located on remote host machines into the Sybase IQ table.

To create a pipe, specify pipe:// as the Load Stage parameter. A pipe is not used if the Load Stage is blank.

If you use named pipes on UNIX or Linux, the ETL Server and the IQ Server must reside on the same machine. This is not a requirement for Windows.

Load Stage (Server)

Specify the server path to the data file or, leave it empty when using a pipe.

If the Sybase IQ server needs to use a different path to the temporary data file than specified in the Load Stage property, enter it here.

Database Options

Set options that override performance defaults and control the behavior of some transactions.

See “Database connection settings”.

Transactional

All work performed by the DB Data Sink Update component, including pre-SQL and post-SQL, is done in a single database transaction that is committed when the project finishes normally. Select this option to roll back the transaction, if this component encounters an error. See “Job components” and “Enabling transactionality for projects and jobs” for information on the “Propagate Rollback” property.