Shared Content for Data Engineering
All Products
createconnection -s <connection_type> -n <connection_name> [{-u <user_name> [-p <password> | -P <password_environment_variable>}]| -K <connection_to_the_Kerberos_server>] [-c <connect string> (required for Oracle, Informix, DB2, ODBC, and NetezzaRelational)] -l <code_page> [-r <rollback_segment> (valid for Oracle connection only)] [-e <connection_environment_SQL>] [-f <transaction_environment_SQL>] [-z <packet_size> (valid for Sybase ASE and MS SQL Server connection)] [-b <database_name> (valid for Sybase ASE, Teradata and MS SQL Server connection)] [-v <server_name> (valid for Sybase ASE and MS SQL Server connection)] [-d <domain name> (valid for MS SQL Server connection only)] [-t (enable_trusted_connection, valid for MS SQL Server connection only)] [-a <data_source_name> (valid for Teradata connection only)] [-x (enable advanced security, lets users give Read, Write and Execute permissions only for themselves.)] [-k <connection_attributes> (attributes have the format name=value;name=value; and so on)] [- y <Provider Type, valid for MS SQL Server connection only>] [- m <Use DSN, valid for MS SQL Server connection only>]
Option
| Argument
| Description
|
---|---|---|
-s
| connection_type
| Required. Type of connection. For example, to create a Salesforce connection, use the following syntax:
|
-n
| connection_name
| Required. Name of the connection.
|
-u
| user_name
| Required for some connection types. User name used for authentication.
|
-p
| password
| Required for some connection types. Password used for authentication when you connect to the relational database. Use the -p or -P option, but not both. If you specify a user name and you do not specify -p or -P, pmrep prompts you for the password.
|
-P
| password_
environment_variable
| Optional. Password environment variable used for authentication when you connect to the relational database. Use the -p or -P option, but not both. If you do not use the -p or -P option,
pmrep prompts you for the password.
|
-K
| connection_to_the_Kerberos_server
| Optional. Indicates that the database that you are connecting to runs on a network that uses Kerberos authentication.
|
-c
| connect_string
| Connect string the Integration Service uses to connect to the relational database.
|
-l
| code_page
| Required for some connection types. Code page associated with the connection.
|
-r
| rollback_segment
| Optional. Valid for Oracle connections. The name of the rollback segment. A rollback segment records database transactions that allow you to undo the transaction.
|
-e
| connection_
environment_sql
| Optional. Enter SQL commands to set the database environment when you connect to the database. The Integration Service executes the connection environment SQL each time it connects to the database.
|
-f
| transaction_
environment_sql
| Optional. Enter SQL commands to set the database environment when you connect to the database. The Integration Service executes the transaction environment SQL at the beginning of each transaction.
|
-z
| packet_size
| Optional. Valid for Sybase ASE and Microsoft SQL Server connections. Optimizes the ODBC connection to Sybase ASE and Microsoft SQL Server.
|
-b
| database_name
| Optional. Name of the database. Valid for Sybase ASE and Microsoft SQL Server connections.
|
-v
| server_name
| Optional Name of the database server. Valid for Sybase ASE and Microsoft SQL Server connections.
|
-d
| domain_name
| Optional Valid for Microsoft SQL Server connections. The name of the domain. Used for Microsoft SQL Server.
|
-t
| -
| Optional. Valid for Microsoft SQL Server connections. If enabled, 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.
|
-a
| data_source_name
| Optional Teradata ODBC data source name. Valid for Teradata connections.
|
-x
| -
| Enables enhanced security. Grants you read, write, and execute permissions. Public and world groups are not granted any permissions. If this option is not enabled, all groups and users are granted read, write, and execute permissions.
|
-k
| connection_attributes
| Enables user-defined connection attributes. Attributes have the format <name>=<value>;<name>=<value>.
Do not add a space before the attribute name.
|
-y
| connection_attributes
| Enables the provider type value. You can specify the following provider types:
|
-m
| connection_attributes
| Enables the Use DSN attribute.
The PowerCenter Integration Service retrieves the database and server names from the DSN.
|
Updated February 12, 2021