Cache Connection Manager Editor
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.
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.
The Lookup transformation performs lookups on the reference dataset.
The Cache Connection ManagerEditor dialog box includes the following tabs:
General tab
Columns tab
To learn more about the Cache Connection Manager, see Cache Connection Manager.
General Tab
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.
Options
Connection manager name
Provide a unique name for the cache connection in the workflow. The name provided will be displayed within SSIS Designer.Description
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.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 Controlling 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.Browse
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.
Columns Tab
Use the Columns tab of the Cache Connection Manager Editor dialog box to configure the properties of each column in the cache.
Options
Column
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.
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.
Type
Specify the data type of the column.Length
Specifies the column data type. If applicable to the data type, you can update Length.Precision
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.Scale
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.