Transformación de búsqueda

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

La transformación de búsqueda realiza búsquedas al combinar datos de columnas de entrada con las columnas de un conjunto de datos de referencia. La búsqueda se utiliza para tener acceso a información adicional en una tabla relacionada que está basada en valores de columnas comunes.

El conjunto de datos de referencia puede ser un archivo de caché, una tabla o vista existente, una nueva tabla o el resultado de una consulta SQL. La transformación Lookup utiliza un administrador de conexiones OLE DB o un administrador de conexiones Cache para conectarse al conjunto de datos de referencia. Para obtener más información, vea OLE DB Administrador de conexiones y Cache Administrador de conexiones.

Puede configurar la transformación de búsqueda de las siguientes formas:

  • Seleccionar el administrador de conexiones que desea utilizar. Si desea conectarse a una base de datos, seleccione un administrador de conexiones OLE DB. Si desea conectarse a un archivo caché, seleccione un administrador de conexiones de caché.

  • Especificar la tabla o vista que contiene el conjunto de datos de referencia.

  • Genere un conjunto de datos de referencia especificando una instrucción SQL.

  • Especificar las combinaciones entre los datos de entrada y el conjunto de datos de referencia.

  • Agregar columnas del conjunto de datos de referencia a la salida de la transformación Búsqueda.

  • Configurar las opciones de almacenamiento en caché.

La transformación de búsqueda admite los siguientes proveedores de bases de datos para el administrador de conexiones de OLE DB:

  • SQL Server

  • Oracle

  • DB2

La transformación Lookup intenta realizar un equi-join entre los valores de entrada de la transformación y los del conjunto de datos de referencia. (Uno combinación por igualdad significa que cada fila de la entrada de la transformación debe coincidir con al menos una fila del conjunto de datos de referencia). Si no es posible realizar una combinación por igualdad, la transformación Lookup realiza una de las siguientes acciones:

  • Si no hay ninguna entrada correspondiente en el conjunto de datos de referencia, no se produce ninguna combinación. De forma predeterminada, la transformación Búsqueda trata como errores las filas sin entradas coincidentes. Sin embargo, puede configurar la transformación Lookup para redirigir dichas filas a una salida sin coincidencias.

  • Si hay varias coincidencias en la tabla de referencia, la transformación Búsqueda devuelve solo la primera coincidencia devuelta por la consulta de búsqueda. Si se encuentran varias coincidencias, la transformación Búsqueda genera un error o advertencia solo cuando la transformación se ha configurado para cargar todo el conjunto de datos de referencia en la memoria caché. En este caso, la transformación Búsqueda genera una advertencia cuando detecta varias coincidencias mientras la transformación llena la memoria caché.

La combinación puede ser compuesta, lo que indica que pueden combinarse varias columnas de la entrada de transformación con columnas del conjunto de datos de referencia. La transformación admite la combinación de columnas con cualquier tipo de datos, a excepción de DT_R4, DT_R8, DT_TEXT, DT_NTEXT o DT_IMAGE. Para obtener más información, vea Integration Services Data Types.

Normalmente, los valores del conjunto de datos de referencia se agregan a la salida de transformación. Por ejemplo, la transformación Búsqueda puede extraer un nombre de producto de una tabla mediante un valor de una columna de entrada y, después, agregar el nombre del producto a la salida de transformación. Los valores de la tabla de referencia pueden reemplazar valores de columnas o agregarse a nuevas columnas.

Las búsquedas realizadas por la transformación Búsqueda distinguen mayúsculas de minúsculas. Para evitar errores de búsqueda producidos por diferencias entre mayúsculas y minúsculas en los datos, utilice primero la transformación Mapa de caracteres para convertir los datos en mayúsculas o minúsculas. A continuación, incluya las funciones UPPER o LOWER en la instrucción SQL que genera la tabla de referencia. Para más información, vea Transformación Mapa de caracteres, UPPER (Transact-SQL) y LOWER (Transact-SQL).

La transformación de búsqueda tiene las siguientes entradas y salidas:

  • Entrada.

  • Resultado coincidente. La salida de coincidencias procesa las filas de la entrada de la transformación que coinciden con al menos una entrada del conjunto de datos de referencia.

  • Resultado no coincidente. La salida sin coincidencias procesa las filas de entrada que no coinciden con al menos una entrada del conjunto de datos de referencia. Si configura la transformación Búsqueda para que trate como errores las filas sin entradas coincidentes, las filas se redirigirán a la salida de errores. En los demás casos, la transformación redirigiría dichas filas al resultado no coincidente.

  • Salida de error

Almacenar en caché el conjunto de datos de referencia

Una caché en memoria almacena el conjunto de datos de referencia y una tabla hash que indiza los datos. La memoria caché permanece en la memoria hasta que se completa la ejecución del paquete. Puede guardar la memoria caché en un archivo caché (.caw).

Al conservar la memoria caché en un archivo, el sistema la carga con más rapidez. Esto mejora el rendimiento de la transformación de búsqueda y del paquete. Recuerde que cuando utiliza un archivo caché, está trabajando con datos que no están tan actualizados como los de la base de datos.

A continuación se describen otras ventajas relacionadas con guardar la memoria caché en un archivo:

A continuación se enumeran las opciones de almacenamiento en caché:

  • El conjunto de datos de referencia se genera mediante una tabla, vista o consulta SQL y se carga en la memoria caché antes de que se ejecute la transformación Búsqueda. Puede usar el administrador de conexiones OLE DB para tener acceso al conjunto de datos.

    Esta opción de caché es compatible con la opción de caché completa disponible para la transformación Lookup de SQL Server 2005 Integration Services (SSIS).

  • El conjunto de datos de referencia se genera a partir de un origen de datos conectado al flujo de datos o de un archivo caché, y se carga en la memoria caché antes de que se ejecute la transformación Búsqueda. Para acceder al conjunto de datos, use el administrador de conexiones de caché y, opcionalmente, la transformación Caché. Para obtener más información, consulte Cache Administrador de conexiones y Cache Transform.

  • El conjunto de datos de referencia se genera utilizando una tabla, una vista o una consulta SQL durante la ejecución de la transformación de búsqueda. Las filas con entradas coincidentes en el conjunto de datos de referencia y las que no tienen entradas coincidentes se cargan en la memoria caché.

    Cuando se supera el tamaño de la memoria caché, la transformación Búsqueda quita automáticamente de la memoria caché las filas utilizadas con menor frecuencia.

    Esta opción de almacenamiento en caché es compatible con la opción de almacenamiento en caché parcial disponible para la transformación de búsqueda en SQL Server 2005 Integration Services (SSIS).

  • El conjunto de datos de referencia se genera usando una tabla, una vista o una consulta SQL durante la ejecución de la transformación de búsqueda. No se almacenan datos en la memoria caché.

    Esta opción de caché es compatible con la opción de no usar caché disponible para la transformación Lookup de SQL Server 2005 Integration Services (SSIS).

Integration Services y SQL Server difieren en el modo en que comparan cadenas. Si la transformación Lookup está configurada para cargar el conjunto de datos de referencia en caché antes de que se ejecute, Integration Services realiza la búsqueda en caché. En caso contrario, la operación de búsqueda utiliza una instrucción SQL con parámetros y SQL Server realiza la comparación de búsqueda. Por lo tanto, es posible que la transformación Búsqueda devuelva un número de coincidencias diferentes a partir de la misma tabla de búsqueda, en función del tipo de caché.

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación. Para obtener información detallada, vea los siguientes temas.

Editor de transformación Búsqueda (página General)

Utilice la página General del cuadro de diálogo Editor de transformación de búsqueda para seleccionar el modo de caché, seleccionar el tipo de conexión y especificar cómo controlar las filas que no tengan entradas coincidentes.

Opciones

Nota:

La salida de coincidencia puede diferir en función de si se usa el modo de caché completa, el modo sin caché o el modo de caché parcial:

  • En el modo de caché completa, la base de datos se consulta una vez durante la fase de ejecución previa del flujo de datos y se extrae todo el conjunto de referencias en la memoria. Esto significa que nos basaremos en la regla de coincidencia del motor de SSIS, que distingue entre mayúsculas y minúsculas, tiene en cuenta los espacios finales y distingue también la precisión y la escala numéricas.
  • Sin embargo, cuando se utiliza el modo Sin caché o Caché parcial, no se realiza ningún almacenamiento en caché durante la fase de preejecución. Esto significa que usaremos la regla de coincidencia de la base de datos de origen. Por ejemplo, si el origen es una base de datos de SQL Server y la intercalación de la columna no distingue entre mayúsculas y minúsculas, la regla de coincidencia tampoco debe distinguir entre mayúsculas y minúsculas.

Caché completa
Genere y cargue el conjunto de datos de referencia en caché antes de que se ejecute la transformación de búsqueda.

Caché parcial
Genere el conjunto de datos de referencia durante la ejecución de la transformación de búsqueda. Cargue en la caché las filas con entradas coincidentes del conjunto de datos de referencia y las que no tienen entradas coincidentes.

Sin caché
Generar el conjunto de datos de referencia durante la ejecución de la transformación de búsqueda. No se carga ningún dato en la caché.

Administrador de conexiones de caché
Configure la transformación Lookup para usar un administrador de conexiones de caché. Esta opción solo está disponible si también está seleccionada la opción Caché completa.

Administrador de conexiones OLE DB
Configure la transformación de búsqueda para que use un administrador de conexión OLE DB.

Especificar cómo administrar las filas sin entradas coincidentes
Seleccione una opción para administrar las filas que no coincidan por lo menos con una entrada del conjunto de datos de referencia.

Al seleccionar Redirigir filas a resultados no coincidentes, las filas se redirigen a un resultado sin coincidencia y no se tratan como errores. La opción Error de la página Salida de error del cuadro de diálogo Editor de transformación Búsqueda no está disponible.

Al seleccionar cualquier otra opción del cuadro de lista Especifique cómo administrar las filas sin entradas coincidentes , las filas se tratan como errores. La opción Error de la página Salida de error está disponible.

Recursos externos

Entrada del blog, Lookup cache modes en blogs.msdn.com

Editor de transformación de búsqueda (Página de conexión)

Utilice la página Conexión del cuadro de diálogo Editor de transformación Búsqueda para seleccionar un administrador de conexiones. Si selecciona un administrador de conexiones OLE DB, también selecciona una consulta, tabla o vista para generar el conjunto de datos de referencia.

Opciones

Las opciones siguientes están disponibles al seleccionar Caché completa y Administrador de conexiones de caché en la página General del cuadro de diálogo Editor de transformación Búsqueda .

Administrador de conexiones de caché
Seleccione un administrador de conexiones de caché de la lista o cree una conexión haciendo clic en Nueva.

Nuevo
Cree una conexión mediante el cuadro de diálogo Editor del administrador de conexiones de caché .

Las opciones siguientes están disponibles al seleccionar Caché completa, Caché parcialo Sin caché, y Administrador de conexiones OLE DBen la página General del cuadro de diálogo Editor de transformación Búsqueda .

Administrador de conexiones OLE DB
Seleccione un administrador de conexiones OLE DB de la lista o cree una conexión haciendo clic en Nueva.

Nuevo
Cree una conexión mediante el cuadro de diálogo Configurar el administrador de conexiones OLE DB .

Usar una tabla o una vista
Seleccione una tabla o vista de la lista o cree una tabla haciendo clic en Nueva.

Nota:

Si especifica una instrucción SQL en la página Opciones avanzadas del Editor de la transformación Búsqueda, esa instrucción SQL anula y sustituye el nombre de la tabla seleccionado aquí.

Nuevo
Permite crear una tabla con el cuadro de diálogo Crear tabla .

Uso de resultados de una consulta SQL
Elige esta opción para buscar una consulta preexistente, generar una consulta nueva, comprobar la sintaxis de consulta y obtener una vista previa de los resultados de la consulta.

Generar consulta
Cree la instrucción Transact-SQL para ejecutarla mediante el Generador de consultas, herramienta gráfica que se usa para crear consultas examinando datos.

Browse
Utiliza esta opción para examinar una consulta preexistente guardada como un archivo.

Analizar consulta
Compruebe la sintaxis de la consulta.

Versión preliminar
Obtenga una vista previa de los resultados mediante el cuadro de diálogo Vista previa de los resultados de la consulta . Esta opción muestra hasta 200 filas.

Recursos externos

Entrada del blog, Lookup cache modes en blogs.msdn.com

Editor de transformación Búsqueda (página Columnas)

Utilice la página Columnas del cuadro de diálogo Editor de transformación de búsqueda para especificar la unión entre la tabla de origen y la tabla de referencia, y para seleccionar las columnas de búsqueda de la tabla de referencia.

Opciones

Columnas de entrada disponibles
Muestra la lista de columnas de entrada disponibles. Las columnas de entrada son las columnas del flujo de datos de un origen conectado. Las columnas de entrada y la columna de búsqueda deben tener tipos de datos coincidentes.

Utilice una operación de arrastrar y colocar para asignar columnas de entrada disponibles a columnas de búsqueda.

También puede asignar columnas de entrada a columnas de búsqueda utilizando el teclado, resaltando una columna en la tabla Columnas de entrada disponibles , presionando la tecla de aplicación y haciendo clic en Editar asignacionesa continuación.

Columnas de búsqueda disponibles
Muestra la lista de columnas de búsqueda. Las columnas de búsqueda son columnas de la tabla de referencia en las que desea buscar valores que coinciden con las columnas de entrada.

Utilice una operación de arrastrar y colocar para asignar columnas de búsqueda disponibles a columnas de entrada.

Use las casillas para seleccionar las columnas de búsqueda de la tabla de referencia en las que se realizarán operaciones de búsqueda.

También puede asignar columnas de búsqueda a columnas de entrada utilizando el teclado, resaltando una columna en la tabla Columnas de búsqueda disponibles , presionando la tecla de aplicación y haciendo clic en Editar asignacionesa continuación.

columna de búsqueda
Muestra las columnas de búsqueda seleccionadas. Las selecciones se reflejan en las casillas activadas en la tabla Columnas de búsqueda disponibles .

Operación de búsqueda
Seleccione una operación de búsqueda de la lista para llevar a cabo en la columna de búsqueda.

Alias de salida
Escriba un alias de salida para cada columna de consulta. El valor predeterminado es el nombre de la columna de búsqueda; no obstante, puede elegir un nombre descriptivo exclusivo.

Editor de transformación de búsqueda (Página avanzada)

Utilice la página Opciones avanzadas del cuadro de diálogo Editor de la transformación Búsqueda para configurar el almacenamiento en caché parcial y modificar la instrucción SQL para la transformación Búsqueda.

Opciones

Tamaño de caché (32 bits)
Ajuste el tamaño de caché (en megabytes) para los equipos de 32 bits. El valor predeterminado es 5 megabytes.

Tamaño de caché (64 bits)
Ajuste el tamaño de caché (en megabytes) para los equipos de 64 bits. El valor predeterminado es 5 megabytes.

Habilitar caché para filas sin entradas coincidentes
Almacene en caché filas sin entradas coincidentes en el conjunto de datos de referencia.

Asignación desde la caché
Especifique el porcentaje de caché que se debe asignar a las filas sin entradas coincidentes en el conjunto de datos de referencia.

Modificar la instrucción SQL
Modifique la instrucción SQL que se utiliza para generar el conjunto de datos de referencia.

Nota:

La instrucción SQL opcional que especifique en esta página anula y reemplaza el nombre de la tabla que especificó en la página Conexión del Editor de transformación de búsqueda. .

Establecer parámetros
Asigne columnas de entrada a parámetros mediante el cuadro de diálogo Establecer parámetros de consulta .

Recursos externos

Entrada del blog, Lookup cache modes en blogs.msdn.com

Contenido relacionado

  • Last updated on