Destino de OLE DB

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

El destino de OLE DB carga datos en una serie de bases de datos compatibles con OLE DB que usan una tabla o vista de base de datos o un comando SQL. Por ejemplo, un origen de OLE DB puede cargar datos en tablas en bases de datos de Microsoft Office Access y SQL Server.

El destino de OLE DB proporciona cinco modos diferentes de acceso a los datos para cargar datos:

• Una tabla o vista. Puede especificar una tabla o vista existentes, o puede crear una nueva tabla.

• Una tabla o vista usando opciones de carga rápida. Puede especificar una tabla existente, o puede crear una nueva tabla.

• Una tabla o vista especificadas en una variable.

• Una tabla o vista especificada en una variable usando opciones de carga rápida.

• Los resultados de una instrucción SQL.

Cuando el destino de OLE DB carga datos que utilizan un juego de caracteres de doble byte (DBCS), los datos se pueden dañar si el modo del acceso a datos no usa la opción de carga rápida y si el administrador de conexiones OLE DB utiliza el proveedor OLE DB de Microsoft para SQL Server (SQLOLEDB). Para garantizar la integridad de datos de DBCS es necesario configurar el administrador de conexiones OLE DB para que use SQL Server Native Client o uno de los modos de acceso de carga rápida: Carga rápida de tabla o vista o Carga rápida de variable de nombre de tabla o nombre de vista. Ambas opciones están disponibles en el cuadro de diálogo Editor de destino de OLE DB . Al programar el modelo de objetos SSIS, es necesario configurar la propiedad AccessMode en OpenRowset con FastLoado en OpenRowset con FastLoad desde variable.

Este destino usa un administrador de conexiones OLE DB para conectarse a un origen de datos, y el administrador de conexiones especifica el proveedor OLE DB que se debe usar. Para más información, consulte OLE DB Connection Manager.

Un proyecto de Integration Services también proporciona el objeto de origen de datos desde el que puede crear un administrador de conexiones OLE DB para poner los orígenes de datos y las vistas del origen de datos a disposición del destino de OLE DB.

Un destino de OLE DB incluye asignaciones entre columnas de entrada y columnas en el origen de datos de destino. No es necesario asignar columnas de entrada a todas las columnas de destino, pero, según las propiedades de las columnas de destino, pueden producirse errores si no se asignan columnas de entrada a las columnas de destino. Por ejemplo, si una columna de destino no permite valores NULL, se debe asignar una columna de entrada a esa columna. Además, los tipos de datos de las columnas asignadas deben ser compatibles. Por ejemplo, no se puede asignar una columna de entrada que tiene un tipo de datos de cadena a una columna de destino con un tipo de datos numérico.

El destino de OLE DB tiene una entrada normal y una salida de error.

Para obtener más información acerca de los tipos de datos, vea Integration Services Data Types.

Opciones de carga rápida

Si el destino de OLE DB usa el modo de acceso a datos de carga rápida, puede especificar las siguientes opciones de carga rápida en la interfaz de usuario del Editor de destino de OLE DBpara el destino:

• Guarde los valores de identidad del archivo de datos importado o use valores exclusivos asignados por SQL Server.

• Conservar un valor NULL durante la operación de carga masiva.

• Comprobar las restricciones en la tabla o vista de destino durante la operación de importación masiva.

• Adquirir un bloqueo de nivel de tabla durante la operación de carga masiva.

• Especificar la cantidad de filas del lote y el tamaño de confirmación.

Algunas opciones de carga rápida están almacenadas en propiedades específicas del destino de OLE DB. Por ejemplo, FastLoadKeepIdentity especifica si se mantienen los valores de identificación, FastLoadKeepNulls especifica si se mantienen los valores nulos y FastLoadMaxInsertCommitSize especifica el número de filas que se confirmarán como un lote. Otras opciones de carga rápida se almacenan en una lista separada por comas, en la propiedad FastLoadOptions. Si el destino de OLE DB usa todas las opciones de carga rápida que se almacenan en FastLoadOptions y que se muestran en el cuadro de diálogo Editor de destino de OLE DB , el valor de la propiedad se establece en TABLOCK, CHECK_CONSTRAINTS, ROWS_PER_BATCH=1000. El valor 1000 indica que el destino se configura para usar lotes de 1000 filas.

Además de las opciones de carga rápida que se muestran en el cuadro de diálogo Editor de destino de OLE DB , puede configurar el destino de OLE DB para usar las siguientes opciones de carga masiva al escribir las opciones en la propiedad FastLoadOptions del cuadro de diálogo Editor avanzado .

Las palabras clave de Transact-SQL se suelen escribir en mayúsculas, aunque las palabras clave no distinguen entre mayúsculas y minúsculas.

Para más información sobre las opciones de carga rápida, vea BULK INSERT (Transact-SQL).

Solucionar problemas del destino de OLE DB

Puede registrar las llamadas realizadas por el destino OLE DB a proveedores de datos externos. Puede utilizar esta nueva capacidad de registro para solucionar problemas relacionados con el almacenamiento de datos en orígenes de datos externos que realiza el destino OLE DB. Para registrar las llamadas realizadas por el destino OLE DB a proveedores de datos externos, habilite el registro de paquetes y seleccione el evento Diagnostic en el nivel de paquete. Para más información, vea Herramientas para solucionar problemas con la ejecución de paquetes.

Configurar el destino de OLE DB

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.

El cuadro de diálogo Editor avanzado indica las propiedades que se pueden establecer mediante programación. Para obtener más información acerca de las propiedades que puede establecer a través del cuadro de diálogo Editor avanzado o mediante programación, haga clic en uno de los temas siguientes:

• Common Properties

• Propiedades personalizadas de OLE DB

Para obtener más información sobre cómo establecer valores de propiedades, haga clic en uno de los temas siguientes:

• Cargar datos mediante el destino de OLE DB

• Establecer las propiedades de un componente de flujo de datos

Editor de destino de OLE DB (página Administrador de conexiones)

Utilice la página Administrador de conexiones del cuadro de diálogo Editor de destino de OLE DB para seleccionar la conexión OLE DB del destino. Esta página también permite seleccionar una tabla o vista de la base de datos.

Opciones estáticas

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

Nuevo
Cree un administrador de conexiones con el cuadro de diálogo Configurar el administrador de conexiones OLE DB .

Modo de acceso a datos
Especifique el método para cargar los datos en el destino. Para cargar datos del juego de caracteres de doble byte (DBCS), es necesario que utilice una de las opciones de carga rápida. Para obtener más información acerca de los modos de acceso a datos de carga rápida, optimizados para inserciones masivas, vea OLE DB Destination.

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

Opciones dinámicas del modo de acceso a datos

Cada uno de los valores de Modo de acceso a datos muestra un conjunto dinámico de opciones específico de ese valor. En las secciones siguientes se describe cada una de las opciones dinámicas disponibles para cada valor de Modo de acceso a datos .

Modo de acceso a datos = Tabla o vista

Nombre de la tabla o la vista
Seleccione el nombre de la tabla o vista de los disponibles en una lista del origen de datos.

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

Modo de acceso a datos = Carga rápida de tabla o vista

Nombre de la tabla o la vista
Seleccione una tabla o una vista de la base de datos con esta lista, o bien haga clic en Nuevopara crear una tabla.

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

Mantener valores de identidad
Especifique si se copian los valores de identidad cuando se cargan los datos. Esta propiedad solo está disponible con la opción de carga rápida. El valor predeterminado de esta propiedad es false.

Mantener valores NULL
Especifique si se copian los valores NULL cuando se cargan los datos. Esta propiedad solo está disponible con la opción de carga rápida. El valor predeterminado de esta propiedad es false.

Bloqueo de tabla
Especifique si la tabla se bloquea durante la carga. El valor predeterminado de esta propiedad es true.

Restricciones CHECK
Especifique si el destino comprueba restricciones cuando carga datos. El valor predeterminado de esta propiedad es true.

Filas por lote
Especifique el número de filas de un lote. El valor predeterminado de esta propiedad es -1, lo que indica que no se ha asignado ningún valor.

Tamaño máximo de confirmación de inserción
Especifique el tamaño de lote que el destino OLE DB intenta confirmar en operaciones de carga rápida. El valor de 0 indica que todos los datos se han confirmado en un solo lote después de procesar todas las filas.

Si proporciona un valor en esta propiedad, el destino confirma las filas en lotes con el tamaño menor de (a) el Tamaño máximo de confirmación de insercióno (b) las filas restantes del búfer que se está procesando.

Modo de acceso a datos = Variable de nombre de tabla o nombre de vista

Nombre de la variable
Seleccione la variable que contiene el nombre de la tabla o vista.

Modo de acceso a datos = Carga rápida de variable de nombre de tabla o nombre de vista

Nombre de la variable
Seleccione la variable que contiene el nombre de la tabla o vista.

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

Mantener valores de identidad
Especifique si se copian los valores de identidad cuando se cargan los datos. Esta propiedad solo está disponible con la opción de carga rápida. El valor predeterminado de esta propiedad es false.

Mantener valores NULL
Especifique si se copian los valores NULL cuando se cargan los datos. Esta propiedad solo está disponible con la opción de carga rápida. El valor predeterminado de esta propiedad es false.

Bloqueo de tabla
Especifique si la tabla se bloquea durante la carga. El valor predeterminado de esta propiedad es false.

Restricciones CHECK
Especifique si la tarea comprueba restricciones. El valor predeterminado de esta propiedad es false.

Filas por lote
Especifique el número de filas de un lote. El valor predeterminado de esta propiedad es -1, lo que indica que no se ha asignado ningún valor.

Tamaño máximo de confirmación de inserción
Especifique el tamaño de lote que el destino OLE DB intenta confirmar en operaciones de carga rápida. El valor predeterminado 2147483647 indica que todos los datos se confirman en un solo lote, tras el procesamiento de todas las filas.

Modo de acceso a datos = Comando SQL

Texto de comando SQL
Escriba el texto de una consulta SQL, genere la consulta haciendo clic en Generar consulta, o bien busque el archivo que contiene el texto de la consulta haciendo clic en Examinar.

Generar consulta
Use el cuadro de diálogo Generador de consultas para crear visualmente la consulta SQL.

Browse
Use el cuadro de diálogo Abrir para buscar el archivo que contiene el texto de la consulta SQL.

Analizar consulta
Comprueba la sintaxis del texto de la consulta.

Editor de destino de OLE DB (página Asignaciones)

Utilice la página Asignaciones del cuadro de diálogo Editor de destino de OLE DB para asignar columnas de entrada a columnas de destino.

Opciones

Columnas de entrada disponibles
Muestra la lista de columnas de entrada disponibles. Utilice una operación de arrastrar y colocar para asignar columnas de entrada disponibles de la tabla a columnas de destino.

Columnas de destino disponibles
Muestra la lista de columnas de destino disponibles. Utilice una operación de arrastrar y colocar para asignar columnas de destino disponibles de la tabla a columnas de entrada.

Columna de entrada
Permite ver las columnas de entrada seleccionadas. Para quitar asignaciones, seleccione < ignore> con el fin de excluir columnas de la salida.

Columna de destino
Muestra todas las columnas de destino disponibles, tanto si están asignadas como si no lo están.

Editor de destino de OLE DB (página Salida de error)

Utilice la página Salida de error del cuadro de diálogo Editor de destino de OLE DB para especificar las opciones de control de errores.

Opciones

Entrada/salida
Muestra el nombre de la entrada.

Columna
No se usa.

Error
Permite especificar qué debe ocurrir cuando se produce un error: omitir el error, redirigir la fila o hacer que el componente no funcione.

Temas relacionados:Control de errores en los datos

Truncamiento
No se usa.

Descripción
Muestra la descripción de la operación.

Establecer este valor en las celdas seleccionadas
Permite especificar qué debe ocurrir en todas las celdas seleccionadas cuando se produce un error o un truncamiento: omitir el error, redirigir la fila o hacer que el componente no funcione.

Aplicar
Aplica la opción de control de errores a las celdas seleccionadas.

Contenido relacionado

Origen de OLE DB

Variables de Integration Services (SSIS)

Flujo de datos