Creazione di un task SQL

Un task SQL in Data Integration è associato a una stored procedure in un database.

Il database deve essere associato a un asset dati già creato nell'area di lavoro. Per creare un asset dati, vedere Creazione di un asset dati.

Creare un task SQL in un progetto o in una cartella. Data Integration include un progetto predefinito per iniziare. Per creare un altro progetto o cartella, vedere Progetti e cartelle.

In Data Integration, per impostazione predefinita è possibile eseguire contemporaneamente o in parallelo un task in un determinato momento. Per non consentire esecuzioni di task concorrenti avviate manualmente, selezionare la casella di controllo Disabilita esecuzione simultanea del task quando si crea il task. Quando le esecuzioni simultanee dei task non sono consentite, una richiesta di esecuzione per il task non riesce se è già in corso un'esecuzione del task con stato non finale.

    1. Aprire il progetto o la cartella in cui si desidera creare il task.

      Per la procedura di apertura della pagina dei dettagli di un progetto o di una cartella, vedere Visualizzazione dei dettagli di un progetto o Visualizzazione dei dettagli di una cartella.

    2. Nella pagina dei dettagli del progetto o della cartella, fare clic su Task.
    3. Nella sezione Task, fare clic su Crea task e selezionare SQL.
    4. Nella pagina Crea task SQL, immettere un nome e una descrizione facoltativa.

      L'identificativo è un valore generato dal sistema in base al nome. È possibile modificare il valore, ma dopo aver creato e salvato il task, non è possibile aggiornare l'identificativo.

    5. Selezionare la casella di controllo Disabilita esecuzione simultanea del task se si desidera non consentire esecuzioni concorrenti di questo task.
    6. (Facoltativo) Per Progetto o cartella, fare clic su Seleziona e selezionare un progetto o una cartella diversi in cui salvare il task.
    7. Per salvare l'attività per la prima volta, fare clic su uno dei seguenti pulsanti:
      • Crea: crea e salva il task. È possibile continuare a creare e modificare il task.

      • Crea e chiudi: crea e salva il task, chiude la pagina e torna all'elenco dei task nella pagina dei dettagli del progetto o della cartella.

    8. Salvare periodicamente mentre si lavora facendo clic su uno dei seguenti pulsanti:
      • Salva: esegue il commit delle modifiche dall'ultimo salvataggio. È possibile continuare a modificare dopo il salvataggio.

      • Salva e chiudi: esegue il commit delle modifiche, chiude la pagina e torna all'elenco dei task nella pagina dei dettagli del progetto o della cartella.

      • Salva con nome: esegue il commit delle modifiche (dall'ultimo salvataggio) e le salva in una copia invece di sovrascrivere il task corrente. È possibile fornire un nome per la copia e selezionare un progetto o una cartella diversi per la copia oppure salvare la copia nello stesso progetto o cartella del task esistente.

    9. Nella sezione SQL fare clic su Seleziona e selezionare l'asset dati associato al database in cui viene salvata la stored procedure che si desidera utilizzare.

      Nella pagina Seleziona SQL visualizzata, selezionare i tipi direttamente oppure parametrizzare i tipi di risorsa solo nell'ordine in cui vengono visualizzati i tipi.

      1. Per trovare e selezionare direttamente i tipi di risorsa, fare clic su Seleziona accanto a un tipo quando è disponibile per la selezione.
        • Asset dati: il nome dell'asset dati.

        • Connessione: la connessione da utilizzare per accedere al database associato all'asset dati.

        • Schema: lo schema proprietario della stored procedure.

        • Procedura memorizzata: il nome della stored procedure da utilizzare per questo task SQL.

          Per visualizzare i parametri in una stored procedure prima di selezionare la procedura, effettuare le operazioni riportate di seguito.

          1. Nel pannello Seleziona stored procedure fare clic su Visualizza tutto.
          2. Nel pannello Sfoglia stored procedure, individuare la stored procedure desiderata e selezionare Visualizza parametri dal menu Azioni (Menu Azioni) della stored procedure.
      2. Per assegnare i parametri ai tipi di risorsa:
        1. Fare clic su Assegna parametro accanto a un tipo di risorsa.

        2. Nella pagina Assegna parametro eseguire una delle azioni riportate di seguito.

          • Selezionare un parametro dall'elenco. Nell'elenco per la selezione vengono visualizzati solo i parametri dello stesso tipo di risorsa.

          • Fare clic su Aggiungi parametro per aggiungere un parametro per il tipo di risorsa.

            1. Nel pannello Aggiungi parametro, immettere un identificativo e una descrizione facoltativa.

            2. Impostare il valore predefinito del parametro per il tipo di risorsa.

              Per il tipo di stored procedure, è possibile visualizzare i parametri in una stored procedure prima di selezionare la procedura. Fare clic su Visualizza tutto accanto al menu Procedura memorizzata. Nel pannello Sfoglia stored procedure visualizzato, individuare la stored procedure desiderata e selezionare Visualizza parametri dal menu Azioni (Menu Azioni) della stored procedure.

            3. Fare clic su Aggiungi.

              Il parametro del tipo di risorsa aggiunto viene selezionato automaticamente nella pagina Assegna parametro.

        3. Fare clic su Assegna.
      3. Nella pagina Seleziona SQL fare clic su Fine.

        Viene nuovamente visualizzata la pagina Crea task SQL.

    10. Nella sezione Configura parametri fare clic su Configura per esaminare l'elenco dei parametri e configurarne i valori.

      Il numero di parametri nella stored procedure viene visualizzato accanto a Parametri configurati. È possibile configurare solo i valori dei parametri di input nella stored procedure.

      Il valore configurato di un parametro di input deve corrispondere al tipo di dati definito di tale parametro. Ad esempio, non è possibile fornire un valore STRING per un parametro di input di tipo dati NUMERIC.

      Nella pagina Configura parametri stored procedure configurare un valore di parametro effettuando le operazioni riportate di seguito.

      1. Nella riga del valore del parametro di input che si desidera configurare, fare clic su Configura.
      2. Nel pannello Modifica parametro, immettere un valore per il parametro di input e fare clic su Salva.

        Dopo aver configurato un parametro di input, è possibile modificare o cancellare il valore.

      3. Al termine della configurazione dei parametri di input, fare clic su Configura.
    11. (Facoltativo) Nella sezione Convalida task, fare clic su Convalida per controllare i valori dei parametri configurati.

      Se vengono visualizzati errori o avvertenze, fare clic su View messages. Risolvere eventuali errori prima di pubblicare il task.

      Nota

      L'esecuzione di un task SQL non riesce se i parametri di input del tipo di dati NUMERIC hanno NULL come valori predefiniti configurati. Per evitare errori di esecuzione dei task, modificare un valore NULL in 0 (zero).
    12. Al termine della configurazione del task, fare clic su Crea e chiudi o su Salva e chiudi.
    Pubblicare il task SQL in un'applicazione in Data Integration prima di eseguire il task o pianificarne l'esecuzione. Per informazioni sulla pubblicazione, vedere Pubblicazione in un'applicazione Data Integration.
  • Utilizzare il comando oci data-integration task create-task-from-SQL-task e i parametri necessari per creare un task SQL:

    oci data-integration task create-task-from-sql-task [OPTIONS]

    Per un elenco completo dei flag e delle opzioni variabili per i comandi CLI, vedere Command Line Reference.

  • Eseguire l'operazione CreateTask con il sottotipo di risorsa appropriato per creare un task SQL.