Origine ADO NETADO NET Source

L'origine ADO NET utilizza i dati di un provider .NET e li rende disponibili per il flusso di dati.The ADO NET source consumes data from a .NET provider and makes the data available to the data flow.

È possibile usare l'origine ADO NET per connettersi a MicrosoftMicrosoft Database SQL di AzureAzure SQL Database.You can use the ADO NET source to connect to MicrosoftMicrosoft Database SQL di AzureAzure SQL Database. La connessione a Database SQLSQL Database tramite OLE DB non è supportata.Connecting to Database SQLSQL Database by using OLE DB is not supported. Per altre informazioni su Database SQLSQL Database, vedere Limitazioni e linee guida generali per il database SQL di Azure.For more information about Database SQLSQL Database, see General Guidelines and Limitations (Windows Azure SQL Database).

Supporto dei tipi di datiData Type Support

Tramite l'origine viene convertito qualsiasi tipo di dati di cui non è stato eseguito il mapping a un tipo di dati specifico di Integration ServicesIntegration Services nel tipo di dati DT_NTEXT di Integration ServicesIntegration Services .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. La conversione viene eseguita anche se il tipo di dati è System.Object.This conversion occurs even if the data type is System.Object.

È possibile modificare il tipo di dati DT_NTEXT nel tipo di dati DT_WSTR e vice versa.You can change the DT_NTEXT data type to the DT_WSTR data type, or the change DT_WSTR to DT_NTEXT. È possibile modificare i tipi di dati configurando la proprietà DataType nella finestra di dialogo Editor avanzato dell'origine ADO NET.You change data types by setting the DataType property in the Advanced Editor dialog box of the ADO NET source. Per altre informazioni, vedere Proprietà comuni.For more information, see Common Properties.

Il tipo di dati DT_NTEXT può anche essere convertito nel tipo di dati DT_BYTES o DT_STR utilizzando una trasformazione Conversione dati sull'origine 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. Per altre informazioni, vedere Trasformazione Conversione dati.For more information, see Data Conversion Transformation.

In Integration ServicesIntegration Servicessui tipi di dati relativi alle date, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 e DT_DBTIMESTAMPOFFSET, viene eseguito il mapping a tipi di dati relativi alle date specifici in 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. È possibile configurare l'origine ADO NET per convertire i tipi di dati relativi alle date usati in SQL ServerSQL Server nei tipi usati in 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. Per configurare l'origine ADO NET per convertire questi tipi di dati relativi alle date, impostare la proprietà Type System Version della gestione connessione ADO.NETADO.NET su Ultima versione.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 proprietà Type System Version si trova nella pagina Tutto della finestra di dialogo Gestione connessione .(The Type System Version property is on the All page of the Connection Manager dialog box. Per aprire la finestra di dialogo Gestione connessione , fare clic con il pulsante destro del mouse sulla gestione connessione ADO.NETADO.NET e quindi su Modifica.To open the Connection Manager dialog box, right-click the ADO.NETADO.NET connection manager, and then click Edit.)

Nota

Se la proprietà Type System Version della gestione connessione ADO.NETADO.NET è impostata su SQL Server 2005, i tipi di dati per le date di SQL ServerSQL Server vengono convertiti in dati 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.

I tipi di dati definiti dall'utente (UDT, User-Defined Type) vengono convertiti negli oggetti binari di grandi dimensioni (Binary Large Object) di Integration ServicesIntegration Services quando la gestione connessione ADO.NETADO.NET specifica il provider come provider di dati .NET per 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). Durante la conversione del tipo di dati definito dall'utente (UDT), vengono applicate le regole seguenti:The system applies the following rules when it converts the UDT data type:

  • Se i dati sono di tipo definito dall'utente (UDT) di piccole dimensioni, vengono convertiti nel tipo di dati DT_BYTES.If the data is a non-large UDT, the system converts the data to DT_BYTES.

  • Se i dati sono di tipo definito dall'utente (UDT) non di grandi dimensioni e la proprietà Length della colonna nel database è impostata su -1 o su un valore maggiore di 8000 byte, i dati vengono convertiti nel tipo di dati 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.

  • Se i dati sono di tipo definito dall'utente (UDT) di grandi dimensioni, vengono convertiti nel tipo di dati DT_IMAGE.If the data is a large UDT, the system converts the data to DT_IMAGE.

    Nota

    Se l'origine ADO NET non è configurata per l'utilizzo dell'output degli errori, i dati vengono trasmessi alla colonna DT_IMAGE in blocchi da 8.000 byte.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. Se l'origine ADO NET è configurata per l'utilizzo dell'output degli errori, l'intera matrice di byte viene trasmessa alla colonna 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. Per altre informazioni sulla configurazione dei componenti per l'uso dell'output degli errori, vedere Gestione degli errori nei dati.For more information about how to configure components to use error output, see Error Handling in Data.

    Per altre informazioni sui tipi di dati di Integration ServicesIntegration Services , sulle conversioni dei tipi di dati supportate e sul mapping dei tipi di dati in alcuni database, tra cui SQL ServerSQL Server, vedere Tipi di dati di 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.

    Per altre informazioni sul mapping di tipi di dati di Integration ServicesIntegration Services a tipi di dati gestiti, vedere Utilizzo di tipi di dati nel flusso di dati.For information about mapping Integration ServicesIntegration Services data types to managed data types, see Working with Data Types in the Data Flow.

Risoluzione dei problemi relativi all'origine ADO NETADO NET Source Troubleshooting

È possibile registrare le chiamate eseguite dall'origine ADO NET a provider di dati esterni.You can log the calls that the ADO NET source makes to external data providers. Questa funzionalità di registrazione può essere utilizzata per risolvere i problemi relativi al caricamento di dati da origini esterne da parte dell'origine ADO NET.You can use this logging capability to troubleshoot the loading of data from external data sources that the ADO NET source performs. Per registrare le chiamate eseguite dall'origine ADO NET a provider di dati esterni, abilitare la registrazione dei pacchetti e selezionare l'evento Diagnostic al livello di pacchetto.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. Per altre informazioni, vedere Risoluzione dei problemi relativi agli strumenti per l'esecuzione del pacchetto.For more information, see Troubleshooting Tools for Package Execution.

Configurazione dell'origine ADO NETADO NET Source Configuration

Per configurare l'origine ADO NET, è necessario specificare l'istruzione SQL che definisce il set di risultati.You configure the ADO NET source by providing the SQL statement that defines the result set. Un'origine ADO NET che si connette ad esempio al database AdventureWorks2012AdventureWorks2012 e usa l'istruzione SQL SELECT * FROM Production.Product estrae tutte le righe della tabella Production.Product e fornisce il set di dati a un componente a valle.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

Quando si utilizza un'istruzione SQL per richiamare una stored procedure che restituisce risultati da una tabella temporanea, utilizzare l'opzione WITH RESULT SETS per definire metadati per il set di risultati.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

Se si usa un'istruzione SQL per eseguire una stored procedure e l'esecuzione del pacchetto ha esito negativo con l'errore seguente, è possibile risolvere il problema aggiungendo l'istruzione SET FMTONLY OFF prima dell'istruzione 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.

Impossibile trovare la colonna <nome_colonna> nell'origine dati.Column <column_name> cannot be found at the datasource.

Nell'origine ADO NET viene usata una gestione connessione ADO.NETADO.NET in cui è specificato il provider .NET per connettersi a un'origine dati.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. Per altre informazioni, vedere Gestione connessione ADO.NET.For more information, see ADO.NET Connection Manager.

L'origine ADO NET include un output regolare e un output degli errori.The ADO NET source has one regular output and one error output.

È possibile impostare le proprietà tramite Progettazione SSISSSIS o a livello di codice.You can set properties through SSISSSIS Designer or programmatically.

Per ulteriori informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor avanzato o a livello di codice, fare clic su uno degli argomenti seguenti:For more information about the properties that you can set in the Advanced Editor dialog box or programmatically, click one of the following topics:

Editor origine ADO NET (pagina Gestione connessione)ADO NET Source Editor (Connection Manager Page)

Usare la pagina Gestione connessione della finestra di dialogo Editor origine ADO.NET per selezionare la gestione connessione ADO.NETADO.NET per l'origine.Use the Connection Manager page of the ADO NET Source Editor dialog box to select the ADO.NETADO.NET connection manager for the source. Tramite questa pagina è inoltre possibile selezionare una tabella o una vista del database.This page also lets you select a table or view from the database.

Per ulteriori informazioni sull'origine ADO NET, vedere ADO NET Source.To learn more about the ADO NET source, see ADO NET Source.

Per aprire la pagina Gestione connessioneTo open the Connection Manager page

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), aprire il pacchetto Integration ServicesIntegration Services con l'origine 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. Nella scheda Flusso di dati fare doppio clic sull'origine ADO NET.On the Data Flow tab, double-click the ADO NET source.

  3. In Editor origine ADO.NET, fare clic su Gestione connessione.In the ADO NET Source Editor, click Connection Manager.

Opzioni staticheStatic Options

Gestione connessione ADO.NETADO.NET connection manager
Selezionare una gestione connessione esistente nell'elenco o crearne una nuova facendo clic su Nuova.Select an existing connection manager from the list, or create a new connection by clicking New.

NuovaNew
Consente di creare una nuova gestione connessione usando la finestra di dialogo Configura gestione connessione ADO.NET .Create a new connection manager by using the Configure ADO.NET Connection Manager dialog box.

Modalità di accesso ai datiData access mode
Consente di specificare il metodo per la selezione dei dati dall'origine.Specify the method for selecting data from the source.

OpzioneOption DescriptionDescription
Tabella o vistaTable or view Consente di recuperare dati da una tabella o da una vista nell'origine dei dati ADO.NETADO.NET .Retrieve data from a table or view in the ADO.NETADO.NET data source.
Comando SQLSQL command Consente di recuperare dati dall'origine dei dati ADO.NETADO.NET usando una query SQL.Retrieve data from the ADO.NETADO.NET data source by using a SQL query.

AnteprimaPreview
Consente di visualizzare in anteprima i risultati nella finestra di dialogo Vista dati .Preview results by using the Data View dialog box. L'anteprima supporta la visualizzazione di un massimo di 200 righe.Preview can display up to 200 rows.

Nota

Quando vengono visualizzati i dati in anteprima, le colonne con tipo definito dall'utente CLR (UDT) non contengono dati.When you preview data, columns with a CLR user-defined type do not contain data. Invece i valori <valore troppo grande per essere visualizzato > o System. Byte [].Instead the values <value too big to display> or System.Byte[] display. Il primo viene visualizzato se si accede all'origine dei dati mediante il ADO.NETADO.NET, il secondo se si utilizza il provider 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.

Opzioni dinamiche relative alla modalità di accesso ai datiData Access Mode Dynamic Options

Modalità di accesso ai dati = Tabella o vistaData access mode = Table or view

Nome tabella o vistaName of the table or the view
Consente di selezionare il nome della tabella o della vista nell'elenco dei nomi disponibili nell'origine dei dati.Select the name of the table or view from a list of those available in the data source.

Modalità di accesso ai dati = Comando SQLData access mode = SQL command

Testo comando SQLSQL command text
Immettere il testo di una query SQL, fare clic su Compila queryper compilare la query o fare clic su Sfogliaper individuare il file che contiene il testo della query.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.

Build queryBuild query
Usare la finestra di dialogo Generatore query per creare la query SQL con strumenti grafici.Use the Query Builder dialog box to construct the SQL query visually.

SfogliaBrowse
Usare la finestra di dialogo Apri per individuare il file contenente il testo della query SQL.Use the Open dialog box to locate the file that contains the text of the SQL query.

Editor origine ADO NET (pagina Colonne)ADO NET Source Editor (Columns Page)

Usare la pagina Colonne della finestra di dialogo Editor origine ADO NET per eseguire il mapping tra una colonna di output e ogni colonna esterna (di origine).Use the Columns page of the ADO NET Source Editor dialog box to map an output column to each external (source) column.

Per ulteriori informazioni sull'origine ADO NET, vedere ADO NET Source.To learn more about the ADO NET source, see ADO NET Source.

Per aprire la pagina ColonneTo open the Columns page

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), aprire il pacchetto Integration ServicesIntegration Services con l'origine 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. Nella scheda Flusso di dati fare doppio clic sull'origine ADO NET.On the Data Flow tab, double-click the ADO NET source.

  3. In Editor origine ADO NET, fare clic su Colonne.In the ADO NET Source Editor, click Columns.

OpzioniOptions

Colonne esterne disponibiliAvailable External Columns
Consente di visualizzare l'elenco delle colonne esterne disponibili nell'origine dei dati.View the list of available external columns in the data source. Non è possibile utilizzare questa tabella per l'aggiunta o l'eliminazione di colonne.You cannot use this table to add or delete columns.

Colonna esternaExternal Column
Consente di visualizzare le colonne esterne (di origine) nell'ordine in cui verranno presentate durante la configurazione di componenti che utilizzano i dati dell'origine.View external (source) columns in the order in which you will see them when configuring components that consume data from this source.

Colonna di outputOutput Column
Consente di specificare un nome univoco per ogni colonna di output.Provide a unique name for each output column. Per impostazione predefinita viene suggerito il nome della colonna esterna (di origine) selezionata. È comunque possibile scegliere qualsiasi nome descrittivo univoco.The default is the name of the selected external (source) column; however, you can choose any unique, descriptive name. Il nome specificato verrà visualizzato in Progettazione SSISSSIS .The name provided will be displayed within the SSISSSIS Designer.

Editor origine ADO NET (pagina Output errori)ADO NET Source Editor (Error Output Page)

Usare la pagina Output errori della finestra di dialogo Editor origine ADO NET per selezionare le opzioni di gestione degli errori e impostare le proprietà delle colonne di output degli errori.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.

Per ulteriori informazioni sull'origine ADO NET, vedere ADO NET Source.To learn more about the ADO NET source, see ADO NET Source.

Per aprire la pagina Output erroriTo open the Error Output page

  1. In SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT), aprire il pacchetto Integration ServicesIntegration Services con l'origine 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. Nella scheda Flusso di dati fare doppio clic sull'origine ADO NET.On the Data Flow tab, double-click the ADO NET source.

  3. In Editor origine ADO NET, fare clic su Output errori.In the ADO NET Source Editor, click Error Output.

OpzioniOptions

Input/OutputInput/Output
Consente di visualizzare il nome dell'origine dei dati.View the name of the data source.

ColonnaColumn
Consente di visualizzare le colonne esterne (di origine) selezionate nella pagina Gestione connessione della finestra di dialogo Editor origine ADO NET .View the external (source) columns that you selected on the Connection Manager page of the ADO NET Source Editor dialog box.

ErroreError
Consente di specificare l'azione da eseguire in caso di errori, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen when an error occurs: ignore the failure, redirect the row, or fail the component.

Argomenti correlati: Gestione degli errori nei datiRelated Topics: Error Handling in Data

TroncamentoTruncation
Consente di specificare l'azione da eseguire in caso di troncamenti, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.Specify what should happen when a truncation occurs: ignore the failure, redirect the row, or fail the component.

DescriptionDescription
Consente di visualizzare la descrizione dell'errore.View the description of the error.

Imposta questo valore nelle celle selezionateSet this value to selected cells
Consente di specificare l'azione che dovrà interessare tutte le celle selezionate in caso di errore o troncamento: ignorare l'errore, reindirizzare la riga o interrompere il componente.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.

ApplicaApply
Consente di applicare l'opzione di gestione degli errori alle celle selezionate.Apply the error handling option to the selected cells.

Vedere ancheSee Also

Destinazione DataReader DataReader Destination
Destinazione ADO NET ADO NET Destination
Flusso di datiData Flow