Destinazione Oracle

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

Importante

Il Connettore Microsoft per Oracle è ora obsoleto. I dettagli fanno riferimento a all'annuncio.

La destinazione Oracle carica i dati in blocco in Oracle Database.

La destinazione usa Oracle Gestione connessioni per connettersi a un'origine dati. Per altre informazioni, vedere Gestione connessione Oracle.

Una destinazione Oracle include le mappature tra le colonne di input e le colonne dell'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, se alle colonne di destinazione non corrispondono colonne di input è possibile che vengano generati errori. 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, 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 caso di errore, l'errore verrà ignorato, causerà un errore oppure la riga verrà reindirizzata all'output di errore.

La destinazione Oracle ha un input normale e un output di errore.

Le colonne con tipi di dati non supportati vengono eliminate dalle colonne con un avviso prima del mapping. Per altre informazioni, vedere Supporto dei tipi di dati.

Opzioni di caricamento

Sono supportate due modalità di caricamento di accesso. La modalità può essere impostata nel Editor di destinazione Oracle (pagina Gestione connessioni). Le due modalità sono:

Gestione degli errori

La destinazione Oracle ha un output di errore. L'output di errore del componente include le seguenti colonne di output:

  • Codice errore: numero che rappresenta il tipo di errore dell'errore corrente. Il codice di errore può essere generato da:

    • Server Oracle. Vedere la descrizione dettagliata dell'errore nella documentazione di Oracle Database.
    • runtime di SSIS Per un elenco dei codici di errore SSIS, vedere la Guida di riferimento ai messaggi e ai codici di errore SSIS.
  • Colonna errore: numero della colonna di origine che causa gli errori di conversione.

  • Colonne dei dati che causano l'errore: i dati che causano l'errore.

I tipi di errori di output supportati durante il processo di caricamento sono: conversione dei dati, troncamento o violazione di vincoli e così via. Vedi Editor destinazione di Oracle (pagina di output degli errori).

La proprietà Numero massimo di errori (MaxErrors) imposta il numero massimo di errori che possono verificarsi. Quando viene raggiunto il numero massimo, l'esecuzione viene arrestata e restituisce gli errori. Inoltre, vengono inclusi nella tabella di destinazione solo i record di esecuzione prima del raggiungimento del numero massimo di errori. per informazioni dettagliate sulla configurazione, vedere Editor di destinazione Oracle (pagina Gestione connessioni).

Parallelismo

In modalità di caricamento batch non esiste alcuna restrizione per la configurazione dell'esecuzione parallela, ma le prestazioni potrebbero essere influenzate dal meccanismo standard di blocco dei record. L'entità della riduzione delle prestazioni dipende dall'organizzazione dei dati e delle tabelle.

Nel protocollo con percorso diretto (caricamento rapido) può essere configurata una sola destinazione Oracle per l'esecuzione su una stessa tabella, ma è possibile fare uso della modalità parallela.

Un percorso diretto parallelo consente il caricamento di più percorsi diretti, con cui è possibile configurare più destinazioni Oracle per l'esecuzione simultanea sulla stessa tabella. Poiché Oracle non blocca la tabella di destinazione in modalità esclusiva per l'uso nella sessione di caricamento rapido, ciò consente l'esecuzione di ulteriori componenti di destinazione di caricamento rapido per caricare la stessa tabella di destinazione in parallelo. Il percorso diretto parallelo è più restrittivo. Qualsiasi uso del parallelismo deve essere pianificato in anticipo.

Non esiste alcun motivo per usare una singola sessione parallela.

Per informazioni sulle restrizioni per l'uso di caricamenti con percorsi diretti paralleli, vedere la documentazione di Oracle.

Per altre informazioni, vedere Proprietà personalizzate della destinazione Oracle.

Risoluzione dei problemi relativi alla destinazione Oracle

È possibile registrare le chiamate ODBC eseguite dall'origine Oracle alle origini dati Oracle per risolvere i problemi relativi all'esportazione dei dati. Per registrare le chiamate ODBC eseguite dall'origine Oracle alle origini dati Oracle, attivare la traccia del gestore driver ODBC. Per altre informazioni, consultare la documentazione Microsoft sull'argomento come generare una traccia ODBC con l'Amministratore origine dati ODBC.

Proprietà personalizzate della destinazione Oracle

La tabella seguente descrive le proprietà personalizzate della destinazione Oracle. Tutte le proprietà sono leggibili e scrivibili.

Nome della proprietà Tipo di dati Descrizione Modalità di caricamento
BatchSize Intero La dimensione del batch per il caricamento in blocco. Questo è il numero di righe caricate in batch. Usato solo in modalità batch.
DefaultCodePage Intero Tabella codici da usare quando l'origine dati non dispone di informazioni sulla tabella codici.
Nota: questa proprietà è impostata solo da Editor avanzato.
Usato per entrambe le modalità.
FastLoad Booleano Indica se viene usato il caricamento rapido. Il valore predefinito è false. Questo può anche essere impostato nell'Editor della destinazione Oracle (pagina Gestione connessioni). Usato per entrambe le modalità.
MaxErrors Intero Numero di errori che possono verificarsi prima dell'arresto del flusso di dati. Il valore predefinito è 0, ovvero nessun limite per il numero di errori.
Se è selezionato Reindirizza flusso nella pagina Gestione degli errori. Prima del raggiungimento del limite per il numero di errori, vengono restituiti tutti gli errori nell'output degli errori. Per altre informazioni, vedere Gestione degli errori.
Usato solo in modalità di caricamento rapido.
NoLogging Booleano Indica se la registrazione del database è disabilitata. Il valore predefinito è False, ovvero la registrazione è abilitata. Usato per entrambe le modalità.
Parallela Booleano Indica se il caricamento parallelo è consentito. True indica che è consentita l'esecuzione di altre sessioni di caricamento sulla stessa tabella di destinazione.
Per altre informazioni, vedere Parallelismo.
Usato solo in modalità di caricamento rapido.
TableName Stringa Nome della tabella con i dati in uso. Usato per entrambe le modalità.
TableSubName Stringa Il sotto-nome o la sottopartizione. Questo valore è facoltativo.
Nota: questa proprietà può essere impostata solo in Editor avanzato.
Usato solo in modalità di caricamento rapido.
Dimensione della transazione Intero Numero di inserimenti che possono essere eseguiti in una singola transazione. Il valore predefinito è BatchSize. Usato solo in modalità batch.
TransferBufferSize Intero Dimensioni del buffer di trasferimento. Il valore predefinito è 64 KB. Usato solo in modalità di caricamento rapido.

Configurazione della destinazione Oracle

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

L'editor di destinazione Oracle è mostrato nell'immagine seguente. Contiene la Pagina di Gestione connessioni, la Pagina Mappature e la Pagina Output errori.

Per altre informazioni, vedere una delle sezioni seguenti:

Destinazione Oracle

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 di Integration Services fare clic con il pulsante destro del mouse sulla destinazione Oracle e scegliere Visualizza editor avanzato.

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

Editor di destinazione Oracle (pagina Gestione connessioni)

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

Per aprire la pagina Gestione connessioni dell'Editor della destinazione Oracle

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

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

  • Nell'Editor destinazione Oracle, fare clic su Gestione connessioni.

Opzioni

Gestione connessione

Consente di selezionare una gestione connessione esistente nell'elenco o di creare una nuova gestione connessione Oracle facendo clic su Nuovo.

New

Fai clic su Nuovo. Verrà visualizzata la finestra di dialogo Configura gestione connessione Oracle, in cui è possibile creare una nuova gestione connessione.

Modalità di accesso ai dati

Consente di selezionare il metodo per la selezione dei dati dall'origine. Le opzioni disponibili vengono visualizzate nella tabella seguente.

Opzione Descrizione
Nome della tabella Configurare la destinazione Oracle per il funzionamento in modalità batch. Opzioni:

Nome tabella o vista: selezionare una tabella o vista disponibile del database dall'elenco.

Dimensione della transazione: inserire il numero di inserimenti che possono essere eseguiti in una singola transazione. Il valore predefinito è BatchSize.

Dimensione del batch: Inserisci la dimensione (numero di righe caricate) del batch per il caricamento in blocco.
Nome tabella – Caricamento veloce Configurare la destinazione Oracle per il funzionamento in modalità di caricamento rapido (percorso diretto).

Sono disponibili le opzioni seguenti:

Nome tabella o vista: selezionare una tabella o vista disponibile del database dall'elenco.

Caricamento parallelo: indica se il caricamento parallelo è abilitato. Per altre informazioni, vedere Parallelismo.

Nessuna registrazione: questa casella di controllo consente di disabilitare la registrazione del database. Questo logging del database Oracle viene utilizzato a scopo di recupero e non è correlato al tracciamento.

Numero massimo di errori: numero massimo di errori che possono verificarsi prima dell'arresto del flusso di dati. Il valore predefinito è 0, il che significa che non esiste alcun limite numerico.

Tutti gli errori che possono verificarsi vengono restituiti nell'output di errore.

Dimensione buffer di trasferimento (KB): inserire le dimensioni del buffer di trasferimento. Il valore predefinito è 64 KB.

Visualizza dati esistenti

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

Editor di destinazione Oracle (pagina Mappature)

Usare la pagina Mappings della finestra di dialogo Editor di destinazione Oracle per associare le colonne di input alle colonne di destinazione.

Per aprire la pagina delle mappature dell'Editor destinazione Oracle

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

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

  • Nell'Editor di destinazione Oracle, fare clic su Mapping.

Opzioni

Colonne di input disponibili

Elenco delle colonne di input disponibili. Trascina una colonna di origine su una colonna di destinazione disponibile per mappare le colonne.

Colonne di destinazione disponibili

Elenco delle colonne di destinazione disponibili. Trascina e rilascia una colonna di destinazione su una colonna di input disponibile per mappare 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

Visualizza tutte le colonne di destinazione disponibili, sia mappate che non mappate.

Nota

Le colonne con tipi di dati non supportati vengono eliminate dal mapping con un avviso.

Editor di destinazione Oracle (pagina di output degli errori)

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

Per aprire la pagina Output degli errori dell'Editor destinazione Oracle

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

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

  • Nell'Editor destinazione Oracle, fare clic su Output degli errori.

Opzioni

Comportamento in caso di errore

Consente di selezionare il modo in cui l'origine Oracle deve gestire gli errori in un flusso: ignorare l'errore, reindirizzare la riga o interrompere il componente. Sezione correlata: Gestione degli errori nei dati

Troncamento

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