Share via

Cache Connection Manager

  • Article

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

The Cache Transform transformation writes data from a connected data source in the data flow to a Cache connection manager. The Lookup transformation in a package performs lookups on the data.

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. For more information, see Cache Connection Manager Editor.

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.

Configuration of the Cache Connection Manager

You can configure the Cache connection manager in the following ways:

  • Indicate whether to use a cache file.

    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.

    • Read data from the cache file.

    For more information, see Cache Transform.

  • Change metadata for the columns stored in the cache.

  • Update the cache file name at runtime by using an expression to set the ConnectionString property. For more information, see Use Property Expressions in Packages.

You can set properties through Integration Services Designer or programmatically.

For more information about the properties that you can set in Integration Services Designer, see Cache Connection Manager Editor.

For information about how to configure a connection manager programmatically, see ConnectionManager and Adding Connections Programmatically.

Implement a Lookup Transformation in Full Cache Mode Using the Cache Connection Manager