Creare e monitorare i job

Un job è una risorsa Oracle Cloud Infrastructure che consente di creare ed eseguire in modo asincrono job SQL su un singolo database gestito o su tutti i database gestiti in un gruppo di database.

Prima di creare un job e monitorarne le esecuzioni e le esecuzioni, è necessario:

Per visualizzare la sezione Job, procedere come segue.

  1. Accedi alla console di Oracle Cloud Infrastructure.
  2. Aprire il menu di navigazione e fare clic su Osservabilità e gestione. In Gestione database, fare clic su Diagnostica e gestione.
  3. A seconda che si desideri creare un job per un singolo database gestito o un gruppo di database, andare a una delle pagine riportate di seguito.
  4. Nel riquadro sinistro, in Risorse, fare clic su Job.

Nella sezione Job vengono visualizzate le seguenti schede:

  • Definizioni: in questa scheda è possibile creare un job e visualizzare i job che si trovano nello stato Attivo e che sono stati creati nel periodo di tempo selezionato nel campo Periodo di tempo.
  • Esegui: in questa scheda è possibile monitorare le esecuzioni e le esecuzioni dei job.

Creare un job

È possibile creare un job SQL per eseguire operazioni amministrative su un singolo database gestito o su un gruppo di database.

Le informazioni fornite durante la creazione di un job consentono ai seguenti componenti di connettersi e interagire:

  • Il singolo database gestito o il gruppo di database su cui verrà eseguito il job.
  • Per i database esterni, per eseguire il job viene utilizzato il Management Agent di Oracle Cloud Infrastructure installato su un host e con connessione al database esterno.
    Nota

    Il Management Agent non è richiesto per i database Oracle Cloud e per i database autonomi.
  • Bucket di Oracle Cloud Infrastructure Object Storage in cui vengono memorizzati i risultati del job per un job di tipo Query.

Per creare un job, effettuare le operazioni riportate di seguito.

  1. Andare alla pagina Dettagli database gestito del database gestito o alla pagina Dettagli gruppo di database del gruppo di database per il quale si desidera creare il job.
  2. Nel riquadro sinistro, in Risorse, fare clic su Job.
  3. Nella sezione Job, fare clic sulla scheda Definizioni, quindi su Crea job.
  4. Nel pannello Crea job:
    1. Fornire le seguenti informazioni per il job SQL:
      1. Nome job: immettere un nome univoco per il job.
      2. Descrizione job: è possibile immettere la descrizione del job.
      3. Tipo SQL: selezionare il tipo SQL. Le opzioni disponibili sono elencate di seguito.
        • Query
        • DML
        • DDL
        • PL*SQL
      4. Scegliere il compartimento: selezionare il compartimento in cui si desidera creare il job. Il compartimento in cui risiede il database gestito o il gruppo di database è selezionato per impostazione predefinita, tuttavia è possibile scegliere di creare il job in un compartimento diverso.
      5. Timeout: a seconda dell'ora prevista per il job SQL, selezionare una delle opzioni nell'elenco a discesa e, in base all'opzione selezionata, assegnare la priorità al job.
    2. Fornire i dettagli di pianificazione per il job selezionando una delle seguenti opzioni:
      • Una volta (immediatamente): selezionare questa opzione per eseguire il job una sola volta (immediatamente).
      • Una volta (in seguito): selezionare questa opzione per eseguire il job una volta (in seguito) e specificare l'ora di esecuzione.
      • Ripetizione: selezionare questa opzione per eseguire un job più volte alla frequenza specificata. Se si desidera specificare una data di fine per il job pianificato, selezionare la casella di controllo Definisci data di fine.
    3. Selezionare una delle opzioni disponibili nell'elenco a discesa Tipo di credenziale per specificare le credenziali del database per la connessione al database gestito. Per informazioni sui tipi di credenziali, vedere Usa credenziali per eseguire task di diagnostica e gestione.
      Nota

      • Se si crea un job per un gruppo di database, non è possibile utilizzare le credenziali denominate e sarà necessario selezionare l'opzione Nuova credenziale nell'elenco a discesa Tipo di credenziale e specificare il nome utente, il segreto password utente e il ruolo. Inoltre, quando si crea un job per un gruppo di database, le credenziali del database devono essere applicate a tutti i database nel gruppo di database.
      • Quando si crea un job pianificato (da eseguire una o più volte), se viene visualizzato il messaggio È richiesto un criterio..., fare clic su Aggiungi criterio per visualizzare il criterio del principal risorsa che concede alle risorse del database gestito l'autorizzazione per accedere al segreto e aggiungerlo automaticamente. Il servizio IAM di Oracle Cloud Infrastructure crea il criterio e viene aggiunto a una raccolta di criteri denominata DBMgmt_Resource_Policy nel servizio IAM.
    4. Per un job di tipo Query, selezionare il bucket di storage degli oggetti in cui verranno memorizzati i risultati del job. La sezione Storage degli oggetti Oracle per i risultati dei job con l'elenco a discesa Nome bucket viene visualizzata solo se è stato selezionato il job di tipo Query. Il bucket di storage degli oggetti può trovarsi nello stesso compartimento del job o in un altro compartimento e per selezionare il bucket è necessario disporre delle autorizzazioni del servizio di storage degli oggetti necessarie.

      Quando si crea un job pianificato (da eseguire una o più volte), se viene visualizzato il messaggio È richiesto un criterio..., fare clic su Aggiungi criterio per visualizzare il criterio del principal risorsa che concede alle risorse del database gestito l'autorizzazione a scrivere i risultati del job pianificato in un bucket di storage degli oggetti e aggiungerlo automaticamente. Il servizio IAM crea il criterio e viene aggiunto a una raccolta di criteri denominata DBMgmt_Resource_Policy nel servizio IAM.

      Per informazioni su:

    5. Fare clic su Carica SQL per caricare il comando SQL o immetterlo nel campo Comando SQL. Se si sta immettendo un comando SQL, non aggiungere un ; o / finale.
    6. Per i job di tipo Query, DML e PL*SQL, è possibile aggiungere le bind variable nella sezione Bind variable. Se le bind variable vengono utilizzate come segnaposto che devono essere sostituite con valori validi per la corretta esecuzione dell'istruzione, fare clic su Aggiungi bind variable e specificare le informazioni riportate di seguito.
      1. Posizione: selezionare la posizione della bind variable.
      2. Tipo: selezionare il tipo per specificare se la bind variable è una variabile in-bind o out-bind.
      3. Tipo di dati: selezionare il tipo di dati pertinente.
      4. Tipo di array: immettere il tipo di array per i tipi di dati Array di numeri e Array di stringhe. Questo campo non viene visualizzato se si seleziona Numero, Stringa o CLOB nel campo Tipo di dati.
      5. Valore: immettere il valore della bind variable.

      Per aggiungere altri valori di bind variable, fare clic su Aggiungi bind variable e fornire le informazioni necessarie. Per informazioni sulle bind variable, vedere Bind Variables and Cursors in Oracle Database SQL Tuning Guide.

    7. Facoltativamente, fare clic su Mostra opzioni avanzate per aggiungere tag in formato libero o definite al job. Se si dispone delle autorizzazioni necessarie per creare un job, si dispone anche delle autorizzazioni per aggiungere tag in formato libero. Per aggiungere una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag.

      Per informazioni su:

    8. Fare clic su Crea job.
Il nuovo job viene elencato nella scheda Definizioni della sezione Job del database gestito o del gruppo di database. Lo stato del job è Attivo se è in esecuzione e Inattivo se è già in esecuzione.

È possibile fare clic sull'icona Azioni (Azioni) per il job ed eseguire i task riportati di seguito.

  • Visualizza dettagli: fare clic per andare alla pagina Dettagli job e visualizzare i dettagli del job, delle esecuzioni e delle esecuzioni dei job, dei database gestiti associati su cui viene eseguito il job ed eseguire i task correlati alle tag. Per ulteriori informazioni, vedere Monitorare le esecuzioni e le esecuzioni dei job.
  • Copia job: fare clic per duplicare il job.
  • Modifica job: fare clic per modificare i dettagli dei job ripetuti pianificati in stato Attivo.
  • Sposta job: fare clic per spostare il job dal compartimento corrente a un altro compartimento.
  • Elimina job: fare clic per eliminare il job.

Nella scheda Esecuzione della sezione Job è possibile visualizzare le esecuzioni e le esecuzioni dei job associate. Le esecuzioni dei job per il periodo di tempo selezionato nel campo Periodo di tempo vengono visualizzate insieme a una panoramica dello stato delle esecuzioni dei job: Riuscito, Non riuscito e In corso. È possibile fare clic sui collegamenti dello stato di esecuzione per filtrare le esecuzioni in base allo stato.

Nota

Le esecuzioni di job per i database Oracle Cloud hanno un limite di tempo di 50 minuti. Se l'esecuzione del job supera questo limite, non riesce e viene visualizzato un errore.

Puoi creare query sulle metriche e creare allarmi sullo stato di esecuzione dei job nel servizio Oracle Cloud Infrastructure Monitoring utilizzando la metrica dbmgmtJobExecutionsCount. Per ulteriori informazioni, vedere Diagnostica e metriche di gestione per i database Oracle.

Di seguito è riportato un esempio di query che è possibile utilizzare per creare un allarme "job non riuscito":

dbmgmtJobExecutionsCount[1m]{managedDbId = "<OCID of the Oracle Database>", status = "Failed"}.mean()

Nella query, la dimensione managedDbId viene utilizzata per notificare eventuali job non riusciti per il database gestito il cui OCID è menzionato nella query. Analogamente, è possibile utilizzare le seguenti dimensioni:

  • managedDbGroupId: notifica dei job non riusciti per tutti i database gestiti in un gruppo di database.
  • jobId: da notificare se un determinato job non riesce.

Per ulteriori informazioni su come creare un allarme, vedere Creazione di un allarme di base.

Monitoraggio delle esecuzioni e delle esecuzioni dei job

È possibile monitorare le esecuzioni e le esecuzioni di un job sottomesso per un database gestito o un gruppo di database. Viene creata un'esecuzione di job per ognuno dei database gestiti associati al job e un'esecuzione di job è la somma delle esecuzioni di un job specifico eseguito in una data pianificata.

Per visualizzare le esecuzioni e le esecuzioni dei job:

  1. Andare alla pagina Dettagli database gestiti o Dettagli gruppo di database.
  2. Nel riquadro sinistro in Ambito, assicurarsi che sia selezionato il compartimento in cui è stato creato il job.
  3. Nel riquadro sinistro, in Risorse, fare clic su Job.
  4. Nella sezione Job, fare clic sulla scheda Definizioni, quindi sul nome del job. In alternativa, è anche possibile fare clic sull'icona Azioni corrispondente (Azioni) e fare clic su Visualizza dettagli.

Viene visualizzata la pagina Dettagli job che fornisce i dettagli del job, delle esecuzioni e delle esecuzioni dei job e dei database gestiti associati in cui viene eseguito il job. In questa pagina è possibile eseguire task quali la modifica, lo spostamento e l'eliminazione del job e l'utilizzo di tag. Inoltre, è possibile monitorare ogni esecuzione del job e il relativo stato. A questo scopo:

  1. Nella sezione Esecuzione job espandere l'esecuzione di un job e fare clic su un collegamento di esecuzione job.

    Il formato del collegamento di esecuzione del job è il seguente:

    <Name of job>_<Name of Managed Database>_YYYY-MM-DD'T'HH:MM:SS.SSS
  2. Nella pagina Dettagli esecuzione job, esaminare i dettagli quali lo stato di esecuzione del job, l'istruzione SQL associata all'esecuzione e la durata dell'esecuzione del job. Si noti che la durata è il tempo impiegato per il completamento dell'intero workflow di esecuzione del job e non solo il tempo impiegato per l'esecuzione dell'istruzione SQL nel database.
  3. Per un job di tipo Query, fare clic su Scarica output per scaricare l'output di esecuzione del job in un file .txt.
    Nota

    L'opzione Scarica output è disponibile solo per i job di tipo Query ed è possibile utilizzare questa opzione solo se si dispone delle autorizzazioni necessarie per il servizio Oracle Cloud Infrastructure Object Storage. Per ulteriori informazioni, vedere Additional Permissions Required to Use Diagnostics & Management.