Destinazione ODBCODBC Destination

Tramite la destinazione ODBC viene eseguito il caricamento bulk di dati in tabelle di database supportate da ODBC.The ODBC destination bulk loads data into ODBC-supported database tables. La destinazione ODBC utilizza una gestione connessione ODBC per la connessione all'origine dati.The ODBC destination uses an ODBC connection manager to connect to the data source.

Una destinazione ODBC include i mapping tra le colonne di input e le colonne presenti nell'origine dati di destinazione.An ODBC destination includes mappings between input columns and columns in the destination data source. 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.You do not have to map input columns to all destination columns, but depending on the properties of the destination columns, errors may occur if no input columns are mapped to the destination columns. Se, ad esempio, una colonna di destinazione non ammette valori Null, sarà necessario eseguire il mapping di una colonna di input a tale colonna.For example, if a destination column does not allow null values, an input column must be mapped to that column. È 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.In addition, columns of different types can be mapped, however if the input data is not compatible for the destination column type, an error occurs at runtime. 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.Depending on the error behavior setting, the error will be ignored, cause a failure, or the row is sent to the error output.

La destinazione ODBC include un output regolare e un output degli errori.The ODBC destination has one regular output and one error output.

Opzioni di caricamento Load Options

La destinazione ODBC può utilizzare uno tra due moduli di caricamento di accesso.The ODBC destination can use one of two access load modules. Impostare la modalità in Editor origine ODBC (pagina Gestione connessione #41;.You set the mode in the ODBC Source Editor (Connection Manager Page). Le due modalità sono:The two modes are:

  • Batch: in questa modalità il componente tenta di usare il metodo di inserimento più efficiente in base alle funzionalità del provider ODBC rilevate.Batch: In this mode the ODBC destination attempts to use the most efficient insertion method based on the perceived ODBC provider capabilities. 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 .For most modern ODBC providers, this would mean preparing an INSERT statement with parameters and then using a row-wise array parameter binding (where the array size is controlled by the BatchSize property). Se si seleziona Batch e il provider non supporta questo metodo, la destinazione ODBC passa automaticamente alla modalità Riga per riga .If you select Batch and the provider does not support this method, the ODBC destination automatically switches to the Row-by-row mode.

  • 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.Row-by-row: In this mode, the ODBC destination prepares an INSERT statement with parameters and uses SQL Execute to insert rows one at a time.

Gestione degli erroriError Handling

La destinazione ODBC include un output degli errori.The ODBC destination has an error output. L'output degli errori del componente include le colonne di output seguenti:The component error output includes the following output columns:

  • Error Code: numero che corrisponde all'errore corrente.Error Code: The number that corresponds to the current error. Per un elenco degli errori, vedere la documentazione per il database di origine.See the documentation for your source database for a list of errors. Per un elenco dei codici di errore SSIS, vedere la Guida di riferimento ai messaggi e ai codici di errore SSIS.For a list of SSIS error codes, see the SSIS Error Code and Message Reference.

  • Error Column: colonna di origine che provoca l'errore (per gli errori di conversione).Error Column: The source column causing the error (for conversion errors).

  • Colonne dei dati di output standard.The standard output data columns.

    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.Depending on the error behavior setting, the ODBC destination supports returning errors (data conversion, truncation) that occur during the extraction process in the error output. Per altre informazioni, vedere Editor origine ODBC (pagina Output degli errori).For more information, see ODBC Source Editor (Error Output Page).

ParallelismoParallelism

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.There is no limitation on the number of ODBC destination components that can run in parallel against the same table or different tables, on the same machine or on different machines (other than normal global session limits).

Alcune limitazioni del provider ODBC utilizzato possono tuttavia ridurre il numero di connessioni simultanee tramite il provider.However, limitations of the ODBC provider being used may restrict the number of concurrent connections through the provider. Queste limitazioni riducono il numero di possibili istanze parallele supportate per la destinazione ODBC.These limitations limit the number of supported parallel instances possible for the ODBC destination. 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.The SSIS developer must be aware of the limitations of any ODBC provider being used and take them into consideration when building SSIS packages.

È necessario tenere anche presente che il caricamento simultaneo nella stessa tabella può ridurre le prestazioni a causa del blocco del record standard.You must also be aware that concurrently loading into the same table may reduce performance because of standard record locking. Ciò dipende dai dati caricati e dall'organizzazione della tabella.This depends on the data being loaded and on the table organization.

Risoluzione dei problemi relativi alla destinazione ODBCTroubleshooting the ODBC Destination

È possibile registrare le chiamate eseguite dall'origine ODBC a provider di dati esterni.You can log the calls that the ODBC source makes to external data providers. 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.You can use this logging capability to troubleshoot the saving of data to external data sources that the ODBC destination performs. Per registrare le chiamate eseguite dalla destinazione ODBC a provider di dati esterni, abilitare la traccia di Gestione driver ODBC.To log the calls that the ODBC destination makes to external data providers, enable the ODBC driver manager trace. Per altre informazioni, vedere la documentazione di Microsoft Come generare un'analisi ODBC con l'amministratore origine dati ODBC.For more information, see the Microsoft documentation on How To Generate an ODBC Trace with ODBC the Data Source Administrator.

Configurazione della destinazione ODBCConfiguring the ODBC Destination

È possibile configurare la destinazione ODBC a livello di codice o tramite Progettazione SSIS.You can configure the ODBC destination programatically or through the SSIS Designer

Per ulteriori informazioni, vedere uno degli argomenti seguenti:For more information, see one of the following topics:

Argomenti della sezioneIn This Section

Editor destinazione ODBC (pagina Gestione connessione)ODBC Destination Editor (Connection Manager Page)

Utilizzare la pagina Gestione connessione della finestra di dialogo ODBC Destination Editor per selezionare la gestione connessione ODBC per la destinazione.Use the Connection Manager page of the ODBC Destination Editor dialog box to select the ODBC connection manager for the destination. Tramite questa pagina è inoltre possibile selezionare una tabella o una vista del databaseThis page also lets you select a table or view from the database

Per aprire ODBC Destination Editor (pagina Gestione connessione)To open the ODBC Destination Editor Connection Manager Page

Elenco attivitàTask List

  • In SQL Server Data ToolsSQL Server Data Tools, aprire il pacchetto SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) con la destinazione ODBC.In SQL Server Data ToolsSQL Server Data Tools, open the SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) package that has the ODBC destination.

  • Nella scheda Flusso di dati fare doppio clic sulla destinazione ODBC.On the Data Flow tab, double-click the ODBC destination.

  • In ODBC Destination Editor, fare clic su Gestione connessione.In the ODBC Destination Editor, click Connection Manager.

OpzioniOptions

Gestione connessioneConnection manager

Consente di selezionare una gestione connessione ODBC esistente nell'elenco o di creare una nuova connessione facendo clic su Nuova.Select an existing ODBC connection manager from the list, or click New to create a new connection. La connessione può essere a qualsiasi database supportato da ODBC.The connection can be to any ODBC-supported database.

NuovaNew

Fare clic su Nuovo.Click New. Viene visualizzata la finestra di dialogo Configura gestione connessione ODBC in cui è possibile creare una nuova gestione connessione.The Configure ODBC Connection Manager Editor dialog box opens where you can create a new connection manager.

Modalità di accesso ai datiData Access Mode

Consente di selezionare il metodo di caricamento dei dati nella destinazione.Select the method for loading data to the destination. Le opzioni disponibili vengono visualizzate nella tabella seguente.The options are shown in the following table:

OpzioneOption DescriptionDescription
Nome tabella - BatchTable Name - Batch Selezionare questa opzione per configurare la destinazione ODBC per l'utilizzo della modalità batch.Select this option to configure the ODBC destination to work in batch mode. Se si seleziona questa opzione, sono disponibili le opzioni seguenti.When you select this option the following options are available:
Nome tabella o vista: selezionare una tabella o vista disponibile nell'elenco.Name of the table or the view: Select an available table or view from the list.

Questo elenco contiene solo le prime 1000 tabelle.This list contains the first 1000 tables only. Se il database contiene più di 1000 tabelle, è possibile digitare l'inizio di un nome di tabella o usare il carattere jolly (*) per immettere qualsiasi parte del nome e visualizzare la tabella o le tabelle che si vuole usare.If your database contains more than 1000 tables, you can type the beginning of a table name or use the (*) wild card to enter any part of the name to display the table or tables you want to use.

Dimensioni batch: digitare la dimensione del batch per il caricamento bulk.Batch size: Type the size of the batch for bulk loading. Si tratta del numero di righe caricato come un batchThis is the number of rows loaded as a batch
Nome tabella - Riga per rigaTable Name - Row by Row Selezionare questa opzione per configurare la destinazione ODBC per l'inserimento di una riga per volta nella tabella di destinazione.Select this option to configure the ODBC destination to insert each of the rows into the destination table one at a time. Se si seleziona questa opzione, è disponibile l'opzione seguente.When you select this option the following option is available:
Nome tabella o vista: selezionare una tabella o vista disponibile del database dall'elenco.Name of the table or the view: Select an available table or view from the database from the list.

Questo elenco contiene solo le prime 1000 tabelle.This list contains the first 1000 tables only. 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.If your database contains more than 1000 tables, you can type the beginning of a table name or use the () wild card to enter any part of the name to display the table or tables you want to use.

AnteprimaPreview

Fare clic su Anteprima per visualizzare fino a 200 dati per la tabella selezionata.Click Preview to view up to 200 rows of data for the table that you selected.

ODBC Destination Editor (pagina Mapping)ODBC Destination Editor (Mappings Page)

Utilizzare la pagina Mapping della finestra di dialogo ODBC Destination Editor per eseguire il mapping tra colonne di input e colonne di destinazione.Use the Mappings page of the ODBC Destination Editor dialog box to map input columns to destination columns.

OpzioniOptions

Colonne di input disponibiliAvailable Input Columns

Elenco delle colonne di input disponibili.The list of available input columns. Trascinare un colonna di input in una colonna di destinazione disponibile per eseguire il mapping tra le colonne.Drag-and-drop an input column to an available destination column to map the columns.

Colonne di destinazione disponibiliAvailable Destination Columns

Elenco delle colonne di destinazione disponibili.The list of available destination columns. Trascinare un colonna di destinazione in una colonna di input disponibile per eseguire il mapping tra le colonne.Drag-and-drop a destination column to an available input column to map the columns.

Colonna di inputInput Column

Consente di visualizzare le colonne di input selezionate dall'utente.View the input columns that you selected. È possibile rimuovere i mapping selezionando <ignorare > per escludere colonne dall'output.You can remove mappings by selecting <ignore> to exclude columns from the output.

Colonna di destinazioneDestination Column

Consente di visualizzare tutte le colonne di destinazione disponibili, con o senza mapping eseguito.View all available destination columns, both mapped and unmapped.

Editor destinazione ODBC (pagina Output errori)ODBC Destination Editor (Error Output Page)

Utilizzare la pagina Output degli errori della finestra di dialogo ODBC Destination Editor per selezionare le opzioni di gestione degli errori.Use the Error Output page of the ODBC Destination Editor dialog box to select error handling options.

Per aprire ODBC Destination Editor (pagina Output degli errori)To open the ODBC Destination Editor Error Output Page

Elenco attivitàTask List

  • In SQL Server Data ToolsSQL Server Data Tools, aprire il pacchetto SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) con la destinazione ODBC.In SQL Server Data ToolsSQL Server Data Tools, open the SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) package that has the ODBC destination.

  • Nella scheda Flusso di dati fare doppio clic sulla destinazione ODBC.On the Data Flow tab, double-click the ODBC destination.

  • In ODBC Destination Editor, fare clic su Output degli errori.In the ODBC Destination 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

Non usato.Not used.

ErroreError

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.Select how the ODBC destination should handle errors in a flow: ignore the failure, redirect the row, or fail the component.

TroncamentoTruncation

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.Select how the ODBC destination should handle truncation in a flow: ignore the failure, redirect the row, or fail the component.

DescriptionDescription

Consente di visualizzare una descrizione dell'errore.View a description of the error.

Imposta questo valore nelle celle selezionateSet this value to selected cells

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.Select how the ODBC destination handles all selected cells when an error or truncation occurs: ignore the failure, redirect the row, or fail the component.

ApplicaApply

Consente di applicare le opzioni di gestione degli errori alle celle selezionate.Apply the error handling options to the selected cells.

Opzioni di gestione degli erroriError Handling Options

Utilizzare le opzioni seguenti per configurare il modo in cui la destinazione ODBC gestisce errori e troncamenti.You use the following options to configure how the ODBC destination handles errors and truncations.

Interrompi componenteFail Component

Quando si verifica un errore o un troncamento l'attività Flusso di dati viene interrotta.The Data Flow task fails when an error or a truncation occurs. Questo è il comportamento predefinito.This is the default behavior.

Ignora erroreIgnore Failure

L'errore o il troncamento vengono ignorati.The error or the truncation is ignored.

Reindirizza flussoRedirect Flow

La riga che determina l'errore o il troncamento viene inviata all'output degli errori della destinazione ODBC.The row that is causing the error or the truncation is directed to the error output of the ODBC destination. Per ulteriori informazioni, vedere Destinazione ODBC.For more information, see ODBC Destination.