Uso degli operatori della pipeline

In In Data Integration, gli operatori della pipeline rappresentano task e attività diversi che possono essere utilizzati in una pipeline.

Di seguito sono riportati i tipi di operatori di task che è possibile utilizzare in una pipeline.

Operatori di task di Integration e Data Loader che consentono di eseguire soluzioni di integrazione dati all'interno di una pipeline. È possibile configurare gli input per gli operatori. Gli input degli operatori task sono simili ai parametri definiti a livello di task o di flusso di dati.
Operatori di task SQL che consentono di eseguire stored procedure SQL all'interno di una pipeline. È possibile configurare i valori per i parametri nelle stored procedure.
Operatori dei task di OCI Data Flow che consentono di eseguire le applicazioni di OCI Data Flow all'interno di una pipeline.
Operatori di task REST che consentono di eseguire endpoint API REST all'interno di una pipeline. È possibile riconfigurare i valori di uno qualsiasi dei parametri utilizzati nel task REST.
Operatori di task della pipeline che consentono di eseguire un'altra pipeline all'interno di una pipeline.

Assicurarsi di esaminare Informazioni sul supporto e considerazioni durante l'utilizzo delle pipeline prima di creare o modificare una pipeline. Ad esempio, prestare attenzione al livello di profondità nidificato e al limite di attività per livello.

Per tutti gli operatori di task, è possibile selezionare task in fase di progettazione da progetti nell'area di lavoro corrente e task pubblicati da qualsiasi applicazione nell'area di lavoro corrente. Con i task REST pubblicati e i task di OCI Data Flow, è inoltre possibile selezionare un task da qualsiasi applicazione in un'altra area di lavoro nello stesso compartimento o in un altro compartimento.

Per i task eseguiti in parallelo, è possibile utilizzare un operatore di unione e specificare una condizione per gestire le operazioni successive a valle. Per recuperare l'output da qualsiasi operatore e passarlo all'operatore successivo, è possibile utilizzare un operatore di espressione.

Per creare una pipeline si utilizza un designer simile al designer del flusso di dati. Il designer viene aperto con un operatore iniziale e un operatore finale già posizionato sullo sfondo. In una pipeline possono esistere solo un operatore iniziale e un operatore finale. Una pipeline deve includere almeno un operatore task per essere valida. È possibile aggiungere un numero qualsiasi di task, quindi collegarli in una sequenza tra l'operatore iniziale e l'operatore finale. Dal pannello Operatori trascinare gli operatori sull'area di creazione per progettare la pipeline. Utilizzare quindi il pannello Properties per configurare le proprietà per ciascun operatore.

I task collegati direttamente all'operatore di avvio vengono sempre eseguiti. I task successivi nella sequenza possono essere configurati per l'esecuzione in base alla condizione dell'operatore precedente. Ad esempio, si consideri una pipeline con la sequenza Inizio > Task A > Task B > Fine. Il task A viene sempre eseguito. Per il task B, è possibile utilizzare la proprietà Condizione collegamento in entrata nel pannello Proprietà per configurare l'esecuzione del task in modo che venga eseguita sempre o solo quando lo stato del task A soddisfa una condizione di esecuzione specifica.

Per collegare gli operatori, passare il puntatore del mouse su un operatore fino a visualizzare il connettore (piccolo cerchio) sul lato destro dell'operatore. Trascinare quindi il connettore sull'operatore successivo a cui si desidera connettersi. Una connessione è valida quando una linea connette gli operatori dopo l'eliminazione del connettore.

In generale, un operatore dispone di una sola porta in entrata e di una o più porte in uscita per consentire ai processi di passare attraverso la pipeline. Ad esempio, è possibile connettere la stessa porta in uscita dell'operatore di task SQL alle porte in entrata su due operatori di espressione separati. Solo l'operatore finale e l'operatore di unione possono avere più porte in entrata.

È possibile duplicare rapidamente un operatore di task o espressione aggiunto a una pipeline. Per duplicare l'operatore, fare clic con il pulsante destro del mouse sull'icona dell'operatore nell'area di creazione e selezionare Duplica dal menu visualizzato. Quindi rinominare l'identificativo dell'operatore duplicato nel pannello Proprietà. Se l'operatore originale è collegato ad altri operatori, le connessioni e gli eventuali riferimenti alle uscite di un operatore precedente non vengono copiati nell'operatore duplicato.

Operatore iniziale e operatore finale

Quando si inizia a creare una pipeline, il designer viene aperto con un operatore iniziale e un operatore finale già posizionato nell'area di creazione. In una pipeline possono esistere solo un operatore iniziale e un operatore finale.

L'operatore iniziale non dispone di proprietà che è possibile configurare.

Con l'operatore finale, è possibile configurare la proprietà Condizione collegamento in entrata per specificare una delle seguenti regole per lo stato di esecuzione di un task pipeline:

Tutto completato: lo stato del task pipeline viene visualizzato come Operazione riuscita anche quando uno dei task nella pipeline non riesce.
Tutti i task riusciti: lo stato del task pipeline viene visualizzato come Operazione riuscita quando tutti i task nella pipeline vengono completati correttamente.
Tutto non riuscito: lo stato del task pipeline viene visualizzato come Operazione riuscita quando tutti i task nella pipeline non riescono.

Operatore di unione

Per i task eseguiti in parallelo, è possibile utilizzare l'operatore di unione e specificare una condizione per decidere come gestire le operazioni successive a valle.

Aggiunta e configurazione di un operatore di unione

Un operatore di unione può avere più collegamenti di input (a monte) e più collegamenti di output (a valle).

Dal pannello Operatori, trascinare l'operatore Unisci sull'area di creazione.
Nella scheda Dettagli del pannello Proprietà immettere un nome e una descrizione facoltativa per l'operatore di unione.
Per la condizione di unione, è possibile selezionare una delle seguenti opzioni:
- Tutte le operazioni riuscite: tutte le operazioni parallele collegate a monte devono essere completate e riuscite prima di poter procedere con l'operazione a valle successiva. Questa è l'opzione predefinita.
- Tutte le operazioni non riuscite: tutte le operazioni parallele collegate a monte devono essere completate e non riuscite prima di poter continuare l'operazione a valle successiva.
- Tutte completate: tutte le operazioni parallele collegate a monte devono essere completate prima di poter procedere con l'operazione a valle successiva.
- Almeno un'operazione riuscita: almeno un'operazione collegata a monte deve essere completata e riuscita prima di poter procedere con l'operazione a valle successiva.
- Almeno un'operazione non riuscita: almeno un'operazione collegata a monte deve essere completata e non riuscita prima di poter continuare l'operazione a valle successiva.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Gli output disponibili sono una combinazione di parametri di output del sistema e gli output per ciascun operatore di task connesso all'operatore di unione.

Operatore espressione

Un operatore di espressione pipeline consente di creare nuovi campi derivati in una pipeline, come un operatore di espressione in un flusso di dati.

Aggiunta e configurazione di un operatore di espressione

A differenza di un operatore di espressione del flusso di dati, un operatore di espressione della pipeline non funziona sui dati. Un operatore di espressione della pipeline consente di operare sull'output dell'operatore precedente, dei parametri della pipeline e dell'output generato dal sistema.

Nel pannello Operatori trascinare l'operatore Espressione sull'area di creazione.
Con l'operatore dell'espressione attivo, nella scheda Dettagli del pannello Proprietà immettere un nome nel campo Identificativo o lasciare il nome così com'è.
(Facoltativo) Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
- Esegui sempre: esegue il nodo selezionato indipendentemente dallo stato del nodo a monte.
  
  Una linea grigia indica la condizione Always run.
  
  Impossibile modificare la condizione di collegamento per i nodi collegati direttamente all'operatore Start.
- Esegui in caso di operazione riuscita dell'operatore precedente: esegue il nodo selezionato solo quando lo stato del nodo a monte è 'Operazione riuscita'.
  
  Una linea verde con un segno di spunta indica una condizione riuscita.
- Esegui in caso di errore dell'operatore precedente: esegue il nodo selezionato solo quando lo stato del nodo a monte è 'Non riuscito'.
  
  Una linea rossa con una 'x' indica una condizione di errore.
In Espressioni, fare clic su Aggiungi.
Nel pannello Aggiungi espressione, immettere un nome nel campo Identificativo oppure lasciare il nome così com'è.
Selezionare il Tipo di dati per l'espressione.
A seconda del tipo selezionato, potrebbe essere necessario specificare altri valori, ad esempio Lunghezza o Ridimensionamento.
Creare un'espressione nella Costruzione guidata espressione e fare clic su Aggiungi.
Il valore derivato da un'espressione può essere utilizzato nell'operatore successivo connesso a questo operatore di espressione della pipeline.
Ripetere i passi per aggiungere altre espressioni.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output delle espressioni che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Ogni espressione aggiunta ha un output. Un output ha lo stesso nome dell'espressione.
Nella scheda Convalida del pannello Proprietà è possibile convalidare l'operatore per verificare la presenza di errori e avvertenze.

Aggiunta di un'espressione

Utilizzare il Builder delle espressioni per selezionare visivamente gli elementi per creare un'espressione per un operatore di espressione in una pipeline. È inoltre possibile immettere un'espressione manualmente nell'editor.

Il Builder delle espressioni è una sezione del pannello Aggiungi espressione.

Nella Costruzione guidata espressione fare doppio clic per selezionare o trascinare un valore in entrata, un parametro o una funzione per creare l'espressione.
Un'espressione può essere una combinazione di output di sistema da un operatore precedente, parametri di sistema, parametri definiti dall'utente e funzioni.
Per i valori In entrata, è possibile scegliere tra gli output di sistema dell'operatore precedente. Se l'operatore precedente è l'unione, gli output di sistema sono gli output combinati degli operatori task connessi all'operatore unione.
Per Parametri, è possibile scegliere tra i parametri di sistema e i parametri definiti dall'utente creati nella pipeline.
- Definito dall'utente: un parametro definito dall'utente è un parametro personalizzato creato dall'utente.
  È possibile selezionare un parametro esistente dall'elenco dei parametri definiti dall'utente disponibili oppure fare clic su Aggiungi per crearne uno.
  1. Nel pannello Aggiungi parametro immettere un nome per il parametro e una descrizione facoltativa.
  2. Selezionare il tipo di dati per questo parametro.
  3. Definire il resto dei campi per questo parametro in base al tipo di dati selezionato.
  4. Impostare un valore predefinito per questo parametro.
  5. Fare clic su Aggiungi.
- Definizione di sistema: in fase di esecuzione, Data Integration genera determinati parametri di sistema per una pipeline. I valori dei parametri di sistema generati possono essere utilizzati nelle espressioni, ma non possono essere modificati.
Per Funzioni, è possibile scegliere tra le funzioni disponibili di Data Integration per gli operatori della pipeline.
Nel pannello Aggiungi espressione, fare clic su Aggiungi per creare o aggiornare l'espressione.

Eliminazione di un'espressione

È possibile eliminare le espressioni quando non sono più necessarie.

Nell'area di creazione di una pipeline, selezionare un operatore di espressione.
Con l'operatore di espressione attivo, nella scheda Dettagli del pannello Proprietà, selezionare l'espressione che si desidera eliminare, quindi fare clic su Elimina.
Nella finestra di dialogo Elimina espressione verificare di voler eliminare questa espressione, quindi fare clic su Elimina.

Operatore decisionale

Utilizzare l'operatore decisionale per scrivere una condizione booleana che determina il flusso di diramazione nella pipeline. La diramazione si basa su tre possibili risultati, ovvero TRUE, FALSE e ERROR.

Aggiunta e configurazione di un operatore decisionale

Un operatore decisionale dispone di un collegamento di input (a monte) e di tre collegamenti di output (a valle).

Nel pannello Operatori trascinare l'operatore Decisione sull'area di creazione.

Per impostazione predefinita, l'icona dell'operatore di decisione viene visualizzata come espansa e mostra tre porte di output, ovvero TRUE, FALSE e ERROR.
Nella scheda Dettagli del pannello Proprietà immettere un nome e una descrizione facoltativa per l'operatore decisionale.
Per la condizione Decisione, effettuare le operazioni riportate di seguito.
1. Fare clic su Aggiungi.
2. Nel pannello Aggiungi condizione decisionale, scrivere una condizione utilizzando valori, parametri o funzioni in entrata, in modo che l'espressione della condizione restituisca un valore booleano.
  Ad esempio, una condizione potrebbe valutare lo stato di esecuzione del task precedente: PREVIOUS_TASK_1.SYS.STATUS = 'SUCCESS'
  - Per i valori In entrata, è possibile scegliere tra gli output di sistema dell'operatore precedente.
  - Per Parametri, è possibile scegliere tra i parametri di sistema e i parametri definiti dall'utente creati nella pipeline.
    - Definito dall'utente: un parametro definito dall'utente è un parametro personalizzato creato dall'utente.
      
      È possibile selezionare un parametro esistente dall'elenco dei parametri definiti dall'utente disponibili oppure fare clic su Aggiungi per crearne uno.
    - Definizione di sistema: in fase di esecuzione, Data Integration genera determinati parametri di sistema per una pipeline. I valori dei parametri di sistema generati possono essere utilizzati nelle espressioni, ma non possono essere modificati.
  - Per Funzioni, è possibile scegliere tra le funzioni disponibili di Data Integration per gli operatori della pipeline.
(Facoltativo) Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
- Esegui sempre: esegue il nodo selezionato indipendentemente dallo stato del nodo a monte.
  
  Una linea grigia indica la condizione Always run.
  
  Impossibile modificare la condizione di collegamento per i nodi collegati direttamente all'operatore Start.
- Esegui in caso di operazione riuscita dell'operatore precedente: esegue il nodo selezionato solo quando lo stato del nodo a monte è 'Operazione riuscita'.
  
  Una linea verde con un segno di spunta indica una condizione riuscita.
- Esegui in caso di errore dell'operatore precedente: esegue il nodo selezionato solo quando lo stato del nodo a monte è 'Non riuscito'.
  
  Una linea rossa con una 'x' indica una condizione di errore.
Nell'area di creazione collegare le porte di output appropriate sull'operatore di decisione a un operatore di task o di espressione a valle.

Impossibile collegare direttamente una porta di output dell'operatore decisionale a un operatore di unione o a un operatore finale.

Operatore task di Data Loader

Un operatore di task di Data Loader consente di eseguire un task di Data Loader all'interno di una pipeline.

Aggiunta e configurazione di un operatore di task di Data Loader

Un operatore di task di Data Loader connesso direttamente all'operatore di avvio viene sempre eseguito.

Per un operatore di task non connesso direttamente all'operatore iniziale, è possibile utilizzare la proprietà Condizione collegamento in entrata per configurare l'esecuzione del task in modo che venga eseguita sempre o solo quando lo stato dell'operatore precedente soddisfa una condizione di esecuzione specifica.

Nel pannello Operatori trascinare un operatore Data Loader sull'area di creazione.
L'icona operatore nell'area di creazione mostra un nome predefinito che indica che l'operatore non è ancora associato a un task nell'area di lavoro.
Nella scheda Dettagli del pannello Proprietà per l'operatore di task non associato, fare clic su Seleziona. Nel pannello visualizzato utilizzare il menu per scegliere il tipo di task da aggiungere, quindi selezionare il task.

Progettare task: per utilizzare un task in un progetto, selezionare prima un progetto dal menu di elenco Progetti. È inoltre possibile iniziare a digitare un nome di progetto per filtrare l'elenco e selezionarlo da un elenco filtrato di nomi corrispondenti. Solo i progetti nell'area di lavoro corrente sono disponibili per la selezione.

Task pubblicati: i task pubblicati dell'applicazione più recente e aggiornata nell'area di lavoro e nel compartimento correnti sono elencati per la selezione. È possibile utilizzare i menu per passare a un'altra applicazione nell'area di lavoro corrente. È anche possibile iniziare a digitare un nome nella casella Aree di lavoro o Applicazioni e selezionarlo da un elenco filtrato di nomi corrispondenti.
Nel pannello Selezionare un task di Data Loader, selezionare un task e fare clic su Seleziona.
Il nome sull'icona dell'operatore nell'area di creazione viene modificato nel nome del task selezionato.
Nella scheda Details del pannello Properties per l'operatore di task selezionato:
1. Rinominare l'operatore, se lo si desidera.
2. Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
  - Esegui sempre: esegue il task selezionato indipendentemente dallo stato dell'operatore a monte.
    
    Una linea grigia indica la condizione Always run.
    
    Impossibile modificare la condizione di collegamento per i task collegati direttamente all'operatore Start.
  - Esegui in caso di operazione riuscita dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Operazione riuscita'.
    
    Una linea verde con un segno di spunta indica una condizione riuscita.
  - Esegui in caso di errore dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Non riuscito'.
    
    Una linea rossa con una 'x' indica una condizione di errore.
Nella scheda Configurazione del pannello Proprietà è possibile effettuare le operazioni riportate di seguito.
1. Configura opzioni di esecuzione per specificare la modalità di gestione delle esecuzioni dei task non riuscite.
2. Configurare i valori dei parametri in entrata.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Nella scheda Convalida del pannello Proprietà è possibile convalidare il task per verificare la presenza di errori e avvertenze nei valori dei parametri configurati, se applicabile.

Operatore task integrazione

Un operatore del task di integrazione consente di eseguire un flusso di dati configurato per un contesto specifico. Il flusso di dati deve essere sottoposto a wrapping in un task di integrazione.

Aggiunta e configurazione di un operatore del task di integrazione

Un operatore di task di integrazione connesso direttamente all'operatore di avvio viene sempre eseguito.

Nel pannello Operatori trascinare un operatore Integrazione sull'area di creazione.
L'icona operatore nell'area di creazione mostra un nome predefinito che indica che l'operatore non è ancora associato a un task nell'area di lavoro.
Nella scheda Dettagli del pannello Proprietà per l'operatore di task non associato, fare clic su Seleziona. Nel pannello visualizzato utilizzare il menu per scegliere il tipo di task da aggiungere, quindi selezionare il task.

Progettare task: per utilizzare un task in un progetto, selezionare prima un progetto dal menu di elenco Progetti. È inoltre possibile iniziare a digitare un nome di progetto per filtrare l'elenco e selezionarlo da un elenco filtrato di nomi corrispondenti. Solo i progetti nell'area di lavoro corrente sono disponibili per la selezione.

Task pubblicati: i task pubblicati dell'applicazione più recente e aggiornata nell'area di lavoro e nel compartimento correnti sono elencati per la selezione. È possibile utilizzare i menu per passare a un'altra applicazione nell'area di lavoro corrente. È anche possibile iniziare a digitare un nome nella casella Aree di lavoro o Applicazioni e selezionarlo da un elenco filtrato di nomi corrispondenti.
Nel pannello Selezionare un task di integrazione, selezionare un task e fare clic su Seleziona.
Il nome sull'icona dell'operatore nell'area di creazione viene modificato nel nome del task selezionato.
Nella scheda Details del pannello Properties per l'operatore di task selezionato:
1. Rinominare l'operatore, se lo si desidera.
2. Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
  - Esegui sempre: esegue il task selezionato indipendentemente dallo stato dell'operatore a monte.
    
    Una linea grigia indica la condizione Always run.
    
    Impossibile modificare la condizione di collegamento per i task collegati direttamente all'operatore Start.
  - Esegui in caso di operazione riuscita dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Operazione riuscita'.
    
    Una linea verde con un segno di spunta indica una condizione riuscita.
  - Esegui in caso di errore dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Non riuscito'.
    
    Una linea rossa con una 'x' indica una condizione di errore.
Nella scheda Configurazione del pannello Proprietà è possibile effettuare le operazioni riportate di seguito.
1. Configura opzioni di esecuzione per specificare la modalità di gestione delle esecuzioni dei task non riuscite.
2. Configurare i valori dei parametri in entrata.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Nella scheda Convalida del pannello Proprietà è possibile convalidare il task per verificare la presenza di errori e avvertenze nei valori dei parametri configurati, se applicabile.

Operatore task pipeline

Un operatore di task pipeline consente di eseguire una pipeline all'interno di un'altra pipeline.

Aggiunta e configurazione di un operatore di task pipeline

Un operatore di task pipeline connesso direttamente all'operatore di avvio viene sempre eseguito.

Dal pannello Operatori, trascinare l'operatore Pipeline sull'area di creazione.
L'icona operatore nell'area di creazione mostra un nome predefinito che indica che l'operatore non è ancora associato a un task nell'area di lavoro.
Nella scheda Dettagli del pannello Proprietà per l'operatore di task non associato, fare clic su Seleziona. Nel pannello visualizzato utilizzare il menu per scegliere il tipo di task da aggiungere, quindi selezionare il task.

Progettare task: per utilizzare un task in un progetto, selezionare prima un progetto dal menu di elenco Progetti. È inoltre possibile iniziare a digitare un nome di progetto per filtrare l'elenco e selezionarlo da un elenco filtrato di nomi corrispondenti. Solo i progetti nell'area di lavoro corrente sono disponibili per la selezione.

Task pubblicati: i task pubblicati dell'applicazione più recente e aggiornata nell'area di lavoro e nel compartimento correnti sono elencati per la selezione. È possibile utilizzare i menu per passare a un'altra applicazione nell'area di lavoro corrente. È anche possibile iniziare a digitare un nome nella casella Aree di lavoro o Applicazioni e selezionarlo da un elenco filtrato di nomi corrispondenti.
Nel pannello Selezionare un task pipeline, selezionare un task e fare clic su Seleziona.
Il nome sull'icona dell'operatore nell'area di creazione viene modificato nel nome del task selezionato.
Nella scheda Details del pannello Properties per l'operatore di task selezionato:
1. Rinominare l'operatore, se lo si desidera.
2. Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
  - Esegui sempre: esegue il task selezionato indipendentemente dallo stato dell'operatore a monte.
    
    Una linea grigia indica la condizione Always run.
    
    Impossibile modificare la condizione di collegamento per i task collegati direttamente all'operatore Start.
  - Esegui in caso di operazione riuscita dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Operazione riuscita'.
    
    Una linea verde con un segno di spunta indica una condizione riuscita.
  - Esegui in caso di errore dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Non riuscito'.
    
    Una linea rossa con una 'x' indica una condizione di errore.
Nella scheda Configurazione del pannello Proprietà è possibile effettuare le operazioni riportate di seguito.
1. Configura opzioni di esecuzione per specificare la modalità di gestione delle esecuzioni dei task non riuscite.
2. Configurare i valori dei parametri in entrata.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Nella scheda Convalida del pannello Proprietà è possibile convalidare il task per verificare la presenza di errori e avvertenze nei valori dei parametri configurati, se applicabile.

Operatore task SQL

Un operatore di task SQL consente di eseguire un oggetto SQL, ad esempio una stored procedure.

Aggiunta e configurazione di un operatore di task SQL

Un operatore di task SQL connesso direttamente all'operatore di avvio viene sempre eseguito.

Nel pannello Operatori trascinare l'operatore SQL sull'area di creazione.
L'icona operatore nell'area di creazione mostra un nome predefinito che indica che l'operatore non è ancora associato a un task nell'area di lavoro.
Nella scheda Dettagli del pannello Proprietà per l'operatore di task non associato, fare clic su Seleziona. Nel pannello visualizzato utilizzare il menu per scegliere il tipo di task da aggiungere, quindi selezionare il task.

Progettare task: per utilizzare un task in un progetto, selezionare prima un progetto dal menu di elenco Progetti. È inoltre possibile iniziare a digitare un nome di progetto per filtrare l'elenco e selezionarlo da un elenco filtrato di nomi corrispondenti. Solo i progetti nell'area di lavoro corrente sono disponibili per la selezione.

Task pubblicati: i task pubblicati dell'applicazione più recente e aggiornata nell'area di lavoro e nel compartimento correnti sono elencati per la selezione. È possibile utilizzare i menu per passare a un'altra applicazione nell'area di lavoro corrente. È anche possibile iniziare a digitare un nome nella casella Aree di lavoro o Applicazioni e selezionarlo da un elenco filtrato di nomi corrispondenti.
Nel pannello Selezionare un task SQL, selezionare un task e fare clic su Seleziona.
Il nome sull'icona dell'operatore nell'area di creazione viene modificato nel nome del task selezionato.
Nella scheda Details del pannello Properties per l'operatore di task selezionato:
1. Rinominare l'operatore, se lo si desidera.
2. Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
  - Esegui sempre: esegue il task selezionato indipendentemente dallo stato dell'operatore a monte.
    
    Una linea grigia indica la condizione Always run.
    
    Impossibile modificare la condizione di collegamento per i task collegati direttamente all'operatore Start.
  - Esegui in caso di operazione riuscita dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Operazione riuscita'.
    
    Una linea verde con un segno di spunta indica una condizione riuscita.
  - Esegui in caso di errore dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Non riuscito'.
    
    Una linea rossa con una 'x' indica una condizione di errore.
Nella scheda Configurazione del pannello Proprietà è possibile effettuare le operazioni riportate di seguito.
1. Configura opzioni di esecuzione per specificare la modalità di gestione delle esecuzioni dei task non riuscite.
2. Configurare i valori dei parametri in entrata.
  Le variabili definite in una stored procedure vengono esposte come parametri di input, output e in-out. È possibile configurare solo i parametri di input.
  
  Nota
  
  Il valore configurato di un parametro di input deve corrispondere al tipo di dati definito del parametro. Ad esempio, non è possibile fornire un valore String per un parametro di input di tipo dati NUMERIC. Inoltre, il valore configurato di un parametro di input di tipo dati NUMERIC non può essere NULL in runtime.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Vengono visualizzati sia i parametri di output generati dal sistema che i parametri di output della stored procedure SQL. Vedere anche Parametri di output.
Nella scheda Convalida del pannello Proprietà è possibile convalidare il task per verificare la presenza di errori e avvertenze nei valori dei parametri configurati, se applicabile.

Nota

L'esecuzione di un task SQL non riesce se i parametri di input del tipo di dati NUMERIC configurati hanno NULL come valore predefinito. Per evitare errori di esecuzione dei task, modificare un valore NULL in 0 (zero).

Operatore task di OCI Data Flow

Un operatore di task OCI Data Flow consente di eseguire un'applicazione OCI Data Flow in una pipeline.

Aggiunta e configurazione di un operatore task di OCI Data Flow

Un operatore task connesso direttamente all'operatore di avvio viene sempre eseguito.

Nel pannello Operatori trascinare l'operatore Flusso di dati OCI nell'area di creazione.
L'icona operatore nell'area di creazione mostra un nome predefinito che indica che l'operatore non è ancora associato a un task nell'area di lavoro.
Nella scheda Dettagli del pannello Proprietà per l'operatore di task non associato, fare clic su Seleziona. Nel pannello visualizzato utilizzare il menu per scegliere il tipo di task da aggiungere, quindi selezionare il task.

Progettare task: per utilizzare un task in un progetto, selezionare prima un progetto dal menu di elenco Progetti. È inoltre possibile iniziare a digitare un nome di progetto per filtrare l'elenco e selezionarlo da un elenco filtrato di nomi corrispondenti. Solo i progetti nell'area di lavoro corrente sono disponibili per la selezione.

Task pubblicati: i task pubblicati dell'applicazione più recente e aggiornata nell'area di lavoro e nel compartimento correnti sono elencati per la selezione. È possibile utilizzare i menu per passare a un'altra applicazione nell'area di lavoro corrente o in un'altra area di lavoro nello stesso compartimento o in un altro compartimento. È anche possibile iniziare a digitare un nome nella casella Aree di lavoro o Applicazioni e selezionarlo da un elenco filtrato di nomi corrispondenti.
Nel pannello Selezionare un task di OCI Data Flow selezionare un task e fare clic su Seleziona.
Il nome sull'icona dell'operatore nell'area di creazione viene modificato nel nome del task selezionato.
Nella scheda Details del pannello Properties per l'operatore di task selezionato:
1. Rinominare l'operatore, se lo si desidera.
2. Per la condizione del collegamento in entrata, è possibile selezionare una delle seguenti condizioni di esecuzione. Quando gli operatori sono connessi, una linea colorata indica la condizione selezionata.
  - Esegui sempre: esegue il task selezionato indipendentemente dallo stato dell'operatore a monte.
    
    Una linea grigia indica la condizione Always run.
    
    Impossibile modificare la condizione di collegamento per i task collegati direttamente all'operatore Start.
  - Esegui in caso di operazione riuscita dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Operazione riuscita'.
    
    Una linea verde con un segno di spunta indica una condizione riuscita.
  - Esegui in caso di errore dell'operatore precedente: esegue il task selezionato solo quando lo stato dell'operatore a monte è 'Non riuscito'.
    
    Una linea rossa con una 'x' indica una condizione di errore.
Nella scheda Configurazione del pannello Proprietà è possibile effettuare le operazioni riportate di seguito.
1. Configurare i valori dei parametri in entrata.
  È possibile riconfigurare i valori dei parametri assegnati ai valori delle proprietà nel task OCI Data Flow di base.
2. Configura opzioni di esecuzione per specificare la modalità di gestione delle esecuzioni dei task non riuscite.
Nella scheda Output del pannello Proprietà è possibile visualizzare gli output che possono essere utilizzati come input per l'operatore successivo nella pipeline.
Vengono visualizzati sia i parametri di output generati dal sistema che i parametri di output dell'applicazione. Vedere anche Parametri di output.
Nella scheda Convalida del pannello Proprietà è possibile convalidare il task per verificare la presenza di errori e avvertenze nei valori dei parametri configurati, se applicabile.

Operatore task REST

Un operatore di task REST consente di eseguire un endpoint API REST in una pipeline.

Aggiunta e configurazione di un operatore di task REST