Documentazione dell'infrastruttura Oracle Cloud

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 ed esecuzioni, è necessario effettuare le operazioni riportate di seguito.

Per passare alla sezione Job, procedere come segue.

  1. Connettersi alla console di Oracle Cloud Infrastructure.
  2. Aprire il menu di navigazione, fare clic su Observability & Management. In Gestione del 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 schede riportate di seguito.

  • 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.
  • Esecuzioni: in questa scheda è possibile monitorare le esecuzioni e le esecuzioni dei job.

Argomenti:

Crea 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 di connettere e interagire i componenti riportati di seguito.

  • Il singolo database gestito o il gruppo di database su cui verrà eseguito il job.
  • Se viene utilizzato un Management Agent di Oracle Cloud Infrastructure per configurare l'accesso di rete al database, viene utilizzato per eseguire il job.
  • Bucket di Oracle Cloud Infrastructure Object Storage in cui vengono memorizzati i risultati dei job per un job di tipo Query.

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

  1. Andare alla pagina Dettagli database gestiti 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 fare clic su Crea job.
  4. Nel pannello Crea job effettuare le operazioni riportate di seguito.
    1. Fornire le seguenti informazioni per il job SQL:
      1. Nome job: immettere un nome univoco per la mansione.
      2. Descrizione job: se necessario, immettere una descrizione per il job.
      3. Tipo SQL: selezionare il tipo SQL. Le opzioni disponibili sono elencate di seguito.
        • Query
        • DML
        • DDL
        • PL*SQL
      4. Scegli 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: selezionare una delle opzioni nell'elenco a discesa, in base all'opzione selezionata per la priorità del job SQL.
    2. Fornire i dettagli della pianificazione per il job selezionando una delle opzioni riportate di seguito.
      • Una volta (immediatamente): selezionare questa opzione per eseguire il job una 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 del gruppo di database.
      • Quando si crea un job pianificato (da eseguire una o più volte), se viene visualizzato il messaggio Un criterio è obbligatorio..., fare clic su Aggiungi criterio per visualizzare il criterio principal risorsa che concede alle risorse del database gestito l'autorizzazione ad 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 devi disporre delle autorizzazioni del servizio di storage degli oggetti necessarie per selezionare il bucket.

      Quando si crea un job pianificato (da eseguire una o più volte), se viene visualizzato il messaggio Un criterio è obbligatorio..., fare clic su Aggiungi criterio per visualizzare il criterio 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 ; o / finali.
    6. Per i job di tipo Query, DML e PL*SQL, aggiungere facoltativamente le bind variable nella sezione Associa variabili. Se le bind variable vengono utilizzate come segnaposto da sostituire con valori validi affinché l'esecuzione dell'istruzione riesca, 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 di tipo 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. Si noti che 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 delle 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 è 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à stato eseguito.

È 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 sui quali viene eseguito il job ed eseguire task correlati alle tag. Per ulteriori informazioni, vedere Monitorare le esecuzioni ed esecuzioni dei job.
  • Duplica job: fare clic per duplicare il job.
  • Modifica job: fare clic per modificare i dettagli dei job ripetuti pianificati con 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 Esecuzioni della sezione Job è possibile visualizzare le esecuzioni e le esecuzioni dei job associati. 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 dei 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.

Ecco un esempio di query che puoi utilizzare per creare un allarme "failed job":

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 viene menzionato nella query. Analogamente, è possibile utilizzare le dimensioni riportate di seguito.

  • managedDbGroupId: per ricevere una notifica dei job non riusciti per tutti i database gestiti in un gruppo di database.
  • jobId: per essere avvisati se un determinato job non riesce.

Per ulteriori informazioni sulla creazione di un allarme, vedere Creazione di un allarme di base.

Monitora esecuzioni ed esecuzioni 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 ciascuno dei database gestiti associati al job e l'esecuzione di un job è la somma delle esecuzioni di un job specifico eseguite 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 sotto 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 fare clic 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 sui quali viene eseguito il job. In questa pagina è possibile eseguire task quali la modifica, lo spostamento e l'eliminazione del job e l'uso delle tag. Inoltre, è possibile monitorare ogni esecuzione del job e il relativo stato. A tale scopo, procedere come segue.

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

    Il collegamento di esecuzione del job è nel seguente formato:

    <Name of job>_<Name of Managed Database>_YYYY-MM-DD'T'HH:MM:SS.SSS
  2. Nella pagina Dettagli esecuzione job esaminare i dettagli, ad esempio 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 necessario per il completamento dell'intero workflow di esecuzione del job e non solo del 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 del servizio Oracle Cloud Infrastructure Object Storage necessarie. Per ulteriori informazioni, vedere Autorizzazioni aggiuntive richieste per l'uso della diagnostica e della gestione.