User Guide : Map Connectors : Source and Target Map Connectors : Microsoft SQL Azure Multimode
 
Share this page             
Microsoft SQL Azure Multimode
Microsoft SQL Azure Database is a cloud-based relational database management service that is based on SQL Server database technologies. Microsoft provides the physical administration of the database management service through its distribution data center.
You can use the Microsoft SQL Azure Multimode connector to write Microsoft SQL Azure database tables. It is not available as a source connector.
Connector-Specific Notes
Connectivity
To connect to a data table in a Microsoft SQL Azure database, you must have SQL Server 2008 Native Client installed on your server.
You can use an EZScript to auto-generate a GUID for a variable declared as the uniqueidentifier data type. See Generating a Random Unique Identifier.
To connect to a Microsoft SQL Azure database, enter the name of the server that is hosting the software, your user ID, password (if needed), and database name.
The name of the server must be the fully qualified instance name in the format: instancename.database.windows.net
where instancename is the unique name of your instance.
For example: tcp:myinstancename.database.windows.net
Note:  The Microsoft SQL Azure Multimode connector makes a direct connection to the Microsoft SQL Azure ODBC driver. No DSN is required.
Target schema modification
Modification to column names, data types, and sizes are not permitted.
Query statement support
Microsoft SQL Azure supports most Transact-SQL statements. For a complete list of unsupported Transact-SQL statements, go to http://msdn.microsoft.com/en-us/library/ee336281.aspx.
The target format must support query statements for transformation to work with this connector.
Property Options
You can set the following source (S) and target (T) properties.
Property
S/T
Description
Autocommit
T
Allows automatic commitment of changes as they are made by each SQL statement, instead of waiting until the end of the transaction. If set to true, you cannot roll back changes. Default is false.
Encoding
T
Character encoding used with XML source and target files.
Note:  Shift-JIS encoding is used only in Japanese operating systems. UCS-2 is no longer a valid encoding name, but you may use UCS2 by changing the string value in the XML file.
Default is OEM.
MaxDataLength
T
Maximum data length for long data types. Default is 1 MB. You can reset this number based on available memory and target 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 1 MB, the integration platform presets the default in respect for the capabilities of that particular ODBC driver, and it is not recommended to set MaxDataLength any higher.
Default is 1048576
SQL Log
T
The default is sql.log in the default installation directory. To use a different log, browse to the file or enter the path and file name.
SQL Output
T
Allows you to select bound or unbound mode and whether you want to write SQL statements to a SQL log or not. Keep in mind that bound mode is faster, since bind variables are used. Target Only is the default output:
Target Only - Uses bound mode, which uses bind variables. SQL statements are sent to the Target and not to the SQL log specified in the SQL Log property.
Target Only (Unbound mode) - Uses unbound mode, which does not use bind variables and sends the literal SQL statement to the database engine. SQL statements are sent to the Target and not to the SQL log specified in the SQL Log property.
Target and SQL Log - Sends SQL statements to the Target and to the SQL log specified in the SQL Log property.
SQL Log Only - Sends SQL statements only to the SQL log file specified in the SQL Log property.
SystemTables
T
If set to true, this property 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.
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
T
Allows setting of the transaction isolation level for reading or writing tables.
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 isolation levels are supported. Default is Serializable.
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 (default)– Does not permit any of P1, P2, and P3
For more information, see the Microsoft ODBC SDK documentation.
UpdateNullFields
T
Null values are sent to the database when inserting or updating records. The default is true. If you select False, null values are not sent to the database when you insert or update records. When set to false, this property forces the connector to operate in unbound mode, which may cause slower performance.
Best Practice — If fields in the target record are not mapped, then the null values are passed to the target. If you do not want to write to these fields, then it is recommended to set the value for UpdateNullFields to False.
Views
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:  This property supports only Append and DeleteAndAppend output modes and does not support the Replace output mode.
IdentifierQuotes
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 return a syntax error that they are not separated by a comma.
IdentifierQuotes has four options:
Default
None
"
'
Data Types
The following data types (the types of the fields in a table) are supported:
bigint
bigint identity
binary
bit
char
date
datetime
datetime2
datetimeoffset
decimal
decimal() identity
float
image
int
int identity
money
nchar
ntext
nvarchar
numeric
numeric() identity
real
smalldatetime
smallint
smallint identity
smallmoney
sql_variant
sysname
text
time
timestamp
tinyint
tinyint identity
uniqueidentifier
varbinary
varchar
xml