Jobs erstellen und überwachen

Ein Job ist eine Oracle Cloud Infrastructure-Ressource, mit der Sie SQL-Jobs in einer einzelnen verwalteten Datenbank oder in allen verwalteten Datenbanken in einer Datenbankgruppe erstellen und asynchron ausführen können.

Bevor Sie einen Job erstellen und dessen Läufe und Ausführungen überwachen können, müssen Sie folgende Schritte ausführen:

So navigieren Sie zum Abschnitt Jobs:

  1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole an.
  2. Öffnen Sie das Navigationsmenü, und klicken Sie auf Observability and Management. Klicken Sie unter Datenbankmanagement auf Diagnose und Management.
  3. Abhängig davon, ob Sie einen Job für eine einzelne verwaltete Datenbank oder eine Datenbankgruppe erstellen möchten, gehen Sie zu einer der folgenden Seiten:
  4. Klicken Sie im linken Fensterbereich unter Ressourcen auf Jobs.

Im Abschnitt Jobs werden die folgenden Registerkarten angezeigt:

  • Definitionen: Auf dieser Registerkarte können Sie einen Job erstellen und die Jobs anzeigen, die den Status Aktiv aufweisen und innerhalb des im Feld Zeitraum ausgewählten Zeitraums erstellt wurden.
  • Ausführungen: Auf dieser Registerkarte können Sie Jobläufe und -ausführungen überwachen.

Job erstellen

Sie können einen SQL-Job erstellen, um administrative Vorgänge für eine einzelne verwaltete Datenbank oder eine Datenbankgruppe auszuführen.

Mit den bei einer Joberstellung bereitgestellten Informationen können die folgenden Komponenten eine Verbindung herstellen und interagieren:

  • Die einzelne verwaltete Datenbank oder die Datenbankgruppe, für die der Job ausgeführt wird.
  • Bei externen Datenbanken wird der Oracle Cloud Infrastructure Management Agent, der auf einem Host installiert und mit der externen Datenbank verbunden ist, zur Ausführung des Jobs verwendet.
    Hinweis

    Der Management Agent ist für Oracle Cloud-Datenbanken und autonome Datenbanken nicht erforderlich.
  • Der Oracle Cloud Infrastructure Objektspeicher-Bucket, in dem die Jobergebnisse für einen Job vom Typ Abfrage gespeichert werden.

So erstellen Sie einen Job:

  1. Gehen Sie zur Seite Details der verwalteten Datenbank für die verwaltete Datenbank oder zur Seite Details der Datenbankgruppe für die Datenbankgruppe, für die Sie den Job erstellen möchten.
  2. Klicken Sie im linken Fensterbereich unter Ressourcen auf Jobs.
  3. Klicken Sie im Abschnitt Jobs auf die Registerkarte Definitionen und dann auf Job erstellen.
  4. Gehen Sie im Fensterbereich Job erstellen wie folgt vor:
    1. Geben Sie die folgenden Informationen für den SQL-Job an:
      1. Jobname: Geben Sie einen eindeutigen Namen für den Job ein.
      2. Jobbeschreibung: Geben Sie optional eine Beschreibung für den Job ein.
      3. SQL-Typ: Wählen Sie den SQL-Typ aus. Folgende Optionen sind verfügbar:
        • Abfrage
        • DML
        • DDL
        • PL*SQL
      4. Compartment auswählen: Wählen Sie das Compartment aus, in dem Sie den Job erstellen möchten. Das Compartment, in dem sich die verwaltete Datenbank oder Datenbankgruppe befindet, ist standardmäßig ausgewählt. Sie können den Job jedoch in einem anderen Compartment erstellen.
      5. Timeout: Wählen Sie je nach dem Zeitpunkt, zu dem der SQL-Job wahrscheinlich ausgeführt werden soll, eine der Optionen in der Dropdown-Liste aus. Je nach der ausgewählten Option wird der Job priorisiert.
    2. Geben Sie Plandetails für den Job an, indem Sie eine der folgenden Optionen auswählen:
      • Einmal (sofort): Wählen Sie diese Option aus, um den Job einmal (sofort) auszuführen.
      • Einmal (später): Wählen Sie diese Option aus, um den Job einmal (später) auszuführen, und geben Sie die Uhrzeit an, zu der er ausgeführt werden soll.
      • Wiederholt: Wählen Sie diese Option aus, um einen Job mehrmals mit der angegebenen Häufigkeit auszuführen. Wenn Sie ein Enddatum für den geplanten Job angeben möchten, aktivieren Sie das Kontrollkästchen Enddatum definieren.
    3. Wählen Sie eine der verfügbaren Optionen in der Dropdown-Liste Zugangsdatentyp aus, um Datenbankzugangsdaten für die Verbindung zur verwalteten Datenbank anzugeben. Informationen zu Zugangsdatentypen finden Sie unter Diagnose- und Verwaltungsaufgaben mit Zugangsdaten ausführen.
      Hinweis

      • Wenn Sie einen Job für eine Datenbankgruppe erstellen, können Sie keine benannten Zugangsdaten verwenden, und Sie müssen in der Dropdown-Liste Zugangsdatentyp die Option Neue Zugangsdaten auswählen und den Benutzernamen, das Benutzerkennwort-Secret und die Rolle angeben. Außerdem müssen die Datenbankzugangsdaten beim Erstellen eines Jobs für eine Datenbankgruppe für alle Datenbanken in der Datenbankgruppe gelten.
      • Wenn beim Erstellen eines geplanten Jobs (einmal oder mehrmals auszuführen) die Meldung Eine Policy ist erforderlich... angezeigt wird, klicken Sie auf Policy hinzufügen, um die Resource Principal Policy anzuzeigen, die Ressourcen der verwalteten Datenbank die Berechtigung zum Zugriff auf das Secret erteilt, und fügen Sie es automatisch hinzu. Der Oracle Cloud Infrastructure IAM-Service erstellt die Policy und wird einer Sammlung von Policys mit dem Namen DBMgmt_Resource_Policy im IAM-Service hinzugefügt.
    4. Wählen Sie für einen Job vom Typ Abfrage den Objektspeicher-Bucket aus, in dem die Jobergebnisse gespeichert werden. Der Abschnitt Oracle-Objektspeicher für Jobergebnisse mit der Dropdown-Liste Bucket-Name wird nur angezeigt, wenn Sie den Job vom Typ Abfrage ausgewählt haben. Der Object Storage-Bucket kann sich in demselben Compartment wie der Job oder in einem anderen Compartment befinden. Sie müssen über die erforderlichen Object Storage-Serviceberechtigungen zur Auswahl des Bucket verfügen.

      Wenn beim Erstellen eines geplanten Jobs (einmal oder mehrmals auszuführen) die Meldung Eine Policy ist erforderlich... angezeigt wird, klicken Sie auf Policy hinzufügen, um die Resource Principal Policy anzuzeigen, die verwalteten Datenbankressourcen die Berechtigung zum Schreiben der Ergebnisse des geplanten Jobs in einen Objektspeicher-Bucket erteilt, und fügen Sie sie automatisch hinzu. Der IAM-Service erstellt die Policy und wird einer Sammlung von Policys mit dem Namen DBMgmt_Resource_Policy im IAM-Service hinzugefügt.

      Weitere Informationen:

    5. Klicken Sie auf SQL laden, um den SQL-Befehl zu laden, oder geben Sie ihn in das Feld SQL-Befehl ein. Wenn Sie einen SQL-Befehl eingeben, fügen Sie keinen nachgestellten ; oder / hinzu.
    6. Fügen Sie für Jobs vom Typ Abfrage, DML und PL*SQL optional Bind-Variablen im Abschnitt Bind-Variablen hinzu. Wenn Bind-Variablen als Platzhalter verwendet werden, die durch gültige Werte ersetzt werden müssen, damit die Anweisung erfolgreich ausgeführt wird, klicken Sie auf Bind-Variable hinzufügen, und geben Sie die folgenden Informationen an:
      1. Position: Wählen Sie die Bind-Variablenposition aus.
      2. Typ: Wählen Sie den Typ aus, um anzugeben, ob die Bind-Variable eine In-Bind- oder Out-Bind-Variable ist.
      3. Datentyp: Wählen Sie den relevanten Datentyp aus.
      4. Array-Typ: Geben Sie den Array-Typ für die Datentypen Array mit Zahlen und Array mit Zeichenfolgen ein. Beachten Sie, dass dieses Feld nicht angezeigt wird, wenn Sie im Feld Datentyp die Option Zeichenfolge oder CLOB auswählen.
      5. Wert: Geben Sie den Bind-Variablenwert ein.

      Um weitere Bind-Variablenwerte hinzuzufügen, klicken Sie auf Bind-Variable hinzufügen, und geben Sie die erforderlichen Informationen an. Informationen zu Bind-Variablen finden Sie unter Bind-Variablen und Cursor in der Dokumentation Oracle Database SQL Tuning Guide.

    7. Klicken Sie optional auf Erweiterte Optionen anzeigen, um dem Job Freiformtags oder definierte Tags hinzuzufügen. Wenn Sie die erforderlichen Berechtigungen zum Erstellen eines Jobs haben, sind Sie auch berechtigt, Freiformtags hinzuzufügen. Um ein definiertes Tag hinzuzufügen, benötigen Sie Berechtigungen zum Verwenden des Tag-Namespace.

      Weitere Informationen:

    8. Klicken Sie auf Job erstellen.
Der neue Job wird auf der Registerkarte Definitionen im Abschnitt Jobs der verwalteten Datenbank oder Datenbankgruppe aufgeführt. Der Status des Jobs lautet Aktiv, wenn er gerade ausgeführt wird, und Inaktiv, wenn er bereits ausgeführt wurde.

Sie können auf das Symbol Aktionen (Aktionen) für den Job klicken und die folgenden Aufgaben ausführen:

  • Details anzeigen: Klicken Sie auf diese Option, um zur Seite Jobdetails zu navigieren und die Details des Jobs, der Jobläufe und -ausführungen, der zugehörigen verwalteten Datenbanken, für die der Job ausgeführt wird, anzuzeigen sowie tagbezogene Aufgaben auszuführen. Weitere Informationen finden Sie unter Jobläufe und -ausführungen überwachen.
  • Job klonen: Klicken Sie auf diese Option, um den Job zu klonen.
  • Job bearbeiten: Klicken Sie auf diese Option, um die Details zu geplanten sich wiederholenden Jobs im Status Aktiv zu bearbeiten.
  • Job verschieben: Klicken Sie auf diese Option, um den Job aus dem aktuellen Compartment in ein anderes zu verschieben.
  • Job löschen: Klicken Sie auf diese Option, um den Job zu löschen.

Auf der Registerkarte Ausführungen im Abschnitt Jobs können Sie die zugehörigen Jobläufe und -ausführungen anzeigen. Die Jobläufe für den im Feld Zeitraum ausgewählten Zeitraum sowie ein Überblick über den Status der Jobausführungen werden angezeigt: Erfolgreich, Nicht erfolgreich und In Bearbeitung. Sie können auf die Ausführungsstatuslinks klicken, um die Ausführungen nach Status zu filtern.

Hinweis

Jobausführungen für Oracle Cloud-Datenbanken haben ein Zeitlimit von 50 Minuten. Wenn die Jobausführung diesen Grenzwert überschreitet, verläuft sie nicht erfolgreich, und es wird ein Fehler angezeigt.

Sie können Metrikabfragen erstellen und Alarme mit der Metrik dbmgmtJobExecutionsCount im Oracle Cloud Infrastructure Monitoring-Service für den Jobausführungsstatus erstellen. Weitere Informationen finden Sie unter Diagnose- und Managementmetriken für Oracle-Datenbanken.

Im Folgenden finden Sie ein Beispiel für eine Abfrage, mit der Sie einen Alarm "fehlgeschlagener Job" erstellen können:

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

In der Abfrage wird die Dimension managedDbId verwendet, um Sie über nicht erfolgreiche Jobs für die verwaltete Datenbank zu benachrichtigen, deren OCID in der Abfrage angegeben ist. Ebenso können Sie die folgenden Dimensionen verwenden:

  • managedDbGroupId: Benachrichtigung über nicht erfolgreiche Jobs für alle verwalteten Datenbanken in einer Datenbankgruppe.
  • jobId: Wird benachrichtigt, wenn ein bestimmter Job nicht erfolgreich verläuft.

Weitere Informationen zum Erstellen eines Alarms finden Sie unter Grundlegenden Alarm erstellen.

Jobläufe und -ausführungen überwachen

Sie können die Läufe und Ausführungen eines weitergeleiteten Jobs für eine verwaltete Datenbank oder Datenbankgruppe überwachen. Für jede der verwalteten Datenbanken, die mit dem Job verknüpft sind, wird eine Jobausführung erstellt. Ein Joblauf ist die Summe der Ausführungen eines bestimmten Jobs, die an einem geplanten Datum ausgeführt wurden.

So zeigen Sie die Jobläufe und -ausführungen an:

  1. Gehen Sie zur Seite Details der verwalteten Datenbank oder Details der Datenbankgruppe.
  2. Stellen Sie sicher, dass im linken Fensterbereich unter Umfang das Compartment ausgewählt ist, in dem der Job erstellt wurde.
  3. Klicken Sie im linken Fensterbereich unter Ressourcen auf Jobs.
  4. Klicken Sie im Abschnitt Jobs auf die Registerkarte Definitionen und dann auf den Namen des Jobs. Alternativ können Sie auch auf das entsprechende Symbol Aktionen (Aktionen) und dann auf Details anzeigen klicken.

Die Seite Jobdetails wird angezeigt, die Details zum Job, zu den Jobläufen und -ausführungen sowie den zugehörigen verwalteten Datenbanken enthält, für die der Job ausgeführt wird. Auf dieser Seite können Sie Aufgaben wie das Bearbeiten, Verschieben und Löschen des Jobs und das Verwenden von Tags ausführen. Außerdem können Sie die einzelnen Jobausführungen und den jeweiligen Status überwachen. Gehen Sie dazu wie folgt vor:

  1. Blenden Sie im Abschnitt Jobläufe einen Joblauf ein, und klicken Sie auf einen Jobausführungslink.

    Der Jobausführungslink hat das folgende Format:

    <Name of job>_<Name of Managed Database>_YYYY-MM-DD'T'HH:MM:SS.SSS
  2. Prüfen Sie auf der Seite Jobausführungsdetails die Details, beispielsweise den Jobausführungsstatus, die mit der Ausführung verknüpfte SQL und die Dauer der Jobausführung. Beachten Sie, dass die Dauer die Zeit ist, die für den Abschluss des gesamten Jobausführungsworkflows benötigt wird, und nicht nur die Zeit, die SQL für die Ausführung in der Datenbank benötigt.
  3. Klicken Sie bei einem Job des Typs Abfrage auf Ausgabe herunterladen, um die Jobausführungsausgabe in eine .txt-Datei herunterzuladen.
    Hinweis

    Die Option Ausgabe herunterladen ist nur für Jobs vom Typ Abfrage verfügbar. Sie können diese Option nur verwenden, wenn Sie über die erforderlichen Oracle Cloud Infrastructure Object Storage-Serviceberechtigungen verfügen. Weitere Informationen finden Sie unter Erforderliche zusätzliche Berechtigungen zum Verwenden von Diagnose und Management.