Oracle Cloud Infrastructure-Dokumentation

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. Je nachdem, ob Sie einen Job für eine einzelne verwaltete Datenbank oder eine Datenbankgruppen erstellen möchten, wechseln 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.

Themen:

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.
  • Wenn ein Oracle Cloud Infrastructure Management Agent zum Konfigurieren des Netzwerkzugriffs auf die Datenbank verwendet wird, wird er zur Ausführung des Jobs verwendet.
  • 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. In der Dropdown-Liste Zugangsdatentyp müssen Sie die Option Neue Zugangsdaten auswählen und den Benutzernamen, das Kennwort-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 (der einmal oder mehrmals ausgeführt werden soll) 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 für den Zugriff auf das Secret erteilt, und fügen Sie sie 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 befindet. Sie müssen über die erforderlichen Object Storage-Serviceberechtigungen zur Auswahl des Buckets verfügen.

      Wenn beim Erstellen eines geplanten Jobs (der einmal oder mehrmals ausgeführt werden soll) 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 Object Storage-Bucket erteilt, und fügen Sie sie automatisch hinzu. Der IAM-Service erstellt die Policy und wird zu einer Zusammenstellung von Policys namens 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 weder ; noch / an.
    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 Position der Bind-Variablen aus.
      2. Typ: Wählen Sie den Typ aus, der angegeben werden soll, ob die Bind-Variable eine In-Bind- oder Out-Bind-Variable ist.
      3. Datentyp: Wählen Sie den relevanten Datentyp.
      4. Arraytyp: Geben Sie den Arraytyp für die Datentypen Array von Zahlen und Array von Zeichenfolgen ein. Beachten Sie, dass dieses Feld nicht angezeigt wird, wenn Sie im Feld Datentyp die Option Zahl, CLOB auswählen.
      5. Wert: Geben Sie den Wert der Bind-Variablen 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 Variablen und Cursors binden in der Oracle Database SQL Tuning Guide.

    7. Klicken Sie optional auf Erweiterte Optionen anzeigen, um dem Job Freiformtags oder definierte Tags hinzuzufügen. Wenn Sie über die Berechtigungen zum Erstellen eines Jobs verfügen, sind Sie auch zum Hinzufügen von Freiformtags berechtigt. 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 Schaltfläche, um zur Seite Jobdetails zu navigieren und die Details des Jobs, der Jobläufe und -ausführungen, der zugehörigen verwalteten Datenbanken, in denen der Job ausgeführt wird, sowie der zugehörigen tagbezogenen Aufgaben anzuzeigen. 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 ihn 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

Bei Jobausführungen für Oracle Cloud-Datenbanken ist ein Zeitlimit von 50 Minuten festgelegt. Wenn die Jobausführung diesen Grenzwert überschreitet, ist 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 "Fehlgeschlagenen Job"-Alarm 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 ist.

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. Vergewissern Sie sich, dass im linken Fensterbereich unter Geltungsbereich 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 Bearbeiten, Verschieben und Löschen des Jobs ausführen und Tags verwenden. 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.