Origen de ADO NETADO NET Source

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) sí SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data FactorySe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) sí SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS Integration Runtime en Azure Data FactorySSIS Integration Runtime in Azure Data Factory

El origen de ADO NET consume datos de un proveedor .NET y hace que los datos estén disponibles para el flujo de datos.The ADO NET source consumes data from a .NET provider and makes the data available to the data flow.

Puede usar el origen de ADO NET para conectarse a MicrosoftMicrosoft Azure SQL DatabaseAzure SQL Database.You can use the ADO NET source to connect to MicrosoftMicrosoft Azure SQL DatabaseAzure SQL Database. No se admite la conexión a SQL DatabaseSQL Database mediante OLE DB.Connecting to SQL DatabaseSQL Database by using OLE DB is not supported. Para más información sobre SQL DatabaseSQL Database, consulte Instrucciones y limitaciones generales (Azure SQL Database).For more information about SQL DatabaseSQL Database, see General Guidelines and Limitations (Azure SQL Database).

Compatibilidad con tipos de datosData Type Support

El origen convierte cualquier tipo de datos que no se asigna a un tipo de datos de Integration ServicesIntegration Services específico en el tipo de datos de Integration ServicesIntegration Services DT_NTEXT.The source converts any data type that does not map to a specific Integration ServicesIntegration Services data type to the DT_NTEXT Integration ServicesIntegration Services data type. Esta conversión se produce aunque el tipo de datos sea System.Object.This conversion occurs even if the data type is System.Object.

Puede cambiar el tipo de datos DT_NTEXT a DT_WSTR, o el tipo de datos DT_WSTR a DT_NTEXT.You can change the DT_NTEXT data type to the DT_WSTR data type, or the change DT_WSTR to DT_NTEXT. Para cambiar los tipos de datos, establezca la propiedad DataType en el cuadro de diálogo Editor avanzado del origen de ADO NET.You change data types by setting the DataType property in the Advanced Editor dialog box of the ADO NET source. Para más información, consulte Common Properties.For more information, see Common Properties.

El tipo de datos DT_NTEXT también se puede convertir en el tipo de datos DT_BYTES o DT_STR utilizando una transformación de conversión de datos después del origen de ADO NET.The DT_NTEXT data type can also be converted to the DT_BYTES or DT_STR data type by using a Data Conversion transformation after the ADO NET source. Para más información, consulte Data Conversion Transformation.For more information, see Data Conversion Transformation.

En Integration ServicesIntegration Services, los tipos de datos de fecha, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 y DT_DBTIMESTAMPOFFSET, se asignan a ciertos tipos de datos de fecha de SQL ServerSQL Server.In Integration ServicesIntegration Services, the date data types, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2, and DT_DBTIMESTAMPOFFSET, map to certain date data types in SQL ServerSQL Server. Puede configurar el origen de ADO NET de modo que se conviertan los tipos de datos de fecha de los datos que utiliza SQL ServerSQL Server en los que usa Integration ServicesIntegration Services .You can configure the ADO NET source to convert the date data types from those that SQL ServerSQL Server uses to those that Integration ServicesIntegration Services uses. Para configurar el origen de ADO NET de modo que se conviertan estos tipos de datos de fecha, establezca la propiedad Type System Version del administrador de conexiones de ADO.NETADO.NET en Latest.To configure the ADO NET source to convert these date data types, set the Type System Version property of the ADO.NETADO.NET connection manager to Latest. (La propiedad Type System Version está en la página Todo del cuadro de diálogo Administrador de conexiones .(The Type System Version property is on the All page of the Connection Manager dialog box. Para abrir el cuadro de diálogo Administrador de conexiones , haga clic con el botón derecho en el administrador de conexiones de ADO.NETADO.NET y, después, elija Editar).To open the Connection Manager dialog box, right-click the ADO.NETADO.NET connection manager, and then click Edit.)

Nota

Si la propiedad Type System Version del administrador de conexiones de ADO.NETADO.NET se establece en SQL Server 2005, el sistema convierte los tipos de datos de fecha de SQL ServerSQL Server en DT_WSTR.If the Type System Version property for the ADO.NETADO.NET connection manager is set to SQL Server 2005, the system converts the SQL ServerSQL Server date data types to DT_WSTR.

El sistema convierte los tipos de datos definidos por el usuario (UDT) en objetos binarios grandes (BLOB) de Integration ServicesIntegration Services cuando el administrador de conexiones de ADO.NETADO.NET especifica el proveedor como Proveedor de datos .NET para SQL ServerSQL Server (SqlClient).The system converts user-defined data types (UDTs) to Integration ServicesIntegration Services binary large objects (BLOB) when the ADO.NETADO.NET connection manager specifies the provider as the .NET Data Provider for SQL ServerSQL Server (SqlClient). El sistema aplica las reglas siguientes cuando convierte el tipo de datos UDT:The system applies the following rules when it converts the UDT data type:

  • Si los datos son de un tipo UDT que no es grande, el sistema los convierte en DT_BYTES.If the data is a non-large UDT, the system converts the data to DT_BYTES.

  • Si los datos son de un tipo UDT que no es grande y la propiedad Length de la columna de la base de datos se establece en -1 o en un valor mayor que 8000 bytes, el sistema convierte los datos en DT_IMAGE.If the data is a non-large UDT, and the Length property of the column on the database is set to -1 or a value greater than 8,000 bytes, the system converts the data to DT_IMAGE.

  • Si los datos son de un tipo UDT grande, el sistema los convierte en DT_IMAGE.If the data is a large UDT, the system converts the data to DT_IMAGE.

    Nota

    Si el origen de ADO NET no está configurado para utilizar la salida de errores, el sistema pasa el flujo de datos a la columna DT_IMAGE en fragmentos de 8.000 bytes.If the ADO NET source is not configured to use error output, the system streams the data to the DT_IMAGE column in chunks of 8,000 bytes. Si el origen de ADO NET está configurado para utilizar la salida de errores, el sistema pasa la matriz entera de bytes a la columna DT_IMAGE.If the ADO NET source is configured to use error output, the system passes the whole array of bytes to the DT_IMAGE column. Para más información sobre cómo configurar los componentes para que se use la salida de errores, vea Control de errores en los datos.For more information about how to configure components to use error output, see Error Handling in Data.

Para más información sobre los tipos de datos de Integration ServicesIntegration Services , las conversiones de tipos de datos admitidas y la asignación de tipo de datos en bases de datos específicas (como SQL ServerSQL Server), vea Tipos de datos de Integration Services.For more information about the Integration ServicesIntegration Services data types, supported data type conversions, and data type mapping across certain databases including SQL ServerSQL Server, see Integration Services Data Types.

Para más información sobre cómo asignar tipos de datos de Integration ServicesIntegration Services a tipos de datos administrados, vea Trabajar con tipos de datos del flujo de datos.For information about mapping Integration ServicesIntegration Services data types to managed data types, see Working with Data Types in the Data Flow.

Solución de problemas del origen de ADO NETADO NET Source Troubleshooting

Puede registrar las llamadas que el origen de ADO NET realiza a proveedores de datos externos.You can log the calls that the ADO NET source makes to external data providers. Puede utilizar esta capacidad de registro para solucionar los problemas relacionados con la carga de datos de orígenes de datos externos que realiza el origen de ADO NET.You can use this logging capability to troubleshoot the loading of data from external data sources that the ADO NET source performs. Para registrar las llamadas realizadas por el origen de ADO NET a proveedores de datos externos, habilite el registro de paquetes y seleccione el evento Diagnostic en el nivel de paquete.To log the calls that the ADO NET source makes to external data providers, enable package logging and select the Diagnostic event at the package level. Para más información, vea Herramientas para solucionar problemas con la ejecución de paquetes.For more information, see Troubleshooting Tools for Package Execution.

Configuración del origen de ADO NETADO NET Source Configuration

Para configurar el origen de ADO NET, debe proporcionar la instrucción SQL que define el conjunto de resultados.You configure the ADO NET source by providing the SQL statement that defines the result set. Por ejemplo, un origen de ADO NET que se conecta a la base de datos AdventureWorks2012AdventureWorks2012 y utiliza la instrucción SQL SELECT * FROM Production.Product extrae todas las filas de la tabla Production.Product y proporciona el conjunto de datos a un componente de nivel inferior.For example, an ADO NET source that connects to the AdventureWorks2012AdventureWorks2012 database and uses the SQL statement SELECT * FROM Production.Product extracts all the rows from the Production.Product table and provides the dataset to a downstream component.

Nota

Cuando use una instrucción SQL para invocar un procedimiento almacenado que devuelve resultados de una tabla temporal, use la opción WITH RESULT SETS para definir los metadatos del conjunto de resultados.When you use an SQL statement to invoke a stored procedure that returns results from a temporary table, use the WITH RESULT SETS option to define metadata for the result set.

Nota

Si usa una instrucción SQL para ejecutar un procedimiento almacenado y el paquete genera el error siguiente, es posible que pueda solucionar el error si agrega la instrucción SET FMTONLY OFF antes de la instrucción EXEC.If you use an SQL statement to execute a stored procedure and the package fails with the following error, you may be able to resolve the error by adding the SET FMTONLY OFF statement before the exec statement.

La columna <column_name> no se encuentra en el origen de datos.Column <column_name> cannot be found at the datasource.

Este origen de ADO NET utiliza un administrador de conexiones ADO.NETADO.NET para conectarse a un origen de datos. El administrador de conexiones especifica el proveedor .NET.The ADO NET source uses an ADO.NETADO.NET connection manager to connect to a data source, and the connection manager specifies the .NET provider. Para más información, consulte ADO.NET Connection Manager.For more information, see ADO.NET Connection Manager.

El origen de ADO NET tiene una salida normal y una salida de errores.The ADO NET source has one regular output and one error output.

Puede establecer propiedades a través del Diseñador de SSISSSIS o mediante programación.You can set properties through SSISSSIS Designer or programmatically.

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:For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

Para más información sobre cómo establecer propiedades, vea Establecer las propiedades de un componente de flujo de datos.For more information about how to set properties, see Set the Properties of a Data Flow Component.

Editor de orígenes de ADO NET (página Administrador de conexiones)ADO NET Source Editor (Connection Manager Page)

Utilice la página Administrador de conexiones del cuadro de diálogo Editor de orígenes de ADO NET para seleccionar el administrador de conexiones ADO.NETADO.NET para el origen.Use the Connection Manager page of the ADO NET Source Editor dialog box to select the ADO.NETADO.NET connection manager for the source. Esta página también permite seleccionar una tabla o vista de la base de datos.This page also lets you select a table or view from the database.

Para obtener más información acerca del origen de ADO NET, vea ADO NET Source.To learn more about the ADO NET source, see ADO NET Source.

Para abrir la página Administrador de conexionesTo open the Connection Manager page

  1. En SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), abra el paquete Integration ServicesIntegration Services que tiene el origen de ADO NET.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services package that has the ADO NET source.

  2. En la pestaña Flujo de datos , haga doble clic en el origen de ADO NET.On the Data Flow tab, double-click the ADO NET source.

  3. En el Editor de orígenes de ADO NET, haga clic en Administrador de conexiones.In the ADO NET Source Editor, click Connection Manager.

Opciones estáticasStatic Options

Administrador de conexiones de ADO.NETADO.NET connection manager
Seleccione un administrador de conexiones de la lista o cree una conexión haciendo clic en Nuevo.Select an existing connection manager from the list, or create a new connection by clicking New.

NuevoNew
Cree un administrador de conexiones mediante el cuadro de diálogo Configurar el administrador de conexiones ADO.NET .Create a new connection manager by using the Configure ADO.NET Connection Manager dialog box.

Modo de acceso a datosData access mode
Especifique el método para seleccionar datos del origen.Specify the method for selecting data from the source.

OpciónOption DescripciónDescription
Tabla o vistaTable or view Recupera datos de una tabla o vista del origen de datos ADO.NETADO.NET .Retrieve data from a table or view in the ADO.NETADO.NET data source.
Comando SQLSQL command Recupera datos del origen de datos ADO.NETADO.NET mediante una consulta SQL.Retrieve data from the ADO.NETADO.NET data source by using a SQL query.

Versión preliminarPreview
Muestra una vista previa de los resultados mediante el cuadro de diálogo Vista de datos .Preview results by using the Data View dialog box. Vista previa puede mostrar hasta 200 filas.Preview can display up to 200 rows.

Nota

Cuando genera una vista previa de datos, las columnas con un tipo definido por el usuario CLR no contienen datos.When you preview data, columns with a CLR user-defined type do not contain data. En su lugar, se muestran los valores <value too big to display> o System.Byte[].Instead the values <value too big to display> or System.Byte[] display. El primero se muestra cuando se tiene acceso al origen de datos mediante el proveedor ADO.NETADO.NET y el último, cuando se utiliza el proveedor SQL ServerSQL Server Native Client.The former displays when the data source is accessed by using the ADO.NETADO.NET provider, the latter when using the SQL ServerSQL Server Native Client provider.

Opciones dinámicas del modo de acceso a datosData Access Mode Dynamic Options

Modo de acceso a datos = Tabla o vistaData access mode = Table or view

Nombre de la tabla o la vistaName of the table or the view
Seleccione el nombre de la tabla o vista de los disponibles en una lista del origen de datos.Select the name of the table or view from a list of those available in the data source.

Modo de acceso a datos = Comando SQLData access mode = SQL command

Texto de comando SQLSQL command text
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.Enter the text of a SQL query, build the query by clicking Build Query, or locate the file that contains the query text by clicking Browse.

Generar consultaBuild query
Use el cuadro de diálogo Generador de consultas para crear visualmente la consulta SQL.Use the Query Builder dialog box to construct the SQL query visually.

BrowseBrowse
Use el cuadro de diálogo Abrir para buscar el archivo que contiene el texto de la consulta SQL.Use the Open dialog box to locate the file that contains the text of the SQL query.

Editor de orígenes de ADO NET (página Columnas)ADO NET Source Editor (Columns Page)

Use la página Columnas del cuadro de diálogo Editor de orígenes de ADO NET para asignar una columna de salida a cada columna externa (origen).Use the Columns page of the ADO NET Source Editor dialog box to map an output column to each external (source) column.

Para obtener más información acerca del origen de ADO NET, vea ADO NET Source.To learn more about the ADO NET source, see ADO NET Source.

Para abrir la página ColumnasTo open the Columns page

  1. En SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), abra el paquete Integration ServicesIntegration Services que tiene el origen de ADO NET.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services package that has the ADO NET source.

  2. En la pestaña Flujo de datos , haga doble clic en el origen de ADO NET.On the Data Flow tab, double-click the ADO NET source.

  3. En el Editor de orígenes de ADO NET, haga clic en Columnas.In the ADO NET Source Editor, click Columns.

OpcionesOptions

Columnas externas disponiblesAvailable External Columns
Muestra la lista de columnas externas disponibles en el origen de datos.View the list of available external columns in the data source. Esta tabla no se puede usar para agregar o quitar columnas.You cannot use this table to add or delete columns.

Columna externaExternal Column
Muestra las columnas externas (origen) en el orden en que se verán cuando configure componentes que utilizan datos de este origen.View external (source) columns in the order in which you will see them when configuring components that consume data from this source.

Columna de salidaOutput Column
Permite proporcionar un nombre único para cada columna de salida.Provide a unique name for each output column. El nombre predeterminado es el nombre de la columna externa (origen) seleccionada; sin embargo, puede elegir un nombre único y descriptivo.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name. El nombre proporcionado se mostrará en el Diseñador de SSISSSIS .The name provided will be displayed within the SSISSSIS Designer.

Editor de orígenes de ADO NET (página Salida de error)ADO NET Source Editor (Error Output Page)

Utilice la página Salida de error del cuadro de diálogo Editor de orígenes de ADO NET para seleccionar las opciones de control de errores y para establecer las propiedades en las columnas de salida de errores.Use the Error Output page of the ADO NET Source Editor dialog box to select error handling options and to set properties on error output columns.

Para obtener más información acerca del origen de ADO NET, vea ADO NET Source.To learn more about the ADO NET source, see ADO NET Source.

Para abrir la página Salida de errorTo open the Error Output page

  1. En SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), abra el paquete Integration ServicesIntegration Services que tiene el origen de ADO NET.In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), open the Integration ServicesIntegration Services package that has the ADO NET source.

  2. En la pestaña Flujo de datos , haga doble clic en el origen de ADO NET.On the Data Flow tab, double-click the ADO NET source.

  3. En el Editor de orígenes de ADO NET, haga clic en Salida de error.In the ADO NET Source Editor, click Error Output.

OpcionesOptions

Entrada/salidaInput/Output
Muestra el nombre del origen de datos.View the name of the data source.

ColumnaColumn
Muestra las columnas externas (origen) que se han seleccionado en la página Administrador de conexiones del cuadro de diálogo Editor de orígenes de ADO NET .View the external (source) columns that you selected on the Connection Manager page of the ADO NET Source Editor dialog box.

ErrorError
Permite especificar qué debe ocurrir cuando se produce un error: omitir el error, redirigir la fila o hacer que el componente no funcione.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

Temas relacionados: Control de errores en los datosRelated Topics: Error Handling in Data

TruncamientoTruncation
Permite especificar qué debe ocurrir cuando se produce un truncamiento: omitir el error, redirigir la fila o hacer que el componente no funcione.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescripciónDescription
Muestra la descripción del error.View the description of the error.

Establecer este valor en las celdas seleccionadasSet this value to selected cells
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.Specify what should happen to all the selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

AplicarApply
Aplica la opción de control de errores a las celdas seleccionadas.Apply the error handling option to the selected cells.

Consulte tambiénSee Also

Destino de DataReader DataReader Destination
Destino de ADO NET ADO NET Destination
Flujo de datosData Flow