Property | ST | Description |
|---|---|---|
AutoCommit | T | Allows you to automatically commit changes as they are made by each SQL statement, instead of waiting until the end of the transaction. If AutoCommit is set to true, you cannot roll back changes once they have been made. Default is false. |
BulkOperations | T | Specify whether or not to instruct the integration platform to use bulk operations for faster insert. If set to true, an insert statement or bulk add is executed for each record. This allows you to maximize speed. The default is false, the slower setting. |
CommitFrequency | T | Controls how often data is committed to the database. The default is zero, which means that data is committed at the end of the transformation, allowing rollback on error. This is the slowest setting. When doing large transformations, this is not practical as it may produce a significant number of transaction log entries. Setting the CommitFrequency to some nonzero value tells the connector to do a database commit after inserting or updating the specified number of records. This keeps the transaction log from getting too large but limits the restartability of the transformation. |
ConstraintDDL | T | Specify additional SQL data definition language statements to be executed after their target table is created. This is similar to support provided for SQL pass-through in the SQL import connectors. Each line must be a valid ODBC DDL statement. This property has no default. For an example, see ConstraintDDL Example. |
CursorType | S | Type of cursor to use for retrieving records from the source table. Available options are forward only, static, and dynamic. The default setting is forward only. For more details, see Cursors. |
DriverCompletion | ST | Allows you to control the driver prompt for information. The available options: • prompt - asks the user all information. • complete (default) - asks the user for information they forgot to enter. • complete required - asks the user only for information required to complete the connection. • no prompt - does not ask the user for any information. |
DriverOptions | ST | Specify valid ODBC string connections options. There is no default. |
Encoding | ST | Type of encoding to use with source and target files. |
IdentifierQuotes | ST | All databases have what are called quoted identifiers. You use quoted identifiers to make the SQL statement parseable and distinguish between columns and character data in SQL statements. For example, Oracle uses double quotes for column and table names in SQL statements and uses single quotes for character data. In a SQL statement, you should enclose identifiers containing special characters or match keywords in identifier quote characters; (also known as delimited identifiers in SQL-92). For example, the Accounts Receivable identifier is quoted in the following SELECT statement: SELECT * FROM "Accounts Receivable" If you do not use identifier quotes, the parser assumes there are two tables, Accounts and Receivable and return a syntax error that they are not separated by a comma. The integration platform provides four options for IdentifierQuotes: Default, None, double quotes ("), and a single quote ('). |
MaxDataLength | ST | Specifies the maximum number of characters to write to a field. The maximum data length for long data types. Default is 1 MB. Reset this number based on your available memory and target requirements. When this connector requests the column field size for these data types, it checks for a returned value greater than the MaxDataLength value. If the value is greater, the MaxDataLength value is used. Some ODBC drivers have maximum data length limitations. If you choose an ODBC source or target connector and the default setting is not 1 MB, the integration platform sets the value for that particular ODBC driver. Under those conditions, do not set the MaxDataLength property to a higher value. |
ModifyDriverOptions | ST | Modify driver options with information returned from connector. Allows you to store the ODBC connection. Default is true. If you select false, you are prompted for connection information each time you run the transformation. |
PrimaryKey | T | Specify a list of field names used to create a primary key. Field names are delimited by commas. If this property contains one or more field names, these names are included in the SQL CREATE statement when the connector is in Replace mode. This property has no default. To use this property, your ODBC driver must support integrity enhancement facility (IEF). Only the more advanced ODBC drivers support this. |
SystemTables | ST | If set to true, this property allows you to see all tables in the database that were created by the DBA. The system table names appear in the table list. Default is false. Note: This property is applicable only if the user is logged onto the database as the database administrator. Only the DBA has access to system tables. |
TransactionIsolation | ST | Allows you to specify an isolation level when reading from or writing to a database table with ODBC. The default is serializable. The ANSI SQL 2 standard defines three specific ways in which serializability of a transaction may be violated: P1 (Dirty Read), P2 (Nonrepeatable Read), and P3 (Phantoms). The isolation levels: • read_uncommitted – Permits P1, P2, and P3. • read_committed – Permits P2 and P3. Does not permit P1. • repeatable_read – Permits P3. Does not permit P1 and P2. • serializable – Does not permit P1, P2 or P3. For further details about TransactionIsolation levels, refer to IBM DB2 database ODBC documentation. |
Views | ST | If set to true (default), allows you to see table views. View names appear in the table list along with table names. |
WhereStmt | S | Provides a pass-through mechanism for SQL connectors for advanced users to construct the Where clause of the SQL query. It is also used as an alternative to writing lengthy query statements in the Query Statement box. Consider using this statement to instruct the SQL database server to filter data based upon a condition before it is sent to the integration platform. Omit Where when you enter the clause. This property has no default. Note: When the source connection is a Select statement, do not apply the WhereStmt. Instead, include the Where clause in your Select statements. This property enables data filtering when you select a table. |
UseCursors | T | The UseCursors property allows you to turn cursor support on or off. The default is false. If set to true and the specified ODBC driver does not support cursor inserts, the integration platform uses the SQL INSERT mode of adding records. For exports, cursor support is supposed to enhance the performance of inserting records. This appears to be the case for desktop databases. For database servers, there is no noticeable change in insert speed. They seem to execute prepared queries about as quickly as they handle cursor inserts Another complication of cursor inserts is that some drivers require that the target table be indexed, otherwise positioned updates (cursors) are not allowed. Two additional properties in the ODBC export connector address this issue: PrimaryKey and ConstraintDDL. |
ArraySize | T | Determines the number of rows to be sent to the server at one time. The default value is 1, meaning each row is individually sent to the server. Larger values will buffer multiple rows and send them all at once. While this improves the speed, it affects error reporting (a server error won't be detected/reported until the next batch of records is sent to the server). The maximum value allowed for this property is 100000. While the connector allows the value to be set that high, many drivers have lower limits. The connector will log a message indicating if the driver is forcing a lower value for the array size. In addition, the connector does not support arrays when there is a LOB-type field in the table, or when the (maximum) length of a character-type field is longer than 32767 characters. In these cases, a message will be logged indicating the array size has been reduced to 1. Due to the way the connector attempts to support older drivers, the array support requires either BulkOperations be true (which means UseCursors must also be true), or both must be false. The condition where BulkOperations is false and UseCursors is true will cause the array size to be reset to 1, with a message logged indicating this condition occurred. |