Origine ODBCODBC Source

Tramite l'origine ODBC vengono estratti dati da un database supportato da ODBC mediante una tabella di database, una vista o un'istruzione SQL.The ODBC source extracts data from ODBC-supported database by using a database table, a view, or an SQL statement.

Per l'origine ODBC sono disponibili le modalità di accesso ai dati seguenti per l'estrazione dei dati:The ODBC source has the following data access modes for extracting data:

  • Vista o tabella.A table or view.

  • Risultato di un'istruzione SQL.The results of an SQL statement.

    L'origine utilizza una gestione connessione ODBC che specifica il provider da utilizzare.The source uses an ODBC connection manager, which specifies the provider to use.

    Un'origine ODBC include le colonne di output dei dati di origine.An ODBC source includes the source data output columns. Durante il mapping delle colonne di output nella destinazione ODBC alle colonne di destinazione, possono verificarsi errori se non viene eseguito il mapping di alcuna colonna di output alle colonne di destinazione.When output columns are mapped in the ODBC destination to the destination columns, errors may occur if no output columns are mapped to the destination columns. È possibile eseguire il mapping di colonne di tipi diversi, ma se i dati di output non sono compatibili per la destinazione, si verifica un errore in fase di esecuzione.Columns of different types can be mapped, however if the output data is not compatible for the destination then an error occurs at runtime. A seconda del comportamento in seguito all'errore, l'impostazione dell'errore verrà ignorata, provocherà un problema o la riga verrà 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.

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

Gestione degli erroriError Handling

L'origine ODBC include un output degli errori.The ODBC source 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 supportato da ODBC in uso.See the documentation for the ODBC-supported database you are using 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, l'origine 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 source supports returning errors (data conversion, truncation) that occur during the extraction process in the error output. Per altre informazioni, vedere Editor destinazione ODBC (pagina Gestione connessione).For more information, see ODBC Destination Editor (Connection Manager Page).

Supporto dei tipi di datiData Type Support

Per informazioni sui tipi di dati supportati dall'origine ODBC, vedere Connettore per ODBC (Open Database Connectivity) di Attunity.For information about the data types supported by the ODBC source, see Connector for Open Database Connectivity (ODBC) by Attunity.

Opzioni di estrazioneExtract Options

L'origine ODBC usa la modalità Batch o Row-by-Row .The ODBC source operates in either Batch or Row-by-Row mode. La modalità utilizzata è determinata dalla proprietà FetchMethod .The mode used is determined by the FetchMethod property. Nell'elenco seguente vengono descritte le diverse modalità.The following list describes the modes.

  • Batch: il componente tenta di usare il metodo di recupero più efficiente in base alle funzionalità del provider ODBC rilevate.Batch: The component attempts to use the most efficient fetch method based on the perceived ODBC provider capabilities. Per la maggior parte degli attuali provider ODBC, tale metodo è SQLFetchScroll con associazione di matrici (in cui le dimensioni delle matrici sono determinate dalla proprietà BatchSize ).For most modern ODBC providers, this is SQLFetchScroll with array binding (where the array size is determined by the BatchSize property). Se si seleziona Batch e il provider non supporta questo metodo, la destinazione ODBC passa automaticamente alla modalità Row-by-row .If you select Batch and the provider does not support this method, the ODBC destination automatically switches to the Row-by-row mode.

  • Row-by Row: il componente usa SQLFetch per recuperare le righe una per volta.Row-by Row: The component uses SQLFetch to retrieve the rows one at a time.

    Per altre informazioni sulla proprietà FetchMethod , vedere Proprietà personalizzate dell'origine ODBC.For more information about the FetchMethod property, see ODBC Source Custom Properties.

ParallelismoParallelism

Non sussiste alcuna limitazione al numero di componenti dell'origine 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 source 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 l'origine ODBC.These limitations limit the number of supported parallel instances possible for the ODBC source. 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.

Risoluzione dei problemi relativi all'origine ODBCTroubleshooting the ODBC Source

È 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 funzionalità di registrazione può essere utilizzata per risolvere i problemi relativi al caricamento di dati da origini dati esterne eseguito dall'origine ODBC.You can use this logging capability to troubleshoot the loading of data from external data sources that the ODBC source performs. Per registrare le chiamate eseguite dall'origine ODBC a provider di dati esterni, abilitare la traccia di Gestione driver ODBC.To log the calls that the ODBC source makes to external data providers, enable the ODBC driver manager trace. Per altre informazioni, vedere la documentazione di Microsoft su come generare una traccia ODBC con l'amministratore dell'origine dati ODBC.For more information, see the Microsoft documentation on How To Generate an ODBC Trace with ODBC the Data Source Administrator.

Configurazione dell'origine ODBCConfiguring the ODBC Source

È possibile configurare l'origine ODBC a livello di codice o tramite Progettazione SSIS.You can configure the ODBC source programmatically or through the SSIS Designer.

La finestra di dialogo Editor avanzato contiene le proprietà che è possibile impostare a livello di codice.The Advanced Editor dialog box contains the properties that can be set programmatically.

Per aprire la finestra di dialogo Editor avanzato :To open the Advanced Editor dialog box:

  • Nella schermata Flusso di dati del progetto di SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) fare clic con il pulsante destro del mouse sull'origine ODBC e scegliere Visualizza editor avanzato.In the Data Flow screen of your SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) project, right click the ODBC source and select Show Advanced Editor.

    Per altre informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor avanzato, vedere Proprietà personalizzate dell'origine ODBC.For more information about the properties that you can set in the Advanced Editor dialog box, see ODBC Source Custom Properties.

Contenuto della sezioneIn This Section

Editor origine ODBC (pagina Gestione connessione)ODBC Source Editor (Connection Manager Page)

Utilizzare la pagina Gestione connessione della finestra di dialogo ODBC Source Editor per selezionare la gestione connessione ODBC per l'origine.Use the Connection Manager page of the ODBC Source Editor dialog box to select the ODBC 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.

Elenco attivitàTask List

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

  • In SQL Server Data ToolsSQL Server Data Tools, aprire il pacchetto SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) che contiene l'origine 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 source.

  • Nella scheda Flusso di dati fare doppio clic sull'origine ODBC.On the Data Flow tab, double-click the ODBC source.

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 ODBC.The Configure ODBC Connection Manager Editor dialog box opens where you can create a new ODBC connection manager.

Modalità di accesso ai datiData Access Mode

Consente di selezionare il metodo per la selezione dei dati dall'origine.Select the method for selecting data from the source. Le opzioni disponibili vengono visualizzate nella tabella seguente.The options are shown in the following table:

OpzioneOption DescriptionDescription
Nome tabellaTable Name Consente di recuperare dati da una tabella o da una vista nell'origine dati ODBC.Retrieve data from a table or view in the ODBC data source. Se si seleziona questa opzione, scegliere un valore nell'elenco per le opzioni seguenti:When you select this option, select a value from the list for the following:
Nome tabella o vista: selezionare una tabella o vista disponibile nell'elenco o digitare un'espressione regolare per identificare la tabella.Name of the table or the view: Select an available table or view from the list or type a regular expression to identify the table.
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.
Comando SQLSQL command Consente di recuperare dati dall'origine dati ODBC utilizzando una query SQL.Retrieve data from the ODBC data source by using an SQL query. Scrivere la query nella sintassi del database di origine che si sta utilizzando.You should write the query in the syntax of the source database you are working with. Se si seleziona questa opzione, immettere una query in uno dei modi seguenti:When you select this option, enter a query in one of the following ways:
Immettere il testo della query SQL nel campo Testo comando SQL .Enter the text of the SQL query in the SQL command text field.
Fare clic su Sfoglia per caricare la query SQL da un file di testo.Click Browse to load the SQL query from a text file.
Fare clic su Analizza query per verificare la sintassi del testo della query.Click Parse query to verify the syntax of the query text.

AnteprimaPreview

Fare clic su Anteprima per visualizzare un massimo di 200 righe dei dati estratti dalla tabella o dalla vista selezionata.Click Preview to view up to the first 200 rows of the data extracted from the table or view you selected.

Editor origine ODBC (pagina Colonne)ODBC Source Editor (Columns Page)

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

Elenco attivitàTask List

Per aprire ODBC Source Editor (pagina Colonne)To open the ODBC Source Editor Columns Page

  1. In SQL Server Data ToolsSQL Server Data Tools, aprire il pacchetto SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) che contiene l'origine 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 source.

  2. Nella scheda Flusso di dati fare doppio clic sull'origine ODBC.On the Data Flow tab, double-click the ODBC source.

  3. In ODBC Source Editor, fare clic su Colonne.In the ODBC Source Editor, click Columns.

OpzioniOptions

Colonne esterne disponibiliAvailable External Columns

Elenco delle colonne esterne disponibili nell'origine dei dati.A 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. Selezionare le colonne da utilizzare dall'origine.Select the columns to use from the source. Le colonne scelte vengono aggiunte all'elenco Colonna esterna nell'ordine in cui vengono selezionate.The selected columns are added to the External Column list in the order they are selected.

Selezionare la casella di controllo Seleziona tutto per selezionare tutte le colonne.Select the Select All check box to select all of the columns.

Colonna esternaExternal Column

Una vista delle colonne esterne (di origine) nell'ordine in cui vengono presentate durante la configurazione di componenti che utilizzano i dati dell'origine ODBC.A view of the external (source) columns in the order that you see them when configuring components that consume data from the ODBC source.

Colonna di outputOutput Column

Consente di immettere un nome univoco per ogni colonna di output.Enter 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 immesso viene visualizzato in Progettazione SSIS.The name entered is displayed in the SSIS Designer.

Editor origine ODBC (pagina Output degli errori)ODBC Source Editor (Error Output Page)

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

Elenco attivitàTask List

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

  • In SQL Server Data ToolsSQL Server Data Tools, aprire il pacchetto SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) che contiene l'origine 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 source.

  • Nella scheda Flusso di dati fare doppio clic sull'origine ODBC.On the Data Flow tab, double-click the ODBC source.

  • In ODBC Source Editor(Editor origine ODBC) fare clic su Output degli errori.In the ODBC 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

Non usato.Not used.

ErroreError

Consente di selezionare il modo in cui l'origine ODBC deve gestire gli errori in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente.Select how the ODBC source should handle errors in a flow: ignore the failure, redirect the row, or fail the component.

TroncamentoTruncation

Consente di selezionare il modo in cui l'origine ODBC deve gestire il troncamento in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente.Select how the ODBC source should handle truncation in a flow: ignore the failure, redirect the row, or fail the component.

DescriptionDescription

Non usato.Not used.

Imposta questo valore nelle celle selezionateSet this value to selected cells

Consente di selezionare il modo in cui l'origine 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 source 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 l'origine ODBC gestisce errori e troncamenti.You use the following options to configure how the ODBC source 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 dell'origine ODBC.The row that is causing the error or the truncation is directed to the error output of the ODBC source.