Condividi tramite


Origine ADO NET

Si applica a: SQL Server SSIS Integration Runtime in Azure Data Factory

L'origine ADO NET utilizza i dati di un provider .NET e li rende disponibili per il flusso di dati.

È possibile usare l'origine ADO.NET per connettersi al database SQL di Microsoft Azure. La connessione al database SQL tramite OLE DB non è supportata. Per altre informazioni sul database SQL, vedere Linee guida generali e limitazioni (database SQL di Azure).

Supporto dei tipi di dati

L'origine converte qualsiasi tipo di dati di cui non è stato eseguito il mapping a un tipo di dati specifico di Integration Services nel tipo di dati DT_NTEXT di Integration Services. La conversione viene eseguita anche se il tipo di dati è System.Object.

È possibile modificare il tipo di dati DT_NTEXT nel tipo di dati DT_WSTR e vice versa. È possibile modificare i tipi di dati configurando la proprietà DataType nella finestra di dialogo Editor avanzato dell'origine ADO NET. Per altre informazioni, vedere Proprietà comuni.

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. Per altre informazioni, vedere Trasformazione Conversione dati.

In Integration Services sui 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 Server. È possibile configurare l'origine ADO NET per convertire i tipi di dati relativi alle date usati in SQL Server nei tipi usati in Integration Services. Per configurare l'origine ADO NET per convertire questi tipi di dati relativi alle date, impostare la proprietà Versione del sistema di tipi della gestione connessione ADO.NET su Ultima versione. La proprietà Versione del sistema di tipi si trova nella pagina Tutto della finestra di dialogo Gestione connessione. Per aprire la finestra di dialogo Gestione connessioni, fare clic con il pulsante destro del mouse sulla gestione connessione ADO.NET e quindi scegliere Modifica.

Nota

Se la proprietà Versione del sistema di tipi della gestione connessione ADO.NET è impostata su SQL Server 2005, i tipi di dati per le date di SQL Server vengono convertiti in dati 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 Services quando la gestione connessione ADO.NET specifica il provider di dati .NET per SQL Server (SqlClient) come provider. Durante la conversione del tipo di dati definito dall'utente (UDT), vengono applicate le regole seguenti:

  • Se i dati sono di tipo definito dall'utente (UDT) di piccole dimensioni, vengono convertiti nel tipo di dati 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.

  • Se i dati sono di tipo definito dall'utente (UDT) di grandi dimensioni, vengono convertiti nel tipo di dati 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. Se l'origine ADO NET è configurata per l'utilizzo dell'output degli errori, l'intera matrice di byte viene trasmessa alla colonna DT_IMAGE. Per altre informazioni sulla configurazione dei componenti per l'uso dell'output degli errori, vedere Gestione degli errori nei dati.

Per altre informazioni sui tipi di dati di Integration Services, sulle conversioni dei tipi di dati supportate e sul mapping dei tipi di dati in alcuni database, tra cui SQL Server, vedere Tipi di dati di Integration Services.

Per informazioni sul mapping di tipi di dati di Integration Services a tipi di dati gestiti, vedere Utilizzo di tipi di dati nel flusso di dati.

Risoluzione dei problemi relativi all'origine ADO NET

È possibile registrare le chiamate eseguite dall'origine ADO NET a provider di dati esterni. 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. 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. Per altre informazioni, vedere Risoluzione dei problemi relativi agli strumenti per l'esecuzione del pacchetto.

Configurazione dell'origine ADO NET

Per configurare l'origine ADO NET, è necessario specificare l'istruzione SQL che definisce il set di risultati. Un'origine ADO NET che si connette ad esempio al database AdventureWorks2022 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.

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.

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.

Impossibile trovare la colonna <nome_colonna> nell'origine dati.

Nell'origine ADO NET viene usata una gestione connessione ADO.NET in cui è specificato il provider .NET per connettersi a un'origine dati. Per altre informazioni, vedere Gestione connessione ADO.NET.

L'origine ADO NET include un output regolare e un output degli errori.

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

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:

Per altre informazioni su come impostare le proprietà, vedere Impostazione delle proprietà di un componente del flusso di dati.

Editor origine ADO NET (pagina Gestione connessione)

Usare la pagina Gestione connessione della finestra di dialogo Editor origine ADO.NET per selezionare la gestione connessione ADO.NET per l'origine. Tramite questa pagina è inoltre possibile selezionare una tabella o una vista del database.

Per ulteriori informazioni sull'origine ADO NET, vedere ADO NET Source.

Per aprire la pagina Gestione connessione

  1. In SQL Server Data Tools (SSDT) aprire il pacchetto di Integration Services che include l'origine ADO.NET.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine ADO NET.

  3. In Editor origine ADO.NET, fare clic su Gestione connessione.

Opzioni statiche

Gestione connessione ADO.NET
Selezionare una gestione connessione esistente nell'elenco o crearne una nuova facendo clic su Nuova.

New
Consente di creare una nuova gestione connessione usando la finestra di dialogo Configura gestione connessione ADO.NET .

Modalità di accesso ai dati
Consente di specificare il metodo per la selezione dei dati dall'origine.

Opzione Descrizione
Tabella o vista Consente di recuperare dati da una tabella o da una vista nell'origine dati ADO.NET.
Comando SQL Consente di recuperare dati dall'origine dei dati ADO.NET usando una query SQL.

Anteprima
Consente di visualizzare in anteprima i risultati nella finestra di dialogo Vista dati . L'anteprima supporta la visualizzazione di un massimo di 200 righe.

Nota

Quando vengono visualizzati i dati in anteprima, le colonne con tipo definito dall'utente CLR (UDT) non contengono dati. Vengono invece visualizzati i valori <dimensione valore eccessiva per la visualizzazione> o System.Byte[]. Il primo viene visualizzato se si accede all'origine dei dati mediante il provider ADO.NET, il secondo se si usa il provider SQL Server Native Client.

Opzioni dinamiche relative alla modalità di accesso ai dati

Modalità di accesso ai dati = Tabella o vista

Nome tabella o vista
Consente di selezionare il nome della tabella o della vista nell'elenco dei nomi disponibili nell'origine dei dati.

Modalità di accesso ai dati = Comando SQL

Testo comando SQL
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.

Compila query
Usare la finestra di dialogo Generatore query per creare la query SQL con strumenti grafici visuali.

Sfoglia
Usare la finestra di dialogo Apri per individuare il file contenente il testo della query SQL.

Editor origine ADO NET (pagina Colonne)

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).

Per ulteriori informazioni sull'origine ADO NET, vedere ADO NET Source.

Per aprire la pagina Colonne

  1. In SQL Server Data Tools (SSDT) aprire il pacchetto di Integration Services che include l'origine ADO.NET.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine ADO NET.

  3. In Editor origine ADO NET, fare clic su Colonne.

Opzioni

Colonne esterne disponibili
Consente di visualizzare l'elenco delle colonne esterne disponibili nell'origine dei dati. Non è possibile utilizzare questa tabella per l'aggiunta o l'eliminazione di colonne.

Colonna esterna
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.

Colonna di output
Consente di specificare un nome univoco per ogni colonna di output. Per impostazione predefinita viene suggerito il nome della colonna esterna (di origine) selezionata. È comunque possibile scegliere qualsiasi nome descrittivo univoco. Il nome specificato verrà visualizzato in Progettazione SSIS.

Editor origine ADO NET (pagina Output errori)

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.

Per ulteriori informazioni sull'origine ADO NET, vedere ADO NET Source.

Per aprire la pagina Output errori

  1. In SQL Server Data Tools (SSDT) aprire il pacchetto di Integration Services che include l'origine ADO.NET.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine ADO NET.

  3. In Editor origine ADO NET, fare clic su Output errori.

Opzioni

Input/Output
Consente di visualizzare il nome dell'origine dei dati.

Istogramma
Consente di visualizzare le colonne esterne (di origine) selezionate nella pagina Gestione connessione della finestra di dialogo Editor origine ADO NET .

Errore
Consente di specificare l'azione da eseguire in caso di errori, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.

Argomenti correlati: Gestione degli errori nei dati

Troncamento
Consente di specificare l'azione da eseguire in caso di troncamenti, ovvero ignorare l'errore, reindirizzare la riga o interrompere il componente.

Descrizione
Consente di visualizzare la descrizione dell'errore.

Imposta questo valore nelle celle selezionate
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.

Applica
Consente di applicare l'opzione di gestione degli errori alle celle selezionate.

Vedi anche

Destinazione DataReader
Destinazione ADO NET
Flusso di dati