Property | S/T | Description |
|---|---|---|
Encoding | S/T | Sets the character encoding for ODBC 3.x source and target files. Note: Shift-JIS encoding is used only in Japanese operating systems. UCS-2 is no longer considered a valid encoding name, but you may use UCS2. In the data file, change UCS-2 to UCS2. This property is not the encoding of the database that you connect to, but it is the encoding in which the connector expects to receive SQL query statements to be sent to the database. |
CommitFrequency | T | Allows you to control how often data is committed to the database when the AutoCommit property is set to False. The default value is zero that is, the data is committed at the end of the transformation, allowing rollback on error. This is the slowest setting. When performing large transformations, this is not practical as it may produce too many transaction log entries. Specifying a nonzero value indicates that data is committed to the database after inserting or updating specified number of records. |
WhereStmt | S | Provides a pass-through mechanism for SQL connectors where advanced users can construct the Where clause of the SQL query themselves. It can be used as an alternative to writing a lengthy query statement. You may use this to instruct the SQL database server to filter the data based on a particular condition before sending it to the integration platform. There is no default value for this property. Note: This property is not applicable when the source connection is a query statement or file. This property enables data filtering when you select a table. |
SystemTables | S/T | The SystemTables property is only applicable if you are logged onto the database as the database administrator. Only the DBA has access to SystemTables. If set to true, this property allows you to see all the tables created by the DBA. The system table names appear in the table list. The default is false. |
Views | S/T | If set to True, this property allows you to see the view names in the table list along with the table names. Default is True. Note: Views in Snowflake are read-only. For more information, refer to Snowflake documentation at https://docs.snowflake.com/en/user-guide/views-introduction#label-views-introduction-limitations. |
DSNType | S/T | Data sources or drivers to connect to in the Data Source Name (DSN) list. DSNs are listed in Control Panel > Administrative Tools > ODBC Data Source Administrator window. The options are: • User & System: This is the default option. • System: This DSN allows database access for any user of a particular computer. The System DSN are stored in the Windows registry. • User: This DSN allows database access for a single user on a single computer. Like the System DSN, the information is stored in the Windows registry. • Driver: The ODBC driver to connect to. This driver must be installed on your computer. • File: This DSN stores information required to connect to the desired data source in a text file with a .DSN extension (not in the Windows registry) and can be shared by users of different computers who have the same drivers installed. For more information, see Configuring ODBC Data Source. |
AutoCommit | T | If set to True, it allows you to automatically commit changes as they are made by each SQL statement, instead of waiting until the end of the transaction. Also, if this option is set to True, you cannot roll back changes after they are done. It will overwrite the CommitFrequency value, which means that the changes are committed by each SQL statement irrespective of the value set for CommitFrequency. The default value 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. |
CursorType | S | The type of cursor to use for retrieving records from the source table. The choices available are Forward Only, Static and Dynamic. The default setting is Forward Only. For more information, see Cursors. |
DriverCompletion | S/T | Allows you to control whether or not the driver prompts you for information. The options available are Prompt, Complete (default), Complete Required and No Prompt. The Prompt option prompts you for every individual bit of information. Complete prompts you for any information they forgot to enter. The Complete Required option prompts you only for information that is essential to complete the connection. The No Prompt option does not prompt you for any information. |
IdentifierQuotes | S/T | 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 returns a syntax error that they are not separated by a comma. If either of the following values contain a space, set the identifierQuotes property on the source and the target to ““ or Default: • the value of the source connector part Table/View field. • the value of a source column name (for example, Account Number). Otherwise, if the IdentifierQuotes property is set to None, a SQL error is returned and the source table data is not displayed. IdentifierQuotes has the following options: • Default • None • " • ‘ |
ModifyDriverOptions | S/T | Allows you to store the ODBC connection. The default is true. If you set this to false, you are prompted for your connection information each time you run the transformation. |
DriverOptions | S/T | Specify a valid ODBC driver string connection. The default is empty for a new map. If there are multiple connect string options that you want to specify, use a semicolon after each string. This property can be specified or edited when one of the following is true: • The Source Data Source" is selected and the DSNType is set to "Driver". • All source connection parts are specified and the map is connected to the data. In this case, the connector builds the DriverOptions for you based on the connection parts you enter. Users can edit the pre-built options string as needed. |
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. |
TransactionIsolation (v3.x and v3.5 only) | S/T | The Translation Isolation option allows you to specify any one of five different isolation levels 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 following lists the four supported 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 any of P1, P2, and P3. For further details about TransactionIsolation levels, see the Microsoft ODBC SDK documentation. |
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). |
ArraySize | T | Determines the number of rows to be sent to the server at a time. The default value is 1000. While this improves the speed, it affects error reporting (a server error will not be detected or 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 a high value to be set, 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 BulkOperations and UseCursors is set to True or both must be set to False. If BulkOperations is False and UseCursors is True, then the array size is ignored and a message is logged indicating this condition. |
StripLeadingBlanks | S/T | Strips out leading blanks in all data fields if set to true. Default is false. Note: This property is applied to the source connector only if Source Table/View is set to Table/View. It is not applied if Source Table/View is set to Query Statement or Query Files. |
StripTrailingBlanks | S/T | Strips out trailing blanks in all data fields if set to true. Default is false. Note: This property is applied to the source connector only if Source Table/View is set to Table/View. It is not applied if Source Table/View is set to Query Statement or Query Files. |