Command Reference > infacmd sql Command Reference > UpdateSQLDataServiceOptions
  

UpdateSQLDataServiceOptions

Updates SQL data service properties. You must stop the SQL data service before you update the properties.
The infacmd sql UpdateSQLDataServiceOptions command uses the following syntax:
UpdateSQLDataServiceOptions

<-DomainName|-dn> domain_name

<-ServiceName|-sn> service_name

<-UserName|-un> user_name

<-Password|-pd> password

[<-SecurityDomain|-sdn> security_domain]

[<-ResilienceTimeout|-re> timeout_period_in_seconds]

<-SQLDataService|-sqlds> sql_data_service

<-Options|-o> options
The following table describes infacmd sql UpdateSQLDataServiceOptions options and arguments:
Option
Argument
Description
-DomainName
-dn
domain_name
Required. Name of the Informatica domain. You can set the domain name with the -dn option or the environment variable INFA_DEFAULT_DOMAIN. If you set a domain name with both methods, the -dn option takes precedence.
-ServiceName
-sn
service_name
Required. Name of the Data Integration Service where the application is deployed.
-UserName
-un
user_name
Required if the domain uses Native or LDAP authentication. User name to connect to the domain. You can set the user name with the -un option or the environment variable INFA_DEFAULT_DOMAIN_USER. If you set a user name with both methods, the -un option takes precedence.
Optional if the domain uses Kerberos authentication. To run the command with single sign-on, do not set the user name. If you set the user name, the command runs without single sign-on.
-Password
-pd
password
Required if you specify the user name. Password for the user name. The password is case sensitive. You can set a password with the -pd option or the environment variable INFA_DEFAULT_DOMAIN_PASSWORD. If you set a password with both methods, the password set with the -pd option takes precedence.
-SecurityDomain
-sdn
security_domain
Required if the domain uses LDAP authentication. Optional if the domain uses native authentication or Kerberos authentication. Name of the security domain to which the domain user belongs. You can set a security domain with the -sdn option or the environment variable INFA_DEFAULT_SECURITY_DOMAIN. If you set a security domain name with both methods, the -sdn option takes precedence. The security domain name is case sensitive.
If the domain uses native or LDAP authentication, the default is Native. If the domain uses Kerberos authentication, the default is the LDAP security domain created during installation. The name of the security domain is the same as the user realm specified during installation.
-ResilienceTimeout
-re
timeout_period_in_seconds
Optional. Amount of time in seconds that infacmd attempts to establish or re-establish a connection to the domain. You can set the resilience timeout period with the -re option or the environment variable INFA_CLIENT_RESILIENCE_TIMEOUT. If you set the resilience timeout period with both methods, the -re option takes precedence.
-SQLDataService
-sqlds
sql_data_service
Required. Name of the SQL data service.
You must prefix the SQL data service name with the application name.
Use the following syntax:
<application_name>.<SQL_data_service_name>
options
-o
options
Required. List of options to update. Enter options and values separated by spaces. To view options for a SQL data service, run infacmd sql ListSQLDataServiceOptions.

SQL Data Service Options

Use SQL data service options to update a SQL data service. Use the SQL data service options with the infacmd sql UpdateSQLDataServiceOptions command.
Enter SQL data service options in the following format:
... -o SQLDataServiceOptions.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 connection options for infacmd sql UpdateSQLDataServiceOptions:
Option
Description
SQLDataServiceOptions.startupType
Determines whether the SQL data service is enabled to run when the application starts or when you start the SQL data service. Enter ENABLED to allow the SQL data service to run. Enter DISABLED to prevent the SQL data service from running.
SQLDataServiceOptions.traceLevel
Level of error messages written to the session log. Specify one of the following message levels:
  • - Fatal
  • - Error
  • - Info
  • - Trace
  • - Debug
SQLDataServiceOptions.connectionTimeout
Maximum number of milliseconds to wait for a connection to the SQL data service. Default is 3,600,000.
SQLDataServiceOptions.requestTimeout
Maximum number of milliseconds for a SQL request to wait for a SQL Data Service response. Default is 3,600,000.
SQLDataServiceOptions.sortOrder
Sort order that the Data Integration Service uses for sorting and comparing data when running in Unicode mode. You can choose the sort order based on your code page. When the Data Integration runs in ASCII mode, it ignores the sort order value and uses a binary sort order. Default is binary.
SQLDataServiceOptions.maxActiveConnections
Maximum number of active connections to the SQL data service. Default is 10.
SQLDataServiceOptions.ResultSetCacheExpirationPeriod
The number of milliseconds that the result set cache is available for use. If set to -1, the cache never expires. If set to 0, result set caching is disabled. Changes to the expiration period do not apply to existing caches. If you want all caches to use the same expiration period, purge the result set cache after you change the expiration period. Default is 0.
SQLDataServiceOptions.DTMKeepAliveTime
Number of milliseconds that the DTM instance stays open after it completes the last request. Identical SQL queries can reuse the open instance. Use the keep alive time to increase performance when the time required to process the SQL query is small compared to the initialization time for the DTM instance. If the query fails, the DTM instance terminates.
Must be an integer. A negative integer value means that the DTM Keep Alive Time for the Data Integration Service is used. 0 means that the Data Integration Service does not keep the DTM instance in memory. Default is -1.
SQLDataServiceOptions.optimizeLevel
The optimizer level that the Data Integration Service applies to the object. Enter the numeric value that is associated with the optimizer level that you want to configure. You can enter one of the following numeric values:
  • - 0. The Data Integration Service does not apply optimization.
  • - 1. The Data Integration Service applies the early projection optimization method.
  • - 2. The Data Integration Service applies the early projection, early selection, push-into, and predicate optimization methods.
  • - 3. The Data Integration Service applies the cost-based, early projection, early selection, push-into, predicate, and semi-join optimization methods.