Documentazione dell'infrastruttura Oracle Cloud

Configurazione dei parametri in entrata per i task

Questa procedura è applicabile solo ai task in cui sono stati assegnati parametri o nei flussi di dati sottostanti dei task di integrazione.

I parametri assegnati hanno valori predefiniti utilizzati durante la fase di progettazione e il runtime della pipeline.

Se si desidera, è possibile sostituire il valore predefinito di un parametro in entrata in fase di progettazione e runtime. È inoltre possibile sostituire il valore predefinito di un parametro utilizzato all'interno di un'espressione in un parametro in entrata.

Per eseguire l'override di un valore, è possibile impostare direttamente un altro valore in fase di progettazione oppure aggiungere un parametro definito dall'utente della pipeline per il valore da impostare in runtime. Se applicabile, è inoltre possibile assegnare all'input un valore di parametro di sistema o un valore di output di un operatore precedente.

  1. Nell'area di creazione di una pipeline, selezionare il task per il quale si desidera visualizzare o configurare i valori per i 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 in questa attività sono disponibili quattro parametri in entrata, nessuno dei quali è stato riconfigurato.
  4. Fare clic su Configura accanto a Parametri in entrata configurati.
  5. Nella pagina Configura parametri in entrata, esaminare gli input che è possibile riconfigurare.
    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 configurato mostrato tra parentesi.
  6. (Facoltativo) Nella riga del tipo e del valore di parametro che si desidera riconfigurare, fare clic su Configura.
    Se il parametro in entrata è già stato riconfigurato, fare clic su Modifica per modificare il valore configurato oppure fare clic su Cancella per rimuovere il valore.
  7. Nella pagina Configura parametro in entrata per <type> visualizzata per il parametro selezionato, eseguire una delle opzioni di configurazione di input, quindi fare clic su Fine per tornare alla pagina precedente.

    Tenere presente quanto riportato di seguito durante la configurazione dei parametri in entrata.

    • Se un task è configurato per l'esecuzione nel servizio OCI Data Flow, utilizzare il formato seguente se si modificano i valori dei parametri predefiniti per OCI_DF_LOG_BUCKET e OCI_DF_ARTIFACT_BUCKET: oci://<bucket-name>@<tenancy-name>

    • Se la strategia di estrazione incrementale per un'origine BICC è configurata per utilizzare una data gestita dal parametro di sistema Data Integration SYS.LAST_LOAD_DATE, non è consentito modificare il valore della data durante la fase di progettazione.

    • Se la strategia di estrazione incrementale per un'origine BICC è configurata per utilizzare una data di ultima estrazione con parametri aggiunti, è possibile modificare il valore della data durante la fase di progettazione e di esecuzione.

    • Se un'entità dati di destinazione con parametri è configurata per utilizzare la strategia Unisci, è possibile modificare la selezione della chiave Unisci.

    • Per un asset dati con parametri che richiede una posizione area intermedia: se si seleziona un asset dati per il quale non è specificata una posizione area intermedia predefinita in tale asset dati, Data Integration visualizza una notifica di avvertenza. Quando viene visualizzata la notifica, scegliere una delle seguenti opzioni:
      • Aggiornare l'asset dati aggiungendo una posizione area intermedia predefinita.
      • Scegliere un asset dati diverso con una posizione area intermedia predefinita.

    • Per un task OCI Data Flow con parametri:

      • Con una forma di driver o esecutore parametrizzato, le OCPU e i valori di memoria vengono ignorati se nel parametro è configurata una forma non flessibile. Le OCPU e i valori di memoria vengono utilizzati solo quando si configura una forma flessibile come valore del parametro.

      • Con le OCPU con parametri e i valori di memoria per una forma flessibile, assicurarsi di specificare un valore compreso nell'intervallo di valori accettabile per tale proprietà. I valori accettabili per le OCPU dipendono dalla forma flessibile. I valori accettabili per la memoria dipendono dal valore delle OCPU.

    Opzione di input descrizione;
    Assegna un valore

    Eseguire l'override del valore predefinito per questo parametro specificando direttamente un valore. Il modo in cui si specifica un valore dipende dal tipo di parametro in entrata.

    Ad esempio, immettere un valore in un campo per un tipo numerico, stringa o data, ma utilizzare un menu per selezionare un valore per un parametro di tipo asset dati, connessione, schema ed entità dati. Per un tipo di condizione o espressione, utilizzare l'editor di condizioni o espressioni.
    Output operatore precedente

    Per utilizzare un valore di output di un operatore precedente come input per questo parametro, selezionare un valore dalla lista di output disponibili.

    Solo gli output dello stesso tipo del parametro in entrata sono disponibili per la selezione.

    Ad esempio, se un parametro in entrata è STRING, sono disponibili solo SYS.STATUS e SYS.ERROR_MESSAGE.
    Assegna un parametro

    Specificare un parametro della pipeline per impostare un valore diverso quando viene eseguita la pipeline. È possibile assegnare un parametro definito dall'utente o un parametro di sistema come input del parametro in entrata.

    • Usa parametri definiti dall'utente: selezionare un parametro definito dall'utente esistente dall'elenco degli eventuali parametri disponibili. Solo i parametri dello stesso tipo del parametro in entrata sono disponibili per la selezione.

      Se applicabile, fare clic su Aggiungi parametro per creare un parametro nella pipeline per la selezione. Nel pannello Aggiungi parametro visualizzato, immettere un nome e una descrizione facoltativa per il parametro. Impossibile modificare il tipo di dati, ovvero il tipo del parametro in entrata. La modalità di definizione del resto dei campi per un parametro dipende dal tipo in entrata. Per creare il parametro, fare clic su Aggiungi. Per impostazione predefinita, viene selezionato il parametro definito dall'utente appena aggiunto.

    • Usa parametri di sistema: selezionare un parametro di sistema dall'elenco degli eventuali parametri disponibili generati dal sistema runtime. Solo i parametri di sistema dello stesso tipo del parametro in entrata sono disponibili per la selezione. I parametri di sistema OCID vengono trattati come STRING.

      Ad esempio, se un parametro in entrata è VARCHAR, sono disponibili solo TASK_RUN_NAME, TASK_RUN_KEY, PARENT_TASK_RUN_KEY, TASK_SCHEDULE_TIMEZONE, PIPELINE_NAME e PIPELINE_IDENTIFIER.
  8. Nella pagina Configura parametri in entrata, esaminare il valore predefinito e il valore configurato per il parametro appena riconfigurato.
    Un valore configurato può essere un nome di parametro definito dall'utente con il valore configurato mostrato tra parentesi.
  9. Ripetere i passi 6 e 7 per configurare altri valori di input, in base alle esigenze. È inoltre possibile fare clic su Modifica o Cancella per modificare un valore configurato in precedenza.
  10. Nella pagina Configura parametri in entrata, fare clic su Configura al termine della configurazione dei valori per i parametri in entrata nel task.