Creates a source or target connection in the repository. The connection can be a relational, application, or an FTP connection. Relational database connections for each relational subtype require a subset of all CreateConnection options and arguments. For example, Oracle connections do not accept the -z, -d, or -t options. Use the -k option to specify attributes for application connections.
The CreateConnection command uses the following syntax:
createconnection
-s <connection_subtype>
-n <connection_name>
[{-u <user_name>
[{-p <password> |
-P <password_environment_variable>
[-w (use parameter in password)]}]}]|
-K <connection_to_the_Kerberos_server>]
[-c <connect_string> (required for Oracle, Informix, DB2, Microsoft SQL Server, 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 (1 for ODBC and 2 for OLEDB), valid for MS SQL Server connection only)]
[-m (UseDSN, valid for MS SQL Server connection only)]
[-S <odbc_subtype> (valid for ODBC connection only, default is None)]
[-E <Encryption Method> (valid for MS SQL Server connection only)]
[-L <TLSv1.2> (valid for MS SQL Server connection only)]
[-M <TLSv1.3> (valid for MS SQL Server connection only)]
[-V <Validate Server Certificate> (valid for MS SQL Server connection only)]
[-T <Trust Store> (valid for Sybase ASE connection)]
[-U <Trust Store Password> (valid for MS SQL Server connection only)]
[-H <Host Name in Certificate> (valid for MS SQL Server connection only)]
The following table describes
pmrep
CreateConnection options and arguments:
| |
Required. Displays the connection subtype.
A connection can be one of the following types:
Application
FTP
Relational
For example, for a Relational connection, connection subtypes include Oracle, Sybase, and Microsoft SQL Server. For FTP connections, the valid subtype is FTP.
|
| |
Required. Name of the connection.
|
| |
Required for some connection types. User name used for authentication.
|
| |
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.
To specify a parameter in the password, add the $Param prefix for the -p option and ensure that you use the -w option. Do not use a dollar sign ($) anywhere else in the -p option, and enter the parameter password without spaces. For example, -p '$Param_abc' -w
|
| |
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.
|
| -
|
Optional. Enables you to use a parameter in the password option.
pmrep uses the password specified with the -p or -P option as the name of the session parameter at run time.
Valid only if you use the -p or -P option.
If you do not use a parameter in the password option,
pmrep uses the user password specified with the -p or -P option.
|
-K
|
connection_to_the_Kerberos_server
|
Optional. Indicates that the database that you are connecting to runs on a network that uses Kerberos authentication.
|
| |
Connect string the Integration Service uses to connect to the relational database.
|
| |
Required for some connection types. Code page associated with the connection.
|
| |
Optional. Valid for Oracle connections. The name of the rollback segment. A rollback segment records database transactions that allow you to undo the transaction.
|
| |
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.
|
| |
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.
|
| |
Optional. Valid for Sybase ASE and Microsoft SQL Server connections. Optimizes the ODBC connection to Sybase ASE and Microsoft SQL Server.
|
| |
Optional. Name of the database. Valid for Sybase ASE and Microsoft SQL Server connections.
|
| |
Optional Name of the database server. Valid for Sybase ASE and Microsoft SQL Server connections.
|
| |
Optional Valid for Microsoft SQL Server connections. The name of the domain. Used for Microsoft SQL Server.
|
| |
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.
|
| |
Optional Teradata ODBC data source name. Valid for Teradata connections.
|
| |
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.
|
| |
Enables user-defined connection attributes. Attributes have the format <name>=<value>;<name>=<value>.
Do not add a space before the attribute name.
|
| |
Enables the provider type value. You can specify the following provider types:
1 for ODBC
2 for Oledb(Deprecated)
|
| |
Enables the Use DSN attribute.
The PowerCenter Integration Service retrieves the database and server names from the DSN.
|
| |
Optional. Enables the ODBC subtype for an ODBC connection.
An ODBC connection can be one of the following ODBC subtypes:
AWS Redshift
Azure DW
Greenplum
Google Big Query
PostgreSQL
Snowflake
SAP HANA
None
|
-E | Encryption Method | Optional. Valid for Microsoft SQL Server connection. The method that
the driver uses to encrypt the data sent between the driver and the
database server. The encryption method options include None and
Strict. |
-L | TLSv1.2 | Optional if you set the Strict encryption method for Microsoft SQL Server connection.
Enables version 1.2 of the Transport Layer Security (TLS) protocol for
enhanced encryption and security for data in transit. |
-M | TLSv1.3 | Optional if you set the Strict encryption method for Microsoft SQL Server connection.
Enables version 1.3 of the Transport Layer Security (TLS) protocol for
enhanced encryption and security for data in transit. |
-V | Validate Server Certificate | Required if you set the Strict encryption method for Microsoft SQL Server connection.
Determines whether the driver validates the certificate sent by the
database server when you enable secure communication. Enables the driver
to validate the server certificate. |
-T | Trust Store | Required if you set the Strict encryption method for Microsoft SQL Server connection.
Valid for Sybase ASE and Microsoft SQL Server connection. The location
and name of the trust store file. The trust store file contains a list
of Certificate Authorities (CAs) that the driver uses for secure
communication. |
-U | Trust Store Password | Required if you set the Strict encryption method. Valid for Microsoft
SQL Server connection. The password to access the contents of the trust
store file. |
-H | Host Name in Certificate | Required if you set the Strict encryption method. Valid for Microsoft SQL Server
connection. The host name that the driver uses to validate the host name
contained in the certificate using secure communication. |
