Property | S/T | Description |
---|---|---|
AutoCommit | T | Allows you to automatically commit changes as they are made by each SQL statement, instead of waiting until the end of a transaction. If AutoCommit is set to true, there is no way to roll back changes once they have been made. The default is false. |
BulkOperations | T | Use bulk operations for faster insert. This property determines if an insert statement is executed for each record or a bulk add is executed for each record. The default is false, the slower setting. If you want to maximize speed and instruct Map Designer to use a bulk add, change this setting to true. |
CommitFrequency | T | Controls how often data is committed to the database. Default is zero, meaning 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 too many 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 | Pass-through mechanism that allows you to specify any additional data definition language (DDL) statements that need to be executed when a new table is created. DDL is used to define keys, indexes, constraints and integrity rules for SQL databases. There is no default. |
CursorType | S | Type of cursor to use for retrieving records from the source table. Available options are forward only (default), dynamic, and static. See CursorType for details. |
Encoding | ST | The SQL Server 2012 connector is Unicode-based. The encoding property specifies the encoding from which to translate user names and query statements to Unicode before passing them to SQL Server. Default is OEM. For choices, see Encoding Reference. |
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 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 returns a syntax error that they are not separated by a comma. There are four identifier quote options: Default, None, an apostrophe ('), and double quotes ("). |
MaxDataLength | ST | Refers to the maximum data length for long data types. The default is 1 MB. You can reset this number as you choose based on your available memory capabilities and data requirements. Some ODBC drivers have limitations concerning the maximum data length they can handle. If you choose an application (ODBC) source or target connector and the default setting is not 1MB, Map Designer presets the default in respect of the capabilities of that particular ODBC driver. As a best practice, do not set this property any higher under those conditions. |
SystemTables | ST | If set to true, allows you to see all tables created by the DBA in the database. The system table names appear in the table list. Default is false. |
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 ways in which serializability of a transaction may be violated: P1 (Dirty Read), P2 (Nonrepeatable Read) and P3 (Phantoms). The isolation levels are as follows: • 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 any of P1, P2, and P3. For further details about TransactionIsolation levels, see the Microsoft ODBC SDK documentation. |
Views | ST | If set to true (default), allows you to see views. The view names appear in the table list along with the tables. |
WhereStmt | S | Provides a pass-through mechanism for SQL connectors that allows advanced users to construct the Where clause of the SQL query themselves. It can be used as an alternative to writing a lengthy query statement. This might be used to get the SQL database server to filter the data based on a condition before it is sent to Map Designer. Omit "WHERE" when you enter the clause. No default exists for this property. 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. |
PrimaryKey | T | The PrimaryKey property allows you to specify a list of field names that are used to make the primary key. The field names are delimited by commas. If the PrimaryKey property contains one or more field names, these names are included in the SQL CREATE statement when the connector is in replace mode. There is one additional requirement for using the PrimaryKey property. The ODBC driver must support integrity enhancement facility (IEF). Only the more advanced ODBC drivers support this. |
UseCursors | T | The UseCursors property allows you to turn cursor support on and off. The default is false. If you set the property to true and the specified ODBC driver does not support cursor inserts, Map Designer falls back on 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 such as Access. 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 (see details above). |