Cache Connection Manager Editor


Applies To: SQL Server 2016

The Cache connection manager reads a reference dataset from the Cache transform or from a cache file (.caw), and can save the data to a cache file. The data is always stored in memory.

System_CAPS_ICON_note.jpg Note

The Cache connection manager does not support the Binary Large Object (BLOB) data types DT_TEXT, DT_NTEXT, and DT_IMAGE. If the reference dataset contains a BLOB data type, the component will fail when you run the package. You can use the Cache Connection Manager Editor to modify column data types.

The Lookup transformation performs lookups on the reference dataset.

The Cache Connection ManagerEditor dialog box includes the following tabs:

To learn more about the Cache Connection Manager, see Cache Connection Manager.

Use the General tab of the Cache Connection ManagerEditor dialog box to indicate whether to read the cache from a file or save the cache to a file.


Connection manager name
Provide a unique name for the cache connection in the workflow. The name provided will be displayed within SSIS Designer.

Describe the connection. As a best practice, describe the connection according to its purpose, to make packages self-documenting and easier to maintain.

Use file cache
Indicate whether to use a cache file.

System_CAPS_ICON_note.jpg Note

The protection level of the package does not apply to the cache file. If the cache file contains sensitive information, use an access control list (ACL) to restrict access to the location or folder in which you store the file. You should enable access only to certain accounts. For more information, see Access to Files Used by Packages.

If you configure the cache connection manager to use a cache file, the connection manager will do one of the following actions:

  • Save data to the file when a Cache Transform transformation is configured to write data from a data source in the data flow to the Cache connection manager. For more information, see Cache Transform.

  • Read data from the cache file.

File name
Type the path and file name of the cache file.

Locate the cache file.

Refresh Metadata
Delete the column metadata in the Cache connection manager and repopulate the Cache connection manager with column metadata from a selected cache file.

Use the Columns tab of the Cache Connection Manager Editor dialog box to configure the properties of each column in the cache.


Specify the column name.

Index Position
Specify which columns are index columns by specifying the index position of each column. The index is a collection of one or more columns.

For non-index columns, the index position is 0.

For index columns, the index position is a sequential, positive number. This number indicates the order in which the Lookup transformation compares rows in the reference dataset to rows in the input data source. The column with the most unique values should have the lowest index position.

System_CAPS_ICON_note.jpg Note

When the Lookup transformation is configured to use a Cache connection manager, only index columns in the reference dataset can be mapped to input columns. Also, all index columns must be mapped.

Specify the data type of the column.

Specifies the column data type. If applicable to the data type, you can update Length.

Specifies the precision for certain column data types. Precision is the number of digits in a number. If applicable to the data type, you can update Precision.

Specifies the scale for certain column data types. Scale is the number of digits to the right of the decimal point in a number. If applicable to the data type, you can update Scale.

Code Page
Specifies the code page for the column type. If applicable to the data type, you can update Code Page.

Lookup Transformation

Community Additions