Documentazione dell'infrastruttura Oracle Cloud

Selezione della destinazione per un task di Data Loader

Selezionare l'asset dati, la connessione e lo schema da utilizzare come destinazione. Quindi configurare una nuova entità di destinazione o selezionare un'entità dati esistente in cui caricare i dati.

Selezione di un asset dati, una connessione e uno schema di destinazione

Per configurare l'entità dati di destinazione per un task di Data Loader, è innanzitutto necessario selezionare un asset dati, una connessione e uno schema.

È possibile parametrizzare le risorse dopo aver effettuato le selezioni.

  1. Nella pagina Crea task Data Loader, andare al passo Destinazione.
  2. Per creare e selezionare l'asset dati per questa destinazione, selezionare Crea accanto a Asset dati per creare un asset dati.
  3. Per selezionare un'entità dati di destinazione da un asset dati esistente, utilizzare innanzitutto i menu delle risorse per selezionare l'asset dati, la connessione e lo schema (o il bucket) solo nell'ordine visualizzato. Si noti quanto riportato di seguito.

    • Le risorse di asset dati disponibili per la selezione dipendono dal tipo di destinazione selezionato nel passo Informazioni di base. Fare clic su Visualizza tutto accanto a una risorsa se non si trova ciò che si desidera dal menu delle risorse.

    • Se applicabile per un asset dati (ad esempio, lo storage degli oggetti), selezionare un compartimento prima di selezionare un bucket (schema).

    • Per una connessione al database, è possibile fare clic su Aggiungi per creare e aggiungere la connessione.

  4. (Facoltativo) Dopo aver effettuato le selezioni per le risorse, è possibile assegnare un parametro all'asset dati, alla connessione e allo schema. Per una risorsa nella destinazione, effettuare una delle operazioni riportate di seguito.
    • Fare clic su Parametrizza accanto alla risorsa per assegnare un parametro a tale risorsa. Durante la parametrizzazione, Data Integration aggiunge un parametro del tipo appropriato e imposta il valore del parametro predefinito sul valore attualmente configurato per tale risorsa.
    • Se disponibile, fare clic su Riutilizza parametro <resource> origine per utilizzare lo stesso parametro aggiunto alla risorsa dello stesso tipo nell'origine. Per ulteriori informazioni, vedere Riutilizzo dei parametri per le risorse di origine o di destinazione.

    Tenere presente che quando il tipo di asset dati è Storage degli oggetti, è possibile parametrizzare il bucket (schema), ma non il compartimento che contiene il bucket.

  5. A seconda del tipo di asset dati della destinazione, potrebbero essere disponibili altre opzioni da selezionare.
    Tipo di asset dati Opzione

    Storage degli oggetti, HDFS

    In Impostazioni file, selezionare il tipo di file e il tipo di compressione e la codifica, se applicabile. I tipi di compressione disponibili per la selezione dipendono dal tipo di file.

    Per CSV, le altre impostazioni che è possibile configurare sono le seguenti:

    • Se tutti i file hanno la prima riga come riga di intestazione, selezionare Dati con intestazione.
    • Se i valori nelle righe di dati si estendono su più righe, selezionare Più righe.
    • Specificare il carattere orizzontale che esegue l'escape di altri caratteri trovati nei valori dei dati. Ad esempio: \
    • Selezionare il carattere Delimitatore che separa i campi dati. Ad esempio: COLON (:), COMMA (,), PIPE (|), SEMICOLON (;) o TAB (\t)
    • Specificare il carattere Preventivo che considera gli altri caratteri come caratteri letterali. Ad esempio: "
    • Se al termine di una riga di dati in tutti i file è incluso un delimitatore di colonne, selezionare Delimitatore finale.

    Quanto riportato di seguito è disponibile solo quando è stata selezionata l'opzione Usa entità dati esistente in Impostazioni caricamento entità dati di destinazione: per i file JSON, selezionare Usa schema personalizzato se si desidera incollare o caricare uno schema di esempio personalizzato utilizzato per derivare la forma entità.

    • Se si seleziona Carica, eliminare un file di schema personalizzato nella casella fornita oppure fare clic su Seleziona un file per selezionare il file di schema da caricare.

    • Se si seleziona Incolla schema, copiare il contenuto del file di testo dello schema e incollarlo nella casella fornita.

    Autonomous Data Warehouse, Autonomous Transaction Processing

    • Se l'asset dati selezionato è configurato con una posizione area intermedia predefinita, Data Integration utilizza automaticamente tale bucket di storage degli oggetti per l'area intermedia. Utilizzare la posizione area intermedia predefinita configurata per l'asset dati o specificare una posizione area intermedia diversa.

      Per utilizzare una posizione area intermedia diversa, in Posizione area intermedia deselezionare la casella di controllo Usa impostazioni posizione area intermedia predefinite. Utilizzare quindi i menu delle risorse per selezionare un asset dati, una connessione, un compartimento e quindi il bucket (schema) da utilizzare per il posizionamento nell'area intermedia.

    • Se l'asset dati selezionato non dispone di una posizione area intermedia predefinita configurata, utilizzare i menu delle risorse per selezionare un asset dati di storage degli oggetti, una connessione, un compartimento e quindi il bucket (schema) da utilizzare per l'area intermedia.
Dopo aver selezionato l'asset dati, la connessione, lo schema (o il bucket) e le opzioni di destinazione applicabili, configurare le impostazioni di caricamento della destinazione per una nuova entità dati o un'entità dati esistente.
Uso di nuove entità dati di destinazione

Data Integration può creare nuove entità dati di destinazione durante il caricamento dei dati dalle entità di origine.

Per il tipo di caricamento di entità dati singola, è possibile utilizzare un parametro per l'entità dati solo quando si sceglie l'opzione per immettere un nome di entità dati.

  1. Andare al passo Destinazione, scheda Entità dati.
  2. In Impostazioni caricamento entità dati di destinazione, selezionare Crea nuova entità dati.

    Per un nuovo target, la strategia di integrazione è sempre Inserisci.

  3. Solo per la destinazione dello storage degli oggetti: selezionare la casella di controllo Crea output come singolo file se si desidera utilizzare un singolo file di output. In caso contrario, vengono creati più file.

    Il singolo file di output viene sovrascritto ogni volta che viene eseguito il task. La creazione di un singolo file di output può influire sulle prestazioni di Data Integration. Non utilizzare l'opzione del singolo file di output per set di dati di grandi dimensioni.

    Per il tipo di caricamento di più entità dati, ogni nuova entità nella destinazione dispone di un singolo file corrispondente.

  4. Specificare l'opzione Nome entità dati di destinazione desiderata per la nuova destinazione. È possibile scegliere una delle seguenti opzioni:

    • Utilizzare gli stessi nomi di entità dell'origine: selezionare questa opzione per creare entità di destinazione con gli stessi nomi delle entità di origine.

    • Aggiungi prefisso/suffisso: selezionare questa opzione per aggiungere una stringa all'inizio (prefisso) o alla fine (suffisso) dei nomi di entità di origine per creare i nomi di entità di destinazione.

    • (Solo per il tipo di caricamento di entità singola) Specificare il nome dell'entità: immettere il nuovo nome dell'entità di destinazione nel campo.

      • Per lo storage degli oggetti: immettere il nuovo nome dell'entità dati, seguito da una barra (/). Ad esempio, immettere newfile/ o newdirectory/newfile/. Tuttavia, se si seleziona la casella di controllo Crea output come singolo file perché si desidera creare un unico output di file, immettere il nuovo nome entità senza la barra (/) alla fine.

      • Per una destinazione di database: se il nome dell'entità fornito esiste, il risultato dell'operazione dipende dalla forma della destinazione dal task Data Loader e dalla forma dell'entità esistente.

  5. (Facoltativo) (Solo per il tipo di caricamento di entità singola) È possibile assegnare un parametro all'entità dati solo se si è scelto di immettere un nome di entità dati nel passo precedente. Procedere in uno dei seguenti modi:
    • Fare clic su Parametrizza accanto alla risorsa per assegnare un parametro a tale risorsa. Durante la parametrizzazione, Data Integration aggiunge un parametro del tipo appropriato e imposta il valore del parametro predefinito sul valore attualmente configurato per tale risorsa.
    • Se disponibile, fare clic su Riutilizza parametro entità dati di origine per utilizzare il parametro entità di origine come parametro per questa entità dati di destinazione. Per ulteriori informazioni, vedere Riutilizzo dei parametri per le risorse di origine o di destinazione.
  6. Se applicabile, selezionare la scheda Impostazioni e immettere un valore per Rifiuta limite.

    Per Autonomous Data Warehouse o Autonomous Transaction Processing:

    È possibile specificare il numero massimo di righe errate che non possono essere caricate nella destinazione prima che il task non riesca. Ad esempio, se l'origine dati contiene 1.000 righe e si imposta il limite di rifiuto su 200, il task non riesce immediatamente dopo il rifiuto della 200a riga errata.

    Se non si specifica un valore, il valore predefinito è zero, ovvero il task non riesce alla prima riga errata rifiutata.

    Se si verifica un errore del task, controllare nei log i nomi delle tabelle in cui le righe sono state rifiutate. Quindi eseguire una query sulle tabelle e sulle righe interessate nel database autonomo.

Uso delle entità dati di destinazione esistenti

Quando si utilizzano le entità dati di destinazione esistenti, è necessario selezionare la strategia di integrazione che determina come caricare i dati nella destinazione esistente.

Per il tipo di caricamento di entità dati singola, è possibile utilizzare un parametro per l'entità dati dopo aver selezionato un'entità dati.

  1. Andare al passo Destinazione, scheda Entità dati.
  2. In Impostazioni caricamento entità dati di destinazione, selezionare Usa entità dati esistente.
  3. Per specificare come caricare i dati nella destinazione, selezionare una delle opzioni di strategia di integrazione disponibili.

    • Inserisci: inserisce nuovi record o aggiunge i record quando i dati esistono nella destinazione.

    • Sovrascrivi: esegue un troncamento sulla destinazione prima di inserire nuovi record.

      La strategia di integrazione deve essere Sovrascrivi se si desidera creare l'output come singolo file per la destinazione dello storage degli oggetti.

    • Unisci: consente di inserire nuovi record e di unire quelli esistenti. La strategia di unione è disponibile solo per le destinazioni del database.

      Per il tipo di caricamento di entità dati singola (vedere il passo 5), è possibile selezionare una chiave univoca diversa dalla chiave primaria per unire i dati.

      Per il tipo di caricamento di più entità dati, per impostazione predefinita viene utilizzata la chiave primaria. Non sono necessarie ulteriori azioni o selezioni.

  4. Solo per la strategia di sovrascrittura e la destinazione dello storage degli oggetti: selezionare la casella di controllo Crea output come singolo file se si desidera utilizzare un singolo file di output. In caso contrario, vengono creati più file.

    Il singolo file di output viene sovrascritto ogni volta che viene eseguito il task. La creazione di un singolo file di output può influire sulle prestazioni di Data Integration. Non utilizzare l'opzione del singolo file di output per set di dati di grandi dimensioni.

    Per il tipo di caricamento di più entità dati, ogni entità selezionata nella destinazione dispone di un singolo file corrispondente.

  5. Per il tipo di caricamento Singola entità dati:
    1. Nella tabella Entità dati disponibili selezionare un'entità dati. È possibile:

      • Selezionare la casella di controllo accanto al nome di un'entità, quindi selezionare Imposta come destinazione.

      • Filtrare l'elenco immettendo un nome o un pattern nel campo e premendo Invio.

        È possibile immettere un nome parziale o un pattern utilizzando caratteri speciali come *. Ad esempio, è possibile immettere ADDRESS_* per trovare ADDRESS_EU1, ADDRESS_EU2 e ADDRESS_EU3.

        Dall'elenco filtrato, selezionare la casella di controllo accanto al nome di un'entità, quindi selezionare Imposta come destinazione.

      • Per una destinazione di storage degli oggetti con la strategia di integrazione Sovrascrivi, selezionare un'entità dati esistente che non contenga la barra (/) alla fine del nome dell'entità.
      Il nome dell'entità dati selezionata viene visualizzato accanto all'etichetta Entità dati selezionata. Per selezionare un'entità dati diversa da utilizzare come destinazione, fare clic su Rimuovi, quindi selezionare l'entità dalla tabella Entità dati disponibili.
    2. (Facoltativo) È possibile assegnare un parametro all'entità dati dopo aver selezionato un'entità dati nel passo precedente. Procedere in uno dei seguenti modi:
      • Fare clic su Parametrizza accanto alla risorsa per assegnare un parametro a tale risorsa. Durante la parametrizzazione, Data Integration aggiunge un parametro del tipo appropriato e imposta il valore del parametro predefinito sul valore attualmente configurato per tale risorsa.
      • Se disponibile, fare clic su Riutilizza parametro entità dati di origine per utilizzare il parametro entità di origine come parametro per questa entità dati di destinazione. Per ulteriori informazioni, vedere Riutilizzo dei parametri per le risorse di origine o di destinazione.
    3. (Facoltativo) Per una destinazione di database con la strategia di integrazione Unisci:

      La chiave Unisci identifica l'attributo o gli attributi per determinare quali righe esistenti o nuove aggiornare o inserire. È possibile selezionare una chiave primaria/una chiave univoca o una chiave non primaria come chiave di unione.

      Fare clic su Seleziona o Modifica. Nel pannello Chiave di unione, eseguire una delle seguenti azioni:

      • Selezionare Attributi chiave primaria/unica e selezionare una chiave.
      • Selezionare Altri attributi per utilizzare altri attributi (non principali). Immettere un nome per la chiave di unione e selezionare gli attributi dall'elenco.
  6. Per il tipo di caricamento Più entità dati: per impostazione predefinita, le entità dati di origine vengono mappate automaticamente alle entità dati di destinazione disponibili in base al nome.
    1. Nella tabella Entità dati di origine, colonna Mapping, è possibile posizionare il cursore su un mapping con un segno di spunta verde per visualizzare il nome dell'entità di destinazione mappata.
    2. Per creare un mapping manuale, trascinare l'entità dati di origine nell'entità dati di destinazione. Quando si esegue un mapping manuale, viene aggiunta una regola di mapping.
    3. Per rimuovere un mapping AUTO o manuale, nella tabella Entità dati di destinazione, colonna Mapping, selezionare Cancella accanto a un mapping. Selezionare quindi Cancella mapping per confermare che si desidera rimuovere il mapping. Quando si cancella un mapping, viene aggiunta una regola di mapping.
    4. Nella tabella Entità dati di origine o Entità dati di destinazione è possibile effettuare le operazioni riportate di seguito.

      • Filtrare l'elenco immettendo un nome o un pattern nel campo e premendo Invio.

        È possibile immettere un nome parziale o un pattern utilizzando caratteri speciali come *. Ad esempio, è possibile immettere ADDRESS_* per trovare ADDRESS_EU1, ADDRESS_EU2 e ADDRESS_EU3.

      • Visualizzare tutte le entità, le entità mappate o le entità non mappate selezionando l'opzione appropriata dal menu sopra la tabella.

    5. Nel menu Azioni è possibile selezionare quanto segue.

      • Mapping automatico per nome: utilizzare questa azione per consentire a Data Integration di creare automaticamente i mapping tra le entità di origine e le entità di destinazione in base al nome.

      • Mappa per pattern: utilizzare questa azione per definire un pattern di origine e un pattern di destinazione per il mapping delle entità di origine alle entità di destinazione. La corrispondenza dei pattern distingue tra maiuscole e minuscole.

        Vedere Mappa per pattern.

    Per gestire le regole di mapping, vedere Visualizzazione e rimozione delle regole di mapping.
Visualizzazione e rimozione delle regole di mapping (più entità dati di destinazione)

In Data Integration vengono aggiunte regole di mapping quando si mappano manualmente le entità dati di origine alle entità dati di destinazione esistenti per un task di Data Loader.

Le regole vengono aggiunte anche quando si rimuovono i mapping.

  1. Andare al passo Destinazione, scheda Entità dati.
  2. Per visualizzare le regole create per un task di Data Loader, fare clic su Visualizza mapping.
  3. Nel pannello Regole mapping entità, rivedere i mapping creati.
  4. Per rimuovere una regola di mapping, è possibile utilizzare uno dei due modi riportati di seguito.

    • Selezionare la casella di controllo per una regola, quindi selezionare Rimuovi.

    • Selezionare il menu Azioni (Menu Azioni) per una regola, quindi selezionare Rimuovi.