Condividi tramite


Destinazione ODBC

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

Tramite la destinazione ODBC viene eseguito il caricamento bulk di dati in tabelle di database supportate da ODBC. La destinazione ODBC utilizza una gestione connessione ODBC per la connessione all'origine dati.

Una destinazione ODBC include i mapping tra le colonne di input e le colonne presenti nell'origine dati di destinazione. Non è necessario eseguire il mapping delle colonne di input a tutte le colonne di destinazione ma, a seconda delle proprietà delle colonne di destinazione, possono verificarsi errori se non viene eseguito il mapping di alcuna colonna di input alle colonne di destinazione. Se, ad esempio, una colonna di destinazione non ammette valori Null, sarà necessario eseguire il mapping di una colonna di input a tale colonna. È inoltre possibile eseguire il mapping di colonne di tipi diversi, ma se i dati di input non sono compatibili per il tipo di colonna di destinazione, si verifica un errore in fase di esecuzione. A seconda dell'impostazione del comportamento in seguito all'errore, l'errore viene ignorato, provoca un problema o la riga viene inviata all'output degli errori.

La destinazione ODBC include un output regolare e un output degli errori.

Opzioni di caricamento

La destinazione ODBC può utilizzare uno tra due moduli di caricamento di accesso. Impostare la modalità in Editor origine ODBC (pagina Gestione connessione). Le due modalità sono:

  • Batch: in questa modalità il componente tenta di usare il metodo di inserimento più efficiente in base alle funzionalità del provider ODBC rilevate. Per la maggior parte degli attuali provider ODBC, ciò significa preparare un'istruzione INSERT con parametri e quindi usare un'associazione di parametri di matrice a livello di riga, in cui le dimensioni della matrice sono determinate dalla proprietà BatchSize . Se si seleziona Batch e il provider non supporta questo metodo, la destinazione ODBC passa automaticamente alla modalità Riga per riga .

  • Riga per riga: in questa modalità, tramite la destinazione ODBC viene preparata un'istruzione INSERT con parametri e viene usato SQL Execute per inserire le righe una per volta.

Gestione errori

La destinazione ODBC include un output degli errori. L'output degli errori del componente include le colonne di output seguenti:

  • Error Code: numero che corrisponde all'errore corrente. Per un elenco degli errori, vedere la documentazione per il database di origine. Per un elenco dei codici di errore SSIS, vedere la Guida di riferimento ai messaggi e ai codici di errore SSIS.

  • Error Column(Colonna errore): colonna di origine che provoca l'errore (per gli errori di conversione).

  • Colonne dei dati di output standard.

A seconda dell'impostazione del comportamento in seguito all'errore, la destinazione ODBC supporta la restituzione degli errori (conversione dei dati, troncamento) che si verificano durante il processo di estrazione nell'output degli errori. Per altre informazioni, vedere Editor origine ODBC (pagina Output degli errori).

Parallelism

Non sussiste alcuna limitazione al numero di componenti della destinazione ODBC che possono essere eseguiti in parallelo rispetto alla stessa tabella o a tabelle diverse, nello stesso computer o in computer diversi, ad eccezione dei normali limiti di sessione globali.

Alcune limitazioni del provider ODBC utilizzato possono tuttavia ridurre il numero di connessioni simultanee tramite il provider. Queste limitazioni riducono il numero di possibili istanze parallele supportate per la destinazione ODBC. Lo sviluppatore di SSIS deve essere a conoscenza delle limitazioni di qualsiasi provider ODBC utilizzato e tenerne conto in caso di compilazione di pacchetti SSIS.

È necessario tenere anche presente che il caricamento simultaneo nella stessa tabella può ridurre le prestazioni a causa del blocco del record standard. Ciò dipende dai dati caricati e dall'organizzazione della tabella.

Risoluzione dei problemi relativi alla destinazione ODBC

È possibile registrare le chiamate eseguite dall'origine ODBC a provider di dati esterni. Questa nuova funzionalità di registrazione può essere utilizzata per risolvere i problemi relativi al salvataggio di dati in origini dati esterne eseguito dalla destinazione ODBC. Per registrare le chiamate eseguite dalla destinazione ODBC a provider di dati esterni, abilitare la traccia di Gestione driver ODBC. Per altre informazioni, vedere la documentazione di Microsoft Come generare un'analisi ODBC con l'amministratore origine dati ODBC.

Configurazione della destinazione ODBC

È possibile configurare la destinazione ODBC a livello di codice o tramite Progettazione SSIS.

Per ulteriori informazioni, vedere uno degli argomenti seguenti:

La finestra di dialogo Editor avanzato contiene le proprietà che è possibile impostare a livello di codice.

Per aprire la finestra di dialogo Editor avanzato :

  • Nella schermata Flusso di dati del progetto dei servizi di integrazione SQL Server 2019 (SSIS) fare clic con il pulsante destro del mouse sulla destinazione ODBC e scegliere Visualizza editor avanzato.

Per altre informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor avanzato, vedere Proprietà personalizzate della destinazione ODBC.

In questa sezione

Editor destinazione ODBC (pagina Gestione connessione)

Utilizzare la pagina Gestione connessione della finestra di dialogo ODBC Destination Editor per selezionare la gestione connessione ODBC per la destinazione. Tramite questa pagina è inoltre possibile selezionare una tabella o una vista del database

Per aprire ODBC Destination Editor (pagina Gestione connessione)

Elenco attività

  • In SQL Server Data Tools aprire il pacchetto di SQL Server 2019 Integration Services (SSIS) con la destinazione ODBC.

  • Nella scheda Flusso di dati fare doppio clic sulla destinazione ODBC.

  • In ODBC Destination Editor, fare clic su Gestione connessione.

Opzioni

Connection manager

Consente di selezionare una gestione connessione ODBC esistente nell'elenco o di creare una nuova connessione facendo clic su Nuova. La connessione può essere a qualsiasi database supportato da ODBC.

Nuovo

Fai clic su Nuovo. Viene visualizzata la finestra di dialogo Configura gestione connessione ODBC in cui è possibile creare una nuova gestione connessione.

Modalità di accesso ai dati

Consente di selezionare il metodo di caricamento dei dati nella destinazione. Le opzioni disponibili vengono visualizzate nella tabella seguente.

Opzione Descrizione
Nome tabella - Batch Selezionare questa opzione per configurare la destinazione ODBC per l'utilizzo della modalità batch. Se si seleziona questa opzione, sono disponibili le opzioni seguenti.
Nome tabella o vista: selezionare una tabella o vista disponibile nell'elenco.

Questo elenco contiene solo le prime 1000 tabelle. Se il database contiene più di 1000 tabelle, è possibile digitare l'inizio di un nome di tabella o utilizzare il carattere jolly (*) per immettere qualsiasi parte del nome e visualizzare la tabella o le tabelle che si desidera utilizzare.

Dimensioni batch: digitare la dimensione del batch per il caricamento bulk. Si tratta del numero di righe caricato come un batch
Nome tabella - Riga per riga Selezionare questa opzione per configurare la destinazione ODBC per l'inserimento di una riga per volta nella tabella di destinazione. Se si seleziona questa opzione, è disponibile l'opzione seguente.
Nome tabella o vista: selezionare una tabella o vista disponibile del database dall'elenco.

Questo elenco contiene solo le prime 1000 tabelle. Se il database contiene più di 1000 tabelle, è possibile digitare l'inizio di un nome di tabella o utilizzare il carattere jolly (*) per immettere qualsiasi parte del nome e visualizzare la tabella o le tabelle che si desidera utilizzare.

Anteprima

Fare clic su Anteprima per visualizzare fino a 200 dati per la tabella selezionata.

Editor destinazione ODBC (pagina Mapping)

Utilizzare la pagina Mapping della finestra di dialogo ODBC Destination Editor per eseguire il mapping tra colonne di input e colonne di destinazione.

Opzioni

Colonne di input disponibili

Elenco delle colonne di input disponibili. Trascinare un colonna di input in una colonna di destinazione disponibile per eseguire il mapping tra le colonne.

Colonne di destinazione disponibili

Elenco delle colonne di destinazione disponibili. Trascinare un colonna di destinazione in una colonna di input disponibile per eseguire il mapping tra le colonne.

Colonna di input

Consente di visualizzare le colonne di input selezionate dall'utente. È possibile rimuovere i mapping selezionando < ignora > per escludere colonne dall'output.

Colonna di destinazione

Consente di visualizzare tutte le colonne di destinazione disponibili, con o senza mapping eseguito.

Editor destinazione ODBC (pagina Output errori)

Utilizzare la pagina Output degli errori della finestra di dialogo ODBC Destination Editor per selezionare le opzioni di gestione degli errori.

Per aprire ODBC Destination Editor (pagina Output degli errori)

Elenco attività

  • In SQL Server Data Tools aprire il pacchetto di SQL Server 2019 Integration Services (SSIS) con la destinazione ODBC.

  • Nella scheda Flusso di dati fare doppio clic sulla destinazione ODBC.

  • In ODBC Destination Editor, fare clic su Output degli errori.

Opzioni

Input/Output

Consente di visualizzare il nome dell'origine dei dati.

Colonna

Non utilizzato.

Error

Consente di selezionare il modo in cui la destinazione ODBC deve gestire gli errori in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente.

Troncamento

Consente di selezionare il modo in cui la destinazione ODBC deve gestire il troncamento in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente.

Descrizione

Consente di visualizzare una descrizione dell'errore.

Imposta questo valore nelle celle selezionate

Consente di selezionare il modo in cui la destinazione ODBC gestisce tutte le celle selezionate in caso di errore o troncamento: ignorare l'errore, reindirizzare la riga o interrompere il componente.

Applica

Consente di applicare le opzioni di gestione degli errori alle celle selezionate.

Opzioni di gestione degli errori

Utilizzare le opzioni seguenti per configurare il modo in cui la destinazione ODBC gestisce errori e troncamenti.

Interrompi componente

Quando si verifica un errore o un troncamento l'attività Flusso di dati viene interrotta. Questo è il comportamento predefinito.

Ignora errore

L'errore o il troncamento vengono ignorati.

Reindirizza flusso

La riga che determina l'errore o il troncamento viene inviata all'output degli errori della destinazione ODBC. Per ulteriori informazioni, vedere Destinazione ODBC.