Destino ADO NET

  • Artículo

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

El destino ADO NET carga datos en una serie de bases de datos compatibles con ADO.NETque usan una tabla o vista de base de datos. Tiene la opción de cargar estos datos en una tabla o vista existente, o bien puede crear una nueva tabla y cargar los datos en ella.

Puede usar el destino de ADO NET para conectarse a Microsoft Azure SQL Database. No se admite la conexión a SQL Database mediante OLE DB. Para más información sobre SQL Database, consulte Instrucciones y limitaciones generales (Azure SQL Database).

Solucionar problemas del destino ADO NET

Puede registrar las llamadas realizadas por el destino ADO NET 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 ADO NET. Para registrar las llamadas realizadas por el destino ADO NET 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.

Configuración del destino ADO NET

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

Un destino ADO NET incluye asignaciones entre columnas de entrada y columnas en el origen de datos de destino. No es preciso que asigne columnas de entrada a todas las columnas de destino. Sin embargo, las propiedades de algunas columnas de destino pueden requerir la asignación de columnas de entrada. De lo contrario, se podrían producir errores. Por ejemplo, si una columna de destino no permite valores NULL, se debe asignar una columna de entrada a esa columna de destino. Además, los tipos de datos de las columnas asignadas deben ser compatibles. Por ejemplo, no es posible asignar una columna de entrada con un tipo de datos de cadena a una columna de destino con un tipo de datos numéricos si el proveedor ADO.NET no admite esta asignación.

Nota

SQL Server no permite insertar texto en las columnas cuyo tipo de datos se haya establecido como imagen. Para obtener información sobre los tipos de datos de SQL Server, consulte Tipos de datos (Transact-SQL).

Nota

El destino ADO NET no permite asignar una columna de entrada cuyo tipo sea DT_DBTIME a una columna de base de datos cuyo tipo sea datetime. Para obtener más información sobre los tipos de datos de Integration Services , vea Tipos de datos de Integration Services.

El destino ADO NET tiene una entrada normal y una salida de error.

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:

Para más información sobre cómo establecer propiedades, vea Establecer las propiedades de un componente de flujo de datos.

Editor de destinos de ADO NET (página Administrador de conexiones)

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

Para abrir la página Administrador de conexiones

  1. En SQL Server Data Tools (SSDT), abra el paquete Integration Services que tiene el destino de ADO NET.

  2. En la pestaña Flujo de datos , haga doble clic en el destino de ADO NET.

  3. En el Editor de destinos de ADO NET, haga clic en Administrador de conexiones.

Opciones estáticas

Connection manager
Seleccione un administrador de conexiones de la lista o cree una conexión haciendo clic en Nuevo.

Nuevo
Cree un administrador de conexiones mediante el cuadro de diálogo Configurar el administrador de conexiones ADO.NET .

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

Nuevo
Cree un tabla o una vista mediante el cuadro de diálogo Crear tabla .

Nota

Al hacer clic en Nueva, Integration Services genera una instrucción predeterminada CREATE TABLE basada en el origen de datos conectado. La instrucción predeterminada CREATE TABLE no incluirá el atributo FILESTREAM, aunque la tabla de origen tenga una columna con el atributo FILESTREAM declarado. Para ejecutar un componente Integration Services con el atributo FILESTREAM, implemente en primer lugar el almacenamiento de FILESTREAM en la base de datos de destino. A continuación, agregue el atributo FILESTREAM a la instrucción CREATE TABLE en el cuadro de diálogo Crear tabla . Para más información, vea Datos de objeto binario grande (Blob) (SQL Server).

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.

Usar inserción masiva cuando esté disponible
Especifique si se debe usar la interfaz SqlBulkCopy para mejorar el rendimiento de las operaciones de inserción masiva.

Solamente los proveedores ADO.NET que devuelven un objeto SqlConnection admiten el uso de la interfaz SqlBulkCopy . El Proveedor de datos .NET para SQL Server (SqlClient) devuelve un objeto SqlConnection y, por otra parte, un proveedor personalizado puede devolver un objeto SqlConnection .

Puede usar el proveedor de datos .NET para SQL Server (SqlClient) a fin de conectarse a MicrosoftAzure SQL Database.

Si selecciona Use bulk insert when available(Usar la inserción masiva cuando esté disponible) y establece la opción Error en Redirect the row(Redirigir la fila), el lote de datos que el destino redirige a la salida de error puede incluir filas correctas. Para obtener más información sobre cómo administrar errores en operaciones masivas, vea Control de errores en los datos. Para obtener más información sobre la opción Error, consulte Editor de destinos de ADO NET(página de salida de errores).

Nota

Si una tabla de origen de SQL Server o de Sybase incluye una columna de identidad, debe usar las tareas Ejecutar SQL para habilitar IDENTITY_INSERT antes del destino de ADO NET y para deshabilitarlo nuevamente después. (La propiedad de columna de identidad especifica un valor incremental para la columna. La instrucción SET IDENTITY_INSERT permite insertar valores explícitos de la tabla de origen en la columna de identidad de la tabla de destino).

Para ejecutar las instrucciones SET IDENTITY_INSERT y la carga de datos correctamente, se debe hacer lo siguiente.
1. Use el mismo administrador de conexiones de ADO.NET para las tareas Ejecutar SQL y para el destino de ADO NET.
2. En el administrador de conexiones, establezca la propiedad RetainSameConnection y la propiedad MultipleActiveResultSets en True.
3. En el destino de ADO.NET, establezca la propiedad UseBulkInsertWhenPossible en False.

Para obtener más información, consulte SET IDENTITY_INSERT (Transact-SQL) e IDENTITY (propiedad) (Transact-SQL).

Recursos externos

Artículo técnico sobre cómo cargar datos en Azure SQL Database de la forma más rápida, en sqlcat.com

Editor de destinos de ADO NET (página Asignaciones)

Use la página Asignaciones del cuadro de diálogo Editor de destinos de ADO NET para asignar columnas de entrada a columnas de destino.

Para abrir la página Asignaciones

  1. En SQL Server Data Tools (SSDT), abra el paquete Integration Services que tiene el destino de ADO NET.

  2. En la pestaña Flujo de datos , haga doble clic en el destino de ADO NET.

  3. En el Editor de destinos de ADO NET, haga clic en Asignaciones.

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 destinos de ADO NET (página Salida de error)

Utilice la página Salida de error del cuadro de diálogo Editor de destinos de ADO NET para especificar las opciones de control de errores.

Para abrir la página Salida de error

  1. En SQL Server Data Tools (SSDT), abra el paquete Integration Services que tiene el destino de ADO NET.

  2. En la pestaña Flujo de datos , haga doble clic en el destino de ADO NET.

  3. En el Editor de destinos de ADO NET, haga clic en Salida de error.

Opciones

Entrada o 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.