Transformación Búsqueda en el modo Caché completa - Administrador de conexiones de caché
Se aplica a: 
SQL Server SSIS Integration Runtime en Azure Data Factory
Puede configurar la transformación de búsqueda para utilizar el modo de caché completa y un Administrador de conexiones de caché. En el modo de caché completa, el conjunto de datos de referencia se carga en la memoria caché antes de que se ejecute la transformación Búsqueda.
Nota
El administrador de conexiones de caché no admite los tipos de datos de objetos binarios grandes (BLOB) DT_TEXT, DT_NTEXT y DT_IMAGE. Si el conjunto de datos de referencia contiene un tipo de datos BLOB, se producirá un error en el componente al ejecutar el paquete. Puede utilizar el Editor del administrador de conexiones de caché para modificar los tipos de datos de columna. Para obtener más información, vea Cache Connection Manager Editor.
La transformación Búsqueda realiza búsquedas mediante la combinación de datos de las columnas de entrada procedentes de un origen de datos conectado con columnas de un conjunto de datos de referencia. Para más información, consulte Lookup Transformation.
Puede elegir entre las siguientes opciones para generar un conjunto de datos de referencia:
Archivo caché (.caw)
Se configura el administrador de conexiones de caché para leer los datos de un archivo caché existente.
Origen de datos conectado en el flujo de datos
Se utiliza una transformación de caché para escribir los datos procedentes de un origen de datos conectado del flujo de datos en un administrador de conexiones de caché. Los datos siempre se almacenan en memoria.
Debe agregar la transformación Búsqueda a un flujo de datos independiente. Esto permite a la transformación de caché rellenar el administrador de conexiones de caché antes de que se ejecute la transformación Búsqueda. Los flujos de datos pueden estar en el mismo paquete o en dos paquetes independientes.
Si los flujos de datos están en el mismo paquete, utilice una restricción de precedencia para conectar los flujos de datos. Esto permite a la transformación de caché ejecutarse antes de que se ejecute la transformación Búsqueda.
Si los flujos de datos están en paquetes independientes, puede utilizar la tarea Ejecutar paquete para llamar al paquete secundario desde el paquete primario. Puede llamar a varios paquetes secundarios si agrega varias tareas Ejecutar Paquete a una tarea del contenedor de secuencias del paquete primario.
Puede compartir el conjunto de datos de referencia almacenado en caché entre varias transformaciones Búsqueda si utiliza uno de los métodos siguientes:
Configurar las transformaciones Búsqueda de un único paquete para utilizar el mismo administrador de conexiones de caché.
Configurar los administradores de conexiones de caché en paquetes diferentes para utilizar el mismo archivo caché.
Para obtener más información, vea los temas siguientes:
Para ver un vídeo donde se muestra cómo implementar una transformación de búsquedas en el modo de caché completa con el Administrador de conexiones de caché, visite Cómo implementar una transformación Búsqueda en modo de memoria caché completa (vídeo de SQL Server).
Implementar una transformación Búsqueda en el modo de caché completa en un paquete utilizando el Administrador de conexiones de caché y un origen de datos del flujo de datos
En SQL Server Data Tools (SSDT), abra un proyecto Integration Services y, a continuación, abra un paquete.
En la pestaña Flujo de control , agregue dos tareas Flujo de datos y conéctelas utilizando un conector verde:
En el primer flujo de datos, agregue una transformación de caché y, a continuación, conéctela a un origen de datos.
Configure el origen de datos según sea necesario.
Haga doble clic en la transformación de caché y, después, en el Editor de transformación Caché, en la página Administrador de conexiones , haga clic en Nuevo para crear un administrador de conexiones de caché.
Haga clic en la pestaña Columnas del cuadro de diálogo Editor del administrador de conexiones de caché y, a continuación, utilice la opción Posición de índice para especificar cuáles son las columnas de índice.
Para las columnas de no índice, la posición de índice es 0. Para las columnas de índice, la posición de índice es un número secuencial positivo.
Nota
Cuando la transformación Búsqueda se configura para utilizar un administrador de conexiones de caché, a las columnas de entrada solo se les puede asignar las columnas de índice del conjunto de datos de referencia. Asimismo, todas las columnas de índice deben estar asignadas. Para obtener más información, vea Cache Connection Manager Editor.
Para guardar la memoria caché en un archivo, en el Editor del administrador de conexiones de caché, en la pestaña General , configure el administrador a través de las opciones siguientes:
Seleccione Utilizar la caché del archivo.
En Nombre de archivo, escriba la ruta de acceso al archivo o haga clic en Examinar para seleccionar el archivo.
Si escribe una ruta de acceso para un archivo que no existe, el sistema crea el archivo al ejecutar el paquete.
Nota
El nivel de protección del paquete no se aplica al archivo caché. Si el archivo caché contiene información confidencial, utilice una lista de control de acceso (ACL) para restringir el acceso a la ubicación o carpeta en la que almacena el archivo. Solo debería permitir el acceso a ciertas cuentas. Para más información, vea Acceso a los archivos usados por los paquetes.
Configure la transformación de caché según sea necesario. Para obtener más información, vea Editor de transformación Caché (página Administrador de conexiones) y Editor de transformación Caché (página Asignaciones).
En el segundo flujo de datos, agregue una transformación Búsqueda y, a continuación, realice las tareas siguientes para configurar la transformación:
Conecte la transformación Búsqueda al flujo de datos arrastrando un conector desde un origen o una transformación anterior hasta la transformación Búsqueda.
Nota
Una transformación Búsqueda podría no validarse si se conecta a un archivo plano que contiene un campo de fecha vacío. El que la transformación se valide depende de si el administrador de conexiones para el archivo plano se ha configurado para conservar los valores NULL. Para asegurarse de que la transformación Búsqueda se valida, en el Editor de origen de archivos planos, de la página Administrador de conexiones, seleccione la opción Conservar los valores null del origen como valores null en el flujo de datos .
Haga doble clic en el origen o la transformación anterior para configurar el componente.
Haga doble clic en la transformación Búsqueda y, después, en el Editor de transformación Búsqueda, en la página General , seleccione Caché completa.
En el área Tipo de conexión , seleccione Administrador de conexiones de caché.
En la lista Especificar cómo administrar las filas sin entradas coincidentes , seleccione una opción de control de errores.
En la página Conexión , en la lista Administrador de conexiones de caché , seleccione un administrador de conexiones de caché.
Haga clic en la página Columnas y, a continuación, arrastre por lo menos una columna desde la lista Columnas de entrada disponibles hasta una columna de la lista Columnas de búsqueda disponibles .
Nota
La transformación Búsqueda asigna automáticamente las columnas que tienen el mismo nombre y el mismo tipo de datos.
Nota
Las columnas deben tener tipos coincidentes de datos para asignarse. Para obtener más información, vea Integration Services Data Types.
En la lista Columnas de búsqueda disponibles , seleccione las columnas. A continuación, en la lista Operación de búsqueda , especifique si los valores de las columnas de búsqueda reemplazan los valores de la columna de entrada o se escriben en una nueva columna.
Para configurar la salida de errores, haga clic en la página Salida de error y establezca las opciones de control de errores. Para obtener más información, vea Editor de transformación Búsqueda (página Salida de error).
Haga clic en Aceptar para guardar los cambios realizados en la transformación Búsqueda.
Ejecute el paquete.
Para implementar una transformación Búsqueda en el modo de caché completa en dos paquetes mediante el administrador de conexiones de caché y un origen de datos del flujo de datos
En SQL Server Data Tools (SSDT), abra un proyecto Integration Services y, a continuación, abra dos paquetes.
En la pestaña Flujo de control de cada paquete, agregue una tarea Flujo de datos.
En el paquete principal, agregue una transformación de caché al flujo de datos y, a continuación, conéctela a un origen de datos.
Configure el origen de datos según sea necesario.
Haga doble clic en la transformación de caché y, después, en el Editor de transformación Caché, en la página Administrador de conexiones , haga clic en Nuevo para crear un administrador de conexiones de caché.
En el Editor del administrador de conexiones de caché, en la pestaña General , configure el administrador estableciendo las opciones siguientes:
Seleccione Utilizar la caché del archivo.
En Nombre de archivo, escriba la ruta de acceso al archivo o haga clic en Examinar para seleccionar el archivo.
Si escribe una ruta de acceso para un archivo que no existe, el sistema crea el archivo al ejecutar el paquete.
Nota
El nivel de protección del paquete no se aplica al archivo caché. Si el archivo caché contiene información confidencial, utilice una lista de control de acceso (ACL) para restringir el acceso a la ubicación o carpeta en la que almacena el archivo. Solo debería permitir el acceso a ciertas cuentas. Para más información, vea Acceso a los archivos usados por los paquetes.
Haga clic en la pestaña Columnas e indique qué columnas son las columnas de índice mediante la opción Posición de índice .
Para las columnas de no índice, la posición de índice es 0. Para las columnas de índice, la posición de índice es un número secuencial positivo.
Nota
Cuando la transformación Búsqueda se configura para utilizar un administrador de conexiones de caché, a las columnas de entrada solo se les puede asignar las columnas de índice del conjunto de datos de referencia. Asimismo, todas las columnas de índice deben estar asignadas. Para obtener más información, vea Cache Connection Manager Editor.
Configure la transformación de caché según sea necesario. Para obtener más información, vea Editor de transformación Caché (página Administrador de conexiones) y Editor de transformación Caché (página Asignaciones).
Realice una de las siguientes acciones para rellenar el administrador de conexiones de caché que se utiliza en el segundo paquete:
Ejecute el paquete primario.
Haga doble clic en el administrador de conexiones de caché que ha creado en el paso 4, haga clic en Columnas, seleccione las filas y, después, presione CTRL+C para copiar los metadatos de columna.
En el paquete secundario, cree un administrador de conexiones de caché. Para hacerlo, haga clic con el botón derecho en el área Administradores de conexiones , haga clic en Nueva conexión, seleccione CACHÉ en el cuadro de diálogo Agregar administrador de conexiones SSIS y, después, haga clic en Agregar.
El área Administradores de conexión aparece en la parte inferior de las pestañas Flujo de control, Flujo de datosy Controladores de eventos del Diseñador de Integration Services .
En el Editor del administrador de conexiones de caché, en la pestaña General , configure el administrador para leer los datos del archivo caché seleccionado a través de las opciones siguientes:
Seleccione Utilizar la caché del archivo.
En Nombre de archivo, escriba la ruta de acceso al archivo o haga clic en Examinar para seleccionar el archivo.
Nota
El nivel de protección del paquete no se aplica al archivo caché. Si el archivo caché contiene información confidencial, utilice una lista de control de acceso (ACL) para restringir el acceso a la ubicación o carpeta en la que almacena el archivo. Solo debería permitir el acceso a ciertas cuentas. Para más información, vea Acceso a los archivos usados por los paquetes.
Si ha copiado los metadatos de columna en el paso 8, haga clic en Columnas, seleccione la fila vacía y, después, presione CTRL+V para pegar los metadatos de columna.
Agregue una transformación Búsqueda y, a continuación, configúrela mediante las tareas siguientes:
Conecte la transformación Búsqueda al flujo de datos arrastrando un conector desde un origen o una transformación anterior hasta la transformación Búsqueda.
Nota
Una transformación Búsqueda podría no validarse si se conecta a un archivo plano que contiene un campo de fecha vacío. El que la transformación se valide depende de si el administrador de conexiones para el archivo plano se ha configurado para conservar los valores NULL. Para asegurarse de que la transformación Búsqueda se valida, en el Editor de origen de archivos planos, de la página Administrador de conexiones, seleccione la opción Conservar los valores null del origen como valores null en el flujo de datos .
Haga doble clic en el origen o la transformación anterior para configurar el componente.
Haga doble clic en la transformación Búsqueda y, después, seleccione Caché completa en la página General del Editor de transformación Búsqueda.
En el área Tipo de conexión , seleccione Administrador de conexiones de caché .
En la lista Especificar cómo administrar las filas sin entradas coincidentes , seleccione una opción de control de errores para las filas sin entradas coincidentes.
En la página Conexión , en la lista Administrador de conexiones de caché , seleccione el administrador de conexiones de caché que agregó anteriormente.
Haga clic en la página Columnas y, a continuación, arrastre por lo menos una columna desde la lista Columnas de entrada disponibles hasta una columna de la lista Columnas de búsqueda disponibles .
Nota
La transformación Búsqueda asigna automáticamente las columnas que tienen el mismo nombre y el mismo tipo de datos.
Nota
Las columnas deben tener tipos coincidentes de datos para asignarse. Para obtener más información, vea Integration Services Data Types.
En la lista Columnas de búsqueda disponibles , seleccione las columnas. A continuación, en la lista Operación de búsqueda , especifique si los valores de las columnas de búsqueda reemplazan los valores de la columna de entrada o se escriben en una nueva columna.
Para configurar la salida de errores, haga clic en la página Salida de error y establezca las opciones de control de errores. Para obtener más información, vea Editor de transformación Búsqueda (página Salida de error).
Haga clic en Aceptar para guardar los cambios realizados en la transformación Búsqueda.
Abra el paquete primario, agregue una tarea Ejecutar paquete al flujo de control y, a continuación, configure la tarea para llamar al paquete secundario. Para más información, consulte Execute Package Task.
Ejecute los paquetes.
Para implementar una transformación Búsqueda en el modo de caché completa mediante el administrador de conexiones de caché y un archivo caché existente
En SQL Server Data Tools (SSDT), abra un proyecto Integration Services y, a continuación, abra un paquete.
Haga clic con el botón derecho en el área Administradores de conexiones y, después, en Nueva conexión.
El área Administradores de conexión aparece en la parte inferior de las pestañas Flujo de control, Flujo de datosy Controladores de eventos del Diseñador de Integration Services .
En el cuadro de diálogo Agregar administrador de conexiones SSIS , seleccione CACHÉy, a continuación, haga clic en Agregar para agregar un administrador de conexiones de caché.
Haga doble clic en el Administrador de conexiones de caché para abrir el Editor del administrador de conexiones de caché.
En el Editor del administrador de conexiones de caché, en la pestaña General , configure el administrador estableciendo las opciones siguientes:
Seleccione Utilizar la caché del archivo.
En Nombre de archivo, escriba la ruta de acceso al archivo o haga clic en Examinar para seleccionar el archivo.
Nota
El nivel de protección del paquete no se aplica al archivo caché. Si el archivo caché contiene información confidencial, utilice una lista de control de acceso (ACL) para restringir el acceso a la ubicación o carpeta en la que almacena el archivo. Solo debería permitir el acceso a ciertas cuentas. Para más información, vea Acceso a los archivos usados por los paquetes.
Haga clic en la pestaña Columnas e indique qué columnas son las columnas de índice mediante la opción Posición de índice .
Para las columnas de no índice, la posición de índice es 0. Para las columnas de índice, la posición de índice es un número secuencial positivo.
Nota
Cuando la transformación Búsqueda se configura para utilizar un administrador de conexiones de caché, a las columnas de entrada solo se les puede asignar las columnas de índice del conjunto de datos de referencia. Asimismo, todas las columnas de índice deben estar asignadas. Para obtener más información, vea Cache Connection Manager Editor.
En la pestaña Flujo de control , agregue una tarea Flujo de datos al paquete y, a continuación, agregue una transformación Búsqueda al flujo de datos.
Para configurar la transformación Búsqueda, realice una de las siguientes acciones:
Conecte la transformación Búsqueda al flujo de datos arrastrando un conector desde un origen o una transformación anterior hasta la transformación Búsqueda.
Nota
Una transformación Búsqueda podría no validarse si se conecta a un archivo plano que contiene un campo de fecha vacío. El que la transformación se valide depende de si el administrador de conexiones para el archivo plano se ha configurado para conservar los valores NULL. Para asegurarse de que la transformación Búsqueda se valida, en el Editor de origen de archivos planos, de la página Administrador de conexiones, seleccione la opción Conservar los valores null del origen como valores null en el flujo de datos .
Haga doble clic en el origen o la transformación anterior para configurar el componente.
Haga doble clic en la transformación Búsqueda y, después, en el Editor de transformación Búsqueda, en la página General , seleccione Caché completa.
En el área Tipo de conexión , seleccione Administrador de conexiones de caché .
En la lista Especificar cómo administrar las filas sin entradas coincidentes , seleccione una opción de control de errores para las filas sin entradas coincidentes.
En la página Conexión , en la lista Administrador de conexiones de caché , seleccione el administrador de conexiones de caché que agregó anteriormente.
Haga clic en la página Columnas y, a continuación, arrastre por lo menos una columna desde la lista Columnas de entrada disponibles hasta una columna de la lista Columnas de búsqueda disponibles .
Nota
La transformación Búsqueda asigna automáticamente las columnas que tienen el mismo nombre y el mismo tipo de datos.
Nota
Las columnas deben tener tipos coincidentes de datos para asignarse. Para obtener más información, vea Integration Services Data Types.
En la lista Columnas de búsqueda disponibles , seleccione las columnas. A continuación, en la lista Operación de búsqueda , especifique si los valores de las columnas de búsqueda reemplazan los valores de la columna de entrada o se escriben en una nueva columna.
Para configurar la salida de errores, haga clic en la página Salida de error y establezca las opciones de control de errores. Para obtener más información, vea Editor de transformación Búsqueda (página Salida de error).
Haga clic en Aceptar para guardar los cambios realizados en la transformación Búsqueda.
Ejecute el paquete.
Consulte también
Implementar una transformación Búsqueda en el modo de caché completa mediante el Administrador de conexiones OLE DB
Implementar una búsqueda en modo No hay caché o Caché parcial
Transformaciones de Integration Services