DBMS_DATA_TOOLS_JOBS-Paketreferenz
Dieses Kapitel enthält Informationen zu den Packages, die Sie mit der Funktion "Jobs" in Data Studio verwenden. Das Thema "Zusammenfassung der Unterprogramme DBMS_DATA_TOOLS_JOBS
" behandelt auch die im Package DBMS_DATA_TOOLS_JOBS
enthaltenen Prozeduren.
- Zusammenfassung der DBMS_DATA_TOOLS_JOB-Unterprogramme
Das PackageDBMS_DATA_TOOLS_JOB
enthält eine Sammlung von Planungsfunktionen und -prozeduren, die Sie mit dem Feature "Jobs" in der Data Studio-Toolsuite verwenden.
Übergeordnetes Thema: Funktion "Jobs"
Zusammenfassung der DBMS_DATA_TOOLS_JOB-Unterprogramme
Das Package DBMS_DATA_TOOLS_JOB
enthält eine Sammlung von Planungsfunktionen und -prozeduren, die Sie mit dem Feature "Jobs" in der Data Studio-Toolsuite verwenden.
DBMS_DATA_TOOLS_JOB Packageunterprogramme
In der folgenden Tabelle werden die Unterprogramme DBMS_DATA_TOOLS_JOB
aufgeführt und kurz beschrieben.
Tabelle 3-11: DBMS_DATA_TOOLS_JOB Namen und Beschreibung der DBMS_DATA_TOOLS_JOB-Unterprogramme
Unterprogramm | Beschreibung |
---|---|
Prozedur "Job erstellen" | Mit diesem Verfahren wird ein neuer Job erstellt. |
Prozedur "Job löschen" | Löscht den Job aus dem Scheduler. |
Prozedur "Job umbenennen" | Benennt den Job mit dem gewünschten Namen um. |
Prozedur "Job aktualisieren" | Ändert die Attribute eines vorhandenen Jobs. |
Prozedur ausführen | Führt einen Job unabhängig von dem von Ihnen definierten Zeitplan sofort aus. |
Prozedur "Job stoppen" | Stoppt einen ausgeführten Job. Dadurch wird ein Job ordnungsgemäß beendet, und falls erforderlich, wird er zwangsweise gestoppt. |
Prozedur CREATE_JOB
Diese Prozedur erstellt einen einzelnen Job. Wenn Sie den Job als aktiviert erstellen, indem Sie das aktivierte Attribut auf TRUE setzen, führt der Scheduler den Job automatisch gemäß seinem Zeitplan aus. Wenn Sie den Job erstellen, der deaktiviert ist, wird er erst ausgeführt, nachdem Sie ihn mit dem Feature "Job aktivieren" aktiviert haben.
Syntax
dbms_data_tools_job.create_job(
job_name in varchar2,
description in varchar2,
steps in clob,
owner in varchar2 default null,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
repeat_interval IN VARCHAR2 DEFAULT NULL,
end_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
job_class IN VARCHAR2 DEFAULT NULL,
enabled IN BOOLEAN DEFAULT FALSE,
reporting in clob default null);
CREATE_JOB Prozedurparameter
Tabelle 3-12: Prozedurparameter CREATE_JOB
Parameter | Beschreibung |
---|---|
Jobname | Der Name, der dem Job zugewiesen werden soll. Wenn job_name nicht angegeben ist, wird ein Fehler generiert.
|
Beschreibung | Dies bezieht sich auf zusätzliche Informationen, die für Tätigkeiten festgelegt werden. |
Schritte | Dies bezieht sich auf verschiedene Aufgaben, die das Data Studio-Tool aus einem Job ausführt.
Schritte sind ein JSON-Array. Jedes Array-Element ist ein JSON-Objekt. Hier sind die JSON-Elemente, die für alle Objekte gelten:
Jeder Objekttyp hat je nach Typ einige zusätzliche Elemente. data_load :
smart_table :
procedure :
|
Verantwortlicher |
Es ist das Schema, in dem der Job erstellt wird. Wenn Sie einen Job erstellen, ohne ein Schema anzugeben, ist der Eigentümer der Benutzer, der die Prozedur |
Startdatum |
Dieses Attribut gibt das erste Datum und die erste Uhrzeit für den Start dieses Jobs an. Wenn Bei Wiederholungsjobs, die das Wiederholungsintervall mit einem Kalenderausdruck angeben, wird Der Scheduler kann nicht garantieren, dass ein Job zu einer genauen Zeit ausgeführt wird, da das System möglicherweise überlastet ist und daher keine Ressourcen verfügbar sind. |
Wiederholungsintervall |
Dieses Attribut gibt an, wie oft das Fenster wiederholt wird. Sie wird mit der Scheduler-Kalendar-Syntax ausgedrückt. Weitere Informationen finden Sie unter "Calendaring-Syntax". Ein PL/SQL-Ausdruck kann nicht verwendet werden, um das Wiederholungsintervall für ein Fenster anzugeben. Der angegebene Ausdruck wird ausgewertet, um zu bestimmen, wann das nächste Mal das Fenster geöffnet wird. Wenn kein |
Enddatum |
Dieses Attribut gibt das Datum und die Uhrzeit an, nach dem der Job abläuft und nicht mehr ausgeführt wird. Der Wert für end_date angegeben ist, wird der Job dauerhaft wiederholt, es sei denn, Sie stop job .
|
Tätigkeitsklasse | Die Klasse, mit der dieser Job verknüpft ist. |
Aktiviert | Dieses Attribut gibt an, ob die Erstellung des Jobs aktiviert ist. Die möglichen Einstellungen sind TRUE oder FALSE . Standardmäßig ist dieses Attribut auf FALSE gesetzt. Daher wird der Job als deaktiviert erstellt. Ein deaktivierter Job bedeutet, dass die Metadaten zum Job erfasst wurden und der Job als Datenbankobjekt vorhanden ist. Der Scheduler ignoriert den Job jedoch, und der Jobkoordinator wählt ihn nicht zur Verarbeitung aus. Damit der Jobkoordinator den Job verarbeiten kann, muss der Job aktiviert sein. Sie können einen Job aktivieren, indem Sie das Symbol Enable Job auswählen.
|
Berichte | Dieses Attribut gibt Jobausführungsdetails über die Schaltfläche "Bericht" im Feature "Jobs" an.
Dies ist ein JSON-Objekt, das dem Reportingargument für
dbms_live_feed ähnelt. Sie kann folgende Elemente enthalten:
Jedes dieser vier Elemente kann ein Array von E-Mail-Adressen im Element |
Prozedur DELETE_JOB
Mit dieser Prozedur wird ein Job gelöscht.
Syntax
dbms_data_tools_job.delete_job(job_name in varchar2, owner in varchar2 default null);
DELETE_JOB Prozedurparameter
Tabelle 3-13: Prozedurparameter DELETE_JOB
Parameter | Beschreibung |
---|---|
Jobname | Der Name, der dem Job zugewiesen werden soll. Wenn job_name nicht angegeben ist, wird ein Fehler generiert.
|
Verantwortlicher |
Es ist das Schema, in dem der Job erstellt wird. Wenn Sie einen Job erstellen, ohne ein Schema anzugeben, ist der Eigentümer der Benutzer, der die Prozedur |
Prozedur RENAME_JOB
Mit dieser Prozedur wird ein Job umbenannt.
Syntax
dbms_data_tools_job.rename_job(old_job_name in varchar2,
new_job_name in varchar2,
owner in varchar2 default null);
RENAME_JOB Prozedurparameter
Tabelle 3-14: Prozedurparameter RENAME_JOB
Parameter | Beschreibung |
---|---|
Alter Jobname | Der Name des vorhandenen Jobs. |
Neuer Jobname |
Der Name des neuen Jobs. |
Verantwortlicher |
Es ist das Schema, in dem der Job erstellt wird. |
Prozedur UPDATE_JOB
Mit dieser Prozedur werden alle vorhandenen Jobattribute aktualisiert.
Syntax
dbms_data_tools_job.update_job(job_name in varchar2,
owner in varchar2 default null,
description in varchar2 default null,
steps in clob default null,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
repeat_interval IN VARCHAR2 DEFAULT NULL,
end_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL,
job_class IN VARCHAR2 DEFAULT NULL,
enabled IN BOOLEAN DEFAULT NULL,
reporting in clob default null);
UPDATE_JOB Prozedurparameter
Tabelle 3-15: Prozedurparameter UPDATE_JOB
Parameter | Beschreibung |
---|---|
Jobname | Der Name des zu aktualisierenden Jobs. |
Verantwortlicher |
Es ist das Schema, in dem der Job aktualisiert werden soll. |
Beschreibung | Die aktualisierte Beschreibung, die angewendet werden soll. |
Schritte | Die neuen Schritte zum Aktualisieren. |
Startdatum | Das neue Startdatum. |
Wiederholungsintervall | Das aktualisierte Wiederholungsintervall. |
Enddatum | Das aktualisierte Enddatum. |
Tätigkeitsklasse | Die aktualisierte Jobklasse. |
Aktiviert | Er kann aktiviert oder deaktiviert werden. |
Berichte | Das aktualisierte Reportingattribut. |
Prozedur ausführen
Diese Prozedur führt einen Job sofort aus.
Wenn ein Job aktiviert ist, wird er vom Scheduler automatisch ausgeführt. Es ist nicht erforderlich, RUN_JOB
aufzurufen, um einen Job gemäß seinem Zeitplan auszuführen. Verwenden Sie RUN_JOB
, um einen Job außerhalb des normalen Ausführungsplans auszuführen.
Syntax
dbms_data_tools_job.run(job_name in varchar2,
owner in varchar2 default null,
use_current_session in number default null,
options in clob default null);
RUN-Prozedurparameter
Tabelle 3-16: RUN-Prozedurparameter
Parameter | Beschreibung |
---|---|
Jobname |
Ein Jobname oder eine durch Komma getrennte Liste von Einträgen, wobei jeder der Name eines vorhandenen Jobs ist, dem optional ein Schemaname und ein Punkttrennzeichen vorangestellt sind. Wenn Sie einen Job mit mehreren Zielen angeben, wird der Job auf allen Zielen ausgeführt. In diesem Fall muss das Argument |
Verantwortlicher |
Es ist das Schema, in dem der Job ausgeführt wird. |
Aktuelle Sitzung verwenden |
Gibt an, ob der Joblauf in derselben Session ausgeführt werden soll, in der die Prozedur aufgerufen wurde. Wenn
use_current_session auf TRUE gesetzt ist:
Wenn
use_current_session auf FALSE gesetzt ist:
|
Optionen |
Prozedur STOP_JOB
Mit dieser Prozedur werden derzeit ausgeführte Jobs oder alle Jobs in einer Jobklasse gestoppt.
Nach dem Stoppen des Jobs wird der Status eines einmaligen Jobs auf STOPPED
gesetzt, während der Status eines sich wiederholenden Jobs auf SCHEDULED
oder COMPLETED
gesetzt wird, je nachdem, ob die nächste Ausführung des Jobs geplant wird.
Syntax
dbms_data_tools_job.stop_job(job_name in varchar2,
owner in varchar2 default null,
force in boolean default false);
STOP_JOB Prozedurparameter
Tabelle 3-17: Prozedurparameter STOP_JOB
Parameter | Beschreibung |
---|---|
Jobname |
Name eines Jobs, der gestoppt werden soll. Dies ist der Name eines vorhandenen Jobs, dem optional ein Schemaname und ein Punkttrennzeichen vorangestellt sind. |
Verantwortlicher |
Es ist das Schema, in dem der Job gestoppt werden soll. |
Erzwingen |
Wenn Wenn Für die Verwendung der Option |
Übergeordnetes Thema: DBMS_DATA_TOOLS_JOBS Packagereferenz