Changes the name of an existing connection. When you use SwitchConnection, the Repository Service replaces the relational database connections for all sessions using the connection in one of the following locations:
Connection Information property in Lookup transformations
Connection Information property in Stored Procedure transformations
$Source Connection Value session property
$Target Connection Value session property
If the repository contains both relational and application connections with the same name and you specified the connection type as relational in
locations in the repository, the Repository Service replaces the relational connection.
For example, you have a relational and an application source, each called ITEMS. In a session, you specified the name ITEMS for a relational source connection instead of Relational:ITEMS. When you use SwitchConnection to replace the relational connection ITEMS with another relational connection,
does not replace any relational connection in the repository because it cannot determine the connection type for the source connection entered as ITEMS.
The SwitchConnection command uses the following syntax: