Table of Contents

Search

  1. Preface
  2. Command Line Programs and Utilities
  3. Installing and Configuring Command Line Utilities
  4. Using the Command Line Programs
  5. Environment Variables for Command Line Programs
  6. Using infacmd
  7. infacmd as Command Reference
  8. infacmd aud Command Reference
  9. infacmd autotune Command Reference
  10. Infacmd bg Command Reference
  11. infacmd ccps Command Reference
  12. infacmd cluster Command Reference
  13. infacmd cms Command Reference
  14. infacmd dis Command Reference
  15. infacmd dp Command Reference
  16. infacmd idp Command Reference
  17. infacmd edp Command Reference
  18. Infacmd es Command Reference
  19. infacmd ihs Command Reference
  20. infacmd ipc Command Reference
  21. infacmd isp Command Reference
  22. infacmd ldm Command Reference
  23. infacmd mas Command Reference
  24. infacmd mi Command Reference
  25. infacmd mrs Command Reference
  26. infacmd ms Command Reference
  27. infacmd oie Command Reference
  28. infacmd ps Command Reference
  29. infacmd pwx Command Reference
  30. infacmd roh Command Reference
  31. infacmd rms Command Reference
  32. infacmd rtm Command Reference
  33. infacmd sch Command Reference
  34. infacmd search Command Reference
  35. infacmd sql Command Reference
  36. infacmd tdm Command Reference
  37. infacmd tools Command Reference
  38. infacmd wfs Command Reference
  39. infacmd ws Command Reference
  40. infacmd xrf Command Reference
  41. infacmd Control Files
  42. infasetup Command Reference
  43. pmcmd Command Reference
  44. pmrep Command Reference
  45. Working with pmrep Files

Microsoft SQL Server Connection Options

Microsoft SQL Server Connection Options

Use connection options to define the Microsoft SQL Server connection.
Enter connection options in the following format:
... -o option_name=value option_name=value ...
To enter multiple options, separate them with a space. To enter a value that contains a space or other non-alphanumeric character, enclose the value in quotation marks.
The following table describes Microsoft SQL Server connection options for the infacmd isp CreateConnection and UpdateConnection commands:
Option
Description
UseTrustedConnection
Optional. The Integration Service uses Windows authentication to access the Microsoft SQL Server database. The user name that starts the Integration Service must be a valid Windows user with access to the Microsoft SQL Server database. True or false. Default is false.
PassThruEnabled
Optional. Enables pass-through security for the connection. When you enable pass-through security for a connection, the domain uses the client user name and password to log into the corresponding database, instead of the credentials defined in the connection object.
MetadataAccessConnectString
JDBC connection URL to access metadata from the database.
Use the following connection URL:
jdbc:informatica:sqlserver://<host name>:<port>;DatabaseName=<database name>
To test the connection with NTLM authentication, include the following parameters in the connection string:
  • AuthenticationMethod. The NTLM authentication version to use.
    UNIX supports NTLMv1 and NTLMv2 but not NTLM.
  • Domain. The domain that the SQL server belongs to.
The following example shows the connection string for an SQL server that uses NTLMv2 authentication in an NT domain named Informatica.com:
jdbc:informatica:sqlserver://host01:1433;DatabaseName=SQL1;AuthenticationMethod=ntlm2java;Domain=Informatica.com
If you connect with NTLM authentication, you can enable the
Use trusted connection
option in the MS SQL Server connection properties. If you connect with NTLMv1 or NTLMv2 authentication, you must provide the user name and password in the connection properties.
AdvancedJDBCSecurityOptions
Optional. Database parameters for metadata access to a secure database. Informatica treats the value of the AdvancedJDBCSecurityOptions field as sensitive data and encrypts the parameter string.
To connect to a secure database, include the following parameters:
  • EncryptionMethod. Required. Indicates whether data is encrypted when transmitted over the network. This parameter must be set to SSL.
  • ValidateServerCertificate. Optional. Indicates whether Informatica validates the certificate that is sent by the database server.
    If this parameter is set to True, Informatica validates the certificate that is sent by the database server. If you specify the HostNameInCertificate parameter, Informatica also validates the host name in the certificate.
    If this parameter is set to false, Informatica does not validate the certificate that is sent by the database server. Informatica ignores any truststore information that you specify.
  • HostNameInCertificate. Optional. Host name of the machine that hosts the secure database. If you specify a host name, Informatica validates the host name included in the connection string against the host name in the SSL certificate.
  • TrustStore. Required. Path and file name of the truststore file that contains the SSL certificate for the database.
  • TrustStorePassword. Required. Password for the truststore file for the secure database.
For a complete list of the secure JDBC parameters, see the DataDirect JDBC documentation.
Informatica appends the secure JDBC parameters to the connection string. If you include the secure JDBC parameters directly to the connection string, do not enter any parameters in the AdvancedJDBCSecurityOptions field.
DataAccessConnectString
Required. Connection string used to access data from the database.
Enter the connection string in the following format:
<server name>@<database name>
DomainName
Optional. The name of the domain where Microsoft SQL Server is running.
PacketSize
Optional. Increase the network packet size to allow larger packets of data to cross the network at one time.
CodePage
Required. Code to read from or write to the database. Use the ISO code page name, such as ISO-8859-6. The code page name is not case sensitive.
UseDSN
Required. Determines whether the Data Integration Service must use the Data Source Name for the connection.
If you set the option value to true, the Data Integration Service retrieves the database name and server name from the DSN.
If you set the option value to false, you must enter the database name and server name.
ProviderType
Required. The connection provider that you want to use to connect to the Microsoft SQL Server database.
You can define one of the following values:
  • 0. Set the value to 0 if you want to use the ODBC provider type. Default is 0.
  • 1. Set the value to 1 if you want to use the OLEDB provider type.
OwnerName
Optional. The table owner name.
SchemaName
Optional. The name of the schema in the database. You must specify the schema name for the Profiling Warehouse if the schema name is different from the database user name. You must specify the schema name for the data object cache database if the schema name is different from the database user name and if you configure user-managed cache tables.
EnvironmentSQL
Optional. SQL commands to set the database environment when you connect to the database. The Data Integration Service executes the connection environment SQL each time it connects to the database.
For example,
ALTER SESSION SET CURRENT_SCHEMA=INFA_USR;
Enclose special characters in double quotes.
TransactionSQL
Optional. SQL commands to execute before each transaction. The Data Integration Service executes the transaction SQL at the beginning of each transaction.
For example,
SET TRANSACTION ISOLATION LEVEL SERIALIZABLE;
Enclose special characters in double quotes.
QuoteChar
Optional. The character that you will use for quotes in this connection.
The type of character used to identify special characters and reserved SQL keywords, such as WHERE. The Data Integration Service places the selected character around special characters and reserved SQL keywords. The Data Integration Service also uses this character for the QuoteChar property. Default is 0.
EnableQuotes
Optional. Choose to enable quotes or not for this connection.
When enabled, the Data Integration Service places identifier characters around table, view, schema, synonym, and column names when generating and executing SQL against these objects in the connection. Use if the objects have mixed-case or lowercase names. Valid values are True or False. Default is True.
EnableConnectionPool
Optional. Enables connection pooling. When you enable connection pooling, the connection pool retains idle connection instances in memory. When you disable connection pooling, the Data Integration Service stops all pooling activity. Valid values are True or False. Default is True.
ConnectionPoolSize
Optional. Maximum number of idle connections instances that the Data Integration Service maintains for a database connection. Set this value to be more than the minimum number of idle connection instances. Default is 15.
ConnectionPoolMaxIdleTime
Optional. Number of seconds that a connection exceeding the minimum number of connection instances can remain idle before the connection pool drops it. The connection pool ignores the idletime when it does not exceed the minimum number of idle connection instances. Default is 120.
ConnectionPoolMinConnections
Optional. Minimum number of idle connection instances that the pool maintains for a database connection. Set this value to be equal to or less than the idle connection pool size. Default is 0.


Updated July 02, 2020