Add, Delete, or Share a Connection Manager in a Package
Applies To: SQL Server 2016
Integration Services includes a variety of connection managers for connecting to different data sources, such as relational databases, Analysis Services databases, and files in CSV and XML formats. A connection manager can be created at the package level or at the project level. The connection manager created at the project level is available all the packages in the project. Whereas, connection manager created at the package level is available to that specific package.
You use connection managers that are created at the project level in place of data sources, to share connections to sources. To add a connection manager at the project level, the Integration Services project must use the project deployment model. When a project is configured to use this model, the Connection Managers folder appears in Solution Explorer, and the Data Sources folder is removed from Solution Explorer.
Note
If you want to use data sources in your package, you need to convert the project to the package deployment model.
For more information about the two models, see Deployment of Projects and Packages. For more information about converting a project to the project deployment model, see Deploy Projects to Integration Services Server.
The following procedures apply to all types of connection managers and describe how to do the following tasks:
To add a connection manager when creating a package
To add a connection manager to an existing package
To add a connection manager at the project level
To create a parameter for a connection manager property
To delete a connection manager from a package
To delete a shared connection manager (project level connection manager)
To add a connection manager when creating a package
Use the SQL Server Import and Export Wizard
In addition to creating and configuring a connection manager, the wizard also helps you create and configure the sources and destinations that use the connection manager. For more information, see Create Packages in SQL Server Data Tools.
To add a connection manager to an existing package
In SQL Server Data Tools (SSDT), open the Integration Services project that contains the package you want.
In Solution Explorer, double-click the package to open it
In SSIS Designer, click the Control Flow tab, the Data Flow tab, or the Event Handler tab to make the Connection Managers area available.
Right-click anywhere in the Connection Managers area, and then do one of the following:
Click the connection manager type to add to the package.
—or—
If the type that you want to add is not listed, click New Connection to open the Add SSIS Connection Manager dialog box, select a connection manager type, and then click OK.
The custom dialog box for the selected connection manager type opens. For more information about connection manager types and the options that are available, see the following options table.
The Connection Managers area lists the added connection manager.
Optionally, right-click the connection manager, click Rename, and then modify the default name of the connection manager.
To save the updated package, click Save Selected Item on the File menu.
To add a connection manager at the project level
In SQL Server Data Tools (SSDT), open the Integration Services project.
In Solution Explorer, right-click Connection Managers, and click New Connection Manager.
In the Add SSIS Connection Manager dialog box, select the type of connection manager, and then click Add.
The custom dialog box for the selected connection manager type opens. For more information about connection manager types and the options that are available, see the following options table.
The connection manager you added will show up under the Connections Managers node in the Solution Explorer. It will also appear in the Connection Managers tab in the SSIS Designer window for all the packages in the project. The name of the connection manager in this tab will have a (project) prefix in order to differentiate this project level connection manager from the package level connection managers.
Optionally, right-click the connection manager in the Solution Explorer window under Connection Managers node (or) in the Connection Managers tab of the SSIS Designer window, click Rename, and then modify the default name of the connection manager.
Note
In the Connection Managers tab of the SSIS Designer window, you won’t be able to overwrite the (project) prefix from the connection manager name. This is by design.
To create a parameter for a connection manager property
In the Connection Managers area, right-click the connection manager that you want to create a parameter for and then click Parameterize.
Configure the parameter settings in the Parameterize dialog box. For more information, see Parameterize Dialog Box.
To delete a connection manager from a package
In SQL Server Data Tools (SSDT), open the Integration Services project that contains the package you want.
In Solution Explorer, double-click the package to open it.
In SSIS Designer, click the Control Flow tab, the Data Flow tab, or the Event Handler tab to make the Connection Managers area available.
Right-click the connection manager that you want to delete, and then click Delete.
If you delete a connection manager that a package element, such as an Execute SQL task or an OLE DB source, uses, you will experience the following results:
An error icon appears on the package element that used the deleted connection manager.
The package fails to validate.
The package cannot be run.
To save the updated package, click Save Selected Items on the File menu.
To delete a shared connection manager (project level connection manager)
To delete a project-level connection manager, right-click the connection manager under Connection Managers node in the Solution Explorer window, and then click Delete. SQL Server Data Tools displays the following warning message:
Warning
When you delete a project connection manager, packages that use the connection manager might not run. You cannot undo this action. Do you want to delete the connection manager?Click OK to delete the connection manager or Cancel to keep it.
Note
You can also delete a project level connection manager from the Connection Manager tab of the SSIS Designer window opened for any package in the project. You do so by right-clicking the connection manager in the tab and then by clicking Delete.
See Also
Integration Services (SSIS) Connections
Set the Properties of a Connection Manager