Documentazione dell'infrastruttura Oracle Cloud

Uso dei parametri nelle pipeline

In In Data Integration, i parametri nelle pipeline derivano da parametri assegnati nei flussi di dati e nei task.

Per gli operatori di flusso dati che utilizzano espressioni nella configurazione, i valori di tutti i parametri utilizzati nelle espressioni sono disponibili anche per la riconfigurazione in una pipeline.

Vedere Utilizzo dei parametri del flusso di dati e Informazioni sui parametri di espressione per informazioni sull'utilizzo dei parametri e dei parametri di espressione (noti anche come parametri scalari) nei flussi di dati.

I parametri e i parametri di espressione utilizzati nei flussi di dati e nei task hanno tipi e valori predefiniti. Se non si modificano i valori dei parametri in entrata per i task e i flussi di dati associati in una pipeline, i valori predefiniti originali vengono utilizzati in fase di progettazione della pipeline o in fase di runtime durante l'esecuzione della pipeline.

Di seguito sono riportati i tipi di dati dei parametri in entrata supportati.

  • NUMERIC
  • VARCHAR
  • DATE
  • DATETIME
  • DECIMAL
  • DOUBLE
  • FLOAT
  • INTEGER
  • TIMESTAMP
  • TINYINT
  • BOOLEAN
  • LONG
  • STRING

I parametri per le risorse di origine e di destinazione in un task di Data Loader possono essere riconfigurati anche quando il task viene utilizzato in una pipeline. Per informazioni sull'utilizzo dei parametri nei task del programma di caricamento dati, vedere Utilizzo dei parametri per l'origine e la destinazione.

Modalità di riconfigurazione dei parametri in una pipeline

Quando si aggiunge un task con parametri a una pipeline, è possibile utilizzare la scheda Configurazione nel pannello Proprietà per riconfigurare uno qualsiasi dei valori dei parametri specificati in tale task o nel flusso di dati associato a cui viene eseguito il wrapping di un task di integrazione.

Per riconfigurare un valore di parametro in entrata per un task in una pipeline, è possibile assegnare all'input:

Quando si crea un task pipeline per una pipeline con parametri, è possibile utilizzare la pagina Configura parametri per modificare i valori predefiniti degli eventuali parametri definiti dall'utente.

Tipi di parametri pipeline

In In Data Integration, i tipi di parametri che è possibile utilizzare nelle pipeline sono definiti dall'utente o generati dal sistema.

I parametri generati dal sistema possono essere classificati nei seguenti tipi:

Parametri definiti dall'utente

I parametri definiti dall'utente sono parametri personalizzati creati nelle pipeline da assegnare agli input dei parametri in entrata per gli operatori di task. Un parametro definito dall'utente è locale della pipeline in cui è stato creato, pertanto non è possibile riutilizzare un parametro definito dall'utente tra le pipeline.

Un parametro definito dall'utente ha un nome, un tipo e un valore. Quando si crea un parametro definito dall'utente, è possibile specificare un nome e un valore. Il tipo dipende dal tipo di parametro in entrata a cui si sta assegnando il parametro definito dall'utente. Impossibile modificare il tipo di un parametro definito dall'utente.

Di seguito sono riportati i tipi di parametri definiti dall'utente che è possibile creare in una pipeline.

  • Asset dati
  • Connessione
  • Schema
  • Entità dati
  • Condizione (da una condizione di join o filtro con parametri)
  • Espressione

È inoltre possibile aggiungere parametri di tipi di dati quali NUMERIC, VARCHAR, DATE, DECIMAL e STRING.

Durante la progettazione di una pipeline, è possibile utilizzare il pannello Parametri o la scheda Parametri nel pannello Proprietà della pipeline per visualizzare i parametri definiti dall'utente aggiunti.

I parametri definiti dall'utente sono disponibili anche nel Builder delle espressioni quando si definisce un'espressione nella pipeline utilizzando un operatore di espressione.

Parametri di sistema

Integrazione dati genera parametri di sistema che è possibile utilizzare per assegnare agli input dei parametri in entrata per gli operatori di task in runtime. Un parametro di sistema ha un nome e un tipo. È possibile associare il valore di un parametro di sistema a un parametro in entrata dello stesso tipo, ma non è possibile modificare il valore.

La tabella seguente mostra i parametri di sistema che è possibile utilizzare in una pipeline.

NomeDigitadescrizione;
SYS.TASK_START_TIMEINDICATORE ORARIOOra inizio task in UTC.
SYS.TASK_RUN_KEY

STRING

Chiave di esecuzione task dell'esecuzione task.
SYS.TASK_RUN_NAME

STRING

 Nome dell'esecuzione del task.
SYS.TASK_KEY

STRING

 Chiave del task.
SYS.TASK_NAME

STRING

 Nome del task.
SYS.PARENT_TASK_RUN_KEY

STRING

Chiave di esecuzione task padre.
SYS.TASK_SCHEDULE_TRIGGER_TIMEINDICATORE ORARIOL'ora di trigger per la pianificazione (per un'esecuzione di task avviata da una pianificazione). L'ora schedulata potrebbe essere diversa dall'ora di inizio del task.
SYS.TASK_SCHEDULE_TIMEZONESTRINGIl fuso orario corrispondente all'ora pianificata, che rappresenta l'ora del fuso orario definita nella pianificazione del task.
SYS.RETRY_ATTEMPTINTEGERNumero di tentativi di esecuzione di un task configurato per i nuovi tentativi quando un'esecuzione non riesce.
SYS.PIPELINE_NAMESTRINGNome della pipeline.
SYS.PIPELINE_IDENTIFIERSTRINGIdentificativo della pipeline.
SYS.TIMEOUTINTEGERIl valore di timeout (in minuti) della pipeline. L'esecuzione della pipeline non riesce quando viene raggiunto il valore di timeout.
SYS.WORKSPACE_ID STRING Identificativo dell'area di lavoro.
SYS.APPLICATION_KEY STRING Chiave dell'applicazione.
SYS.REGION STRING Nome area.

Durante la progettazione di una pipeline, è possibile utilizzare la scheda Parametri nel pannello Proprietà della pipeline per visualizzare i parametri della pipeline di sistema disponibili. La colonna Utilizzato in indica dove viene utilizzato un parametro nella pipeline.

Durante l'aggiunta di un'espressione a un operatore di espressione in una pipeline, è possibile utilizzare la scheda Parametri nel Builder delle espressioni per visualizzare la lista dei parametri di sistema. È possibile utilizzare i parametri di sistema nelle espressioni per registrare le informazioni di sistema.

Parametri di output

I parametri di output sono parametri generati dal sistema per gli operatori che è possibile utilizzare per passare i valori di output da un operatore in una pipeline a un altro operatore a valle.

La tabella seguente mostra alcuni parametri di output che è possibile utilizzare.

NomeDigitadescrizione;
SYS.STATUSSTRINGStato dell'operazione (ad esempio, esecuzione task)
SYS.ERROR_MESSAGESTRINGMessaggio di errore per l'operazione
SYS.NO_DI_INSERTIINTEGERNumero di righe inserite e aggiornate
SYS.DATA_READINTEGERNumero di dati letti
SYS.DATA_WRITTENINTEGERNumero di dati scritti
SYS.DURATIONINTEGERDurata dell'operazione
SYS.START_TIME_TIMESTAMPINDICATORE ORARIOOra di inizio dell'esecuzione del task in formato indicatore orario.
SYS.END_TIME_TIMESTAMPINDICATORE ORARIOOra di fine dell'esecuzione del task in formato indicatore orario.
SYS.TASK_RUN_KEY

STRING

 Chiave di esecuzione task dell'esecuzione task.
SYS.TASK_RUN_NAME

STRING

 Nome dell'esecuzione del task.
SYS.TASK_NAME

STRING

 Nome del task.
SYS.TASK_KEY

STRING

 Chiave del task.

Durante la progettazione di una pipeline, è possibile utilizzare la scheda Output nel pannello Proprietà di un operatore task per visualizzare gli output che possono essere utilizzati come input per l'operatore successivo.

Tenere presente quanto riportato di seguito.

  • Per un operatore di task SQL associato a una stored procedure, gli output includono tutti i parametri di output della stored procedure SQL.

  • Per un operatore di unione, gli output disponibili sono una combinazione di parametri di output del sistema e gli output per ogni operatore connesso all'operatore di unione.

    • Sono disponibili solo i seguenti output del sistema: SYS.STATUS, SYS.START_TIME_TIMESTAMP e SYS.END_TIME_TIMESTAMP
    • Gli output dei task sono qualificati da un nome operatore task. Ad esempio: TASK_OPERATOR_1. SYS.STATUS, TASK_OPERATOR_2. SYS.STATUS
    • Gli output di un operatore di espressione sono qualificati dal nome dell'operatore di espressione e dall'identificativo di espressione. Ad esempio: EXPRESSION_1. EXPRESSION_ERROR_MESSAGE
    • Gli output di un operatore di unione vengono qualificati dal nome dell'operatore di unione. Ad esempio: MERGE_3. SYS.START_TIME_TIMESTAMP

  • Per un operatore di task OCI Data Flow associato a un'applicazione OCI Data Flow, gli output includono eventuali parametri di output dell'applicazione e i tipi di dati di output riportati di seguito.

    • com.oracle.dos.task.model.customparameter.Arguments: argomenti
    • Float:
      • bytesProcessed
      • bytesWritten
    • String:
      • applicationId
      • displayName

  • Per un operatore di task REST, sono disponibili i seguenti tipi di dati di output di risposta REST:

    • JSON o JSON_TEXT: SYS.RESPONSE_PAYLOAD_JSON e SYS.RESPONSE_HEADERS_JSON
    • Stringa: SYS.RESPONSE_STATUS
    Nota

    • Per utilizzare un output di risposta REST nelle operazioni a valle, passare l'output tramite un operatore di espressione in cui è possibile applicare operazioni string e regex. Quindi utilizzare il risultato in successivi operatori di task a valle.
    • Gli output String SYS.RESPONSE_PAYLOAD e SYS.RESPONSE_HEADERS non sono più validi. Si consiglia di convertire qualsiasi uso esistente negli equivalenti dei tipi di dati JSON, rispettivamente SYS.RESPONSE_PAYLOAD_JSON e SYS.RESPONSE_HEADERS_JSON.

Informazioni sul pannello Parametri

Il pannello Parametri mostra tutti i parametri della pipeline definiti dall'utente creati in una pipeline.

Per accedere al pannello Parametri quando la pipeline viene aperta nello sfondo del designer, selezionare Parametri dal menu Visualizza nella barra degli strumenti dello sfondo.

Utilizzare la scheda Visualizza per visualizzare i parametri definiti dall'utente nella pipeline. Vengono visualizzati i parametri utilizzati e inutilizzati. Quando si fa clic sul collegamento Utilizzato in per un parametro utilizzato nella pipeline, l'operatore task che fa riferimento a tale parametro viene messo in primo piano nell'area di creazione.

Utilizzare la scheda Configurazione nel pannello Parametri per eliminare un parametro definito dall'utente o modificare il valore predefinito.

Nota

Quando si elimina un parametro della pipeline definito dall'utente, tutti i valori configurati negli operatori associati al parametro vengono rimossi. Per riconfigurare un valore di input, vedere Configurazione dei parametri in entrata per i task.

Aggiunta di un parametro in una pipeline

È possibile aggiungere e definire parametri definiti dall'utente sui parametri in entrata degli operatori di task in una pipeline.

La modalità di definizione di un parametro definito dall'utente dipende dal tipo di parametro in entrata. Per tutti i tipi di parametro, fornire un nome e una descrizione facoltativa e impostare un valore predefinito per il parametro definito dall'utente. Impossibile modificare il tipo e non è possibile modificare il nome e la descrizione dopo la creazione del parametro.

Un parametro definito dall'utente può essere riutilizzato all'interno della stessa pipeline per rappresentare il valore configurato per un altro parametro in entrata dello stesso tipo.

  1. Nell'area di creazione di una pipeline, selezionare un operatore task con uno o più parametri in entrata.
  2. Nel pannello Proprietà per il task selezionato, fare clic su Configurazione.
  3. Accanto a Parametri in entrata configurati, esaminare il numero di parametri in entrata configurati e disponibili.
    Ad esempio, 0/4 indica che nell'attività sono disponibili quattro parametri in entrata e che nessuno è stato riconfigurato.
  4. Fare clic su Configura accanto a Parametri in entrata configurati.
  5. Nella pagina Configura parametri in entrata, esaminare i valori di input che è possibile configurare. Nella riga del tipo e del valore di parametro che si desidera aggiungere e assegnare un parametro della pipeline definito dall'utente, fare clic su Configura.
  6. Nella pagina Configura parametro in entrata per <type> visualizzata per il parametro selezionato, selezionare Assegna un parametro.
  7. Selezionare Usa parametri definiti dall'utente, quindi fare clic su Aggiungi parametro per creare un parametro definito dall'utente.
  8. Nel pannello Aggiungi parametro immettere un nome per il parametro nel campo Identificativo.
  9. (Facoltativo) Immettere una descrizione per facilitare l'identificazione dello scopo del parametro definito dall'utente per altri utenti.
  10. Il campo Tipo mostra il tipo del parametro in entrata, che non può essere modificato.
  11. Impostare il valore predefinito per il parametro.
    La modalità di impostazione del valore predefinito dipende dal tipo di parametro in entrata. Ad esempio, per un'entità dati, utilizzare i menu per selezionare un asset dati, una connessione e uno schema, quindi selezionare l'entità.
  12. Per creare il parametro, fare clic su Aggiungi.
    Per impostazione predefinita, il parametro appena creato definito dall'utente viene selezionato nella pagina Configura parametro in entrata per <type>.
  13. Se necessario, ripetere la procedura per aggiungere altri parametri definiti dall'utente dello stesso tipo.

Visualizzazione dei parametri in una pipeline

È possibile visualizzare i parametri di sistema disponibili in una pipeline e i parametri definiti dall'utente creati in una pipeline.

È inoltre possibile utilizzare questa procedura per vedere dove viene utilizzato un parametro in una pipeline.

  1. Nell'area di creazione di una pipeline, fare clic su un'area vuota.
  2. Nel pannello Proprietà per la pipeline, fare clic su Parametri.
  3. Selezionare Definito dall'utente o Definito dal sistema.
  4. Controllare l'elenco.
    La colonna Utilizzato in indica dove viene utilizzato il parametro nella pipeline.

Assegnazione di un parametro in una pipeline

È possibile assegnare parametri e parametri di sistema definiti dall'utente esistenti ai parametri in entrata degli operatori di task in una pipeline.

  1. Nell'area di creazione di una pipeline, selezionare un operatore task con uno o più parametri in entrata.
  2. Nel pannello Proprietà per il task selezionato, fare clic su Configurazione.
  3. Accanto a Parametri in entrata configurati, esaminare il numero di parametri in entrata configurati e disponibili.
    Ad esempio, 0/4 indica che nell'attività sono disponibili quattro parametri in entrata e che nessuno è stato riconfigurato.
  4. Fare clic su Configura accanto a Parametri in entrata configurati.
  5. Nella pagina Configura parametri in entrata, esaminare i valori di input che è possibile configurare. Nella riga del tipo e del valore di parametro che si desidera assegnare a un parametro definito dall'utente o di sistema, fare clic su Configura.
  6. Nella pagina Configura parametro in entrata per <type> visualizzata per il parametro selezionato, selezionare Assegna un parametro.
  7. Selezionare Usa parametri definiti dall'utente o Usa parametri di sistema.
  8. Selezionare un parametro esistente dall'elenco dei parametri definiti dall'utente o di sistema, quindi fare clic su Fine.

    Solo i parametri dello stesso tipo del parametro in entrata sono disponibili per la selezione. Se non è disponibile alcun elemento, fare clic su Annulla.

    Per un parametro definito dall'utente, è inoltre possibile fare clic su Aggiungi per creare un parametro, quindi selezionarlo. Vedere Aggiunta di un parametro in una pipeline.

Modifica del valore predefinito di un parametro definito dall'utente

In fase di progettazione della pipeline, è possibile modificare rapidamente il valore predefinito di un parametro definito dall'utente assegnato.

  1. Nell'area di creazione di una pipeline, selezionare Parametri dal menu Visualizza nella barra degli strumenti dello sfondo.
  2. Nel pannello Parametri fare clic sulla scheda Config.
  3. Rivedere i parametri elencati per nome.

    È possibile cercare l'elenco immettendo il nome completo di un parametro.

  4. Nella riga del valore del parametro che si desidera modificare, selezionare Modifica dal menu Azioni (Menu Azioni).
    I tipi di dati dei parametri che è possibile modificare sono NUMERIC, VARCHAR, DATE, DECIMAL, DOUBLE, FLOAT, INTEGER, TIMESTAMP, TINYINT, BOOLEAN, LONG e STRING.

Annullamento dell'assegnazione di un parametro in una pipeline

L'annullamento dell'assegnazione di un parametro rimuove solo il valore riconfigurato del parametro in entrata. Non elimina il parametro in entrata dal task o non elimina il parametro definito dall'utente.

  1. Nell'area di creazione di una pipeline, selezionare un operatore task con uno o più parametri in entrata.
  2. Nel pannello Proprietà per il task selezionato, fare clic su Configurazione.
  3. Accanto a Parametri in entrata configurati, esaminare il numero di parametri in entrata configurati e disponibili.
    Ad esempio, 2/4 indica che nell'attività sono disponibili quattro parametri in entrata e due sono stati riconfigurati.
  4. Fare clic su Configura accanto a Parametri in entrata configurati.
  5. Nella pagina Configura parametri in entrata, esaminare gli input configurati.
    Un input ha un valore predefinito. Se il parametro in entrata viene riconfigurato, l'input dispone di un valore configurato. Un valore configurato può essere un nome di parametro definito dall'utente con il valore riconfigurato mostrato tra parentesi.
  6. Per annullare l'assegnazione di un parametro in entrata, fare clic su Cancella.

Eliminazione di un parametro in una pipeline

È possibile eliminare i parametri della pipeline definiti dall'utente non più necessari in una pipeline.

Impossibile eliminare i parametri di sistema in una pipeline.

  1. Nell'area di creazione di una pipeline, selezionare Parametri dal menu Visualizza nella barra degli strumenti dello sfondo.
    Nella scheda Visualizza del pannello Parametri vengono visualizzati i parametri definiti dall'utente creati in questa pipeline. Se in un task viene utilizzato un parametro, il collegamento Utilizzato in mostra il nome del task.
  2. Nel pannello Parametri, selezionare Config.
  3. Selezionare uno o più parametri da eliminare, quindi fare clic su Elimina.
    Nota

    Quando si elimina un parametro definito dall'utente in una pipeline, tutti i valori configurati negli operatori task associati a questo parametro nella pipeline vengono rimossi. Per riconfigurare un valore di input, vedere Configurazione dei parametri in entrata per i task.