DBMS_USERDIAG-Package

Das Package DBMS_USERDIAG stellt Unterprogramme bereit, mit denen das SQL-Tracing für eine bestimmte SQL-Anweisung, Session, Client-ID oder Anwendungsservice, Modul und Aktion aktiviert und deaktiviert werden kann. Sie können auch Bind-Variablenwerte, Wait-Ereignisinformationen und Ausführungsplanstatistiken erfassen, um detailliertere Diagnosen zu erhalten.

Prozedur SESSION_SQL_TRACE_ENABLE

Verwenden Sie die Prozedur DBMS_USERDIAG.SESSION_SQL_TRACE_ENABLE, um das SQL-Tracing für die aktuelle Session oder für Sessions zu aktivieren, die mit den angegebenen Tracingattributen übereinstimmen.

Syntax

DBMS_USERDIAG.SESSION_SQL_TRACE_ENABLE (
    level         IN BINARY_INTEGER DEFAULT 1,
    sid           IN BINARY_INTEGER DEFAULT 0,
    ser           IN BINARY_INTEGER DEFAULT 0,
    instance_name IN VARCHAR2       DEFAULT NULL,
    binds         IN BINARY_INTEGER DEFAULT 0,
    waits         IN BINARY_INTEGER DEFAULT 0,
    client_id     IN VARCHAR2       DEFAULT NULL,
    service       IN VARCHAR2       DEFAULT NULL,
    module        IN VARCHAR2       DEFAULT NULL,
    action        IN VARCHAR2       DEFAULT NULL,
    plan_stat     IN VARCHAR2       DEFAULT NULL,
    sql_id        IN VARCHAR2       DEFAULT NULL
);

Parameter

Parameter Beschreibung
level Gibt die SQL-Traceebene an. Ebene 1 erfasst grundlegende Trace-Daten. Ebene 4 enthält Informationen zu Bind-Variablen und Ebene 8 Informationen zu Wait-Ereignissen. Die Werte können kombiniert werden. Dieser Parameter ist optional und standardmäßig 1.
sid Gibt die Session-ID der Zielsession an. Der Standardwert 0 gibt die aktuelle Sitzung an.
ser Gibt die Seriennummer der Zielsession an. Der Standardwert 0 gibt die aktuelle Sitzung an. Verwenden Sie sid und ser, um eine andere Session zu identifizieren.
instance_name Gibt die Datenbankinstanz an, die die Zielsession enthält.
binds Gibt an, ob Informationen zu Bind-Variablen eingeschlossen werden sollen. Ein Wert ungleich null enthält Informationen zu Bind-Variablen und fügt Tracing der Ebene 4 hinzu. Der Standardwert ist 0.
waits Gibt an, ob Wait-Ereignisinformationen eingeschlossen werden sollen. Ein Wert ungleich Null enthält Wait-Ereignisinformationen und fügt Tracing der Ebene 8 hinzu. Der Standardwert ist 0.
client_id Gibt die Client-ID an, mit der Sessions über Datenbankinstanzen hinweg abgeglichen werden.
service Gibt den Datenbankservice an, mit dem Sessions abgeglichen werden.
module Gibt das Anwendungsmodul an, das mit service zum Abgleichen von Sessions verwendet wird.
action Gibt die Anwendungsaktion an, die mit service und module zum Abgleichen von Sessions verwendet wird.
plan_stat Gibt die Option für Ausführungsplanstatistiken an. Gültige Werte sind NEVER, FIRST_EXECUTION, ALL_EXECUTIONS und ADAPTIVE. Der Standardwert ist FIRST_EXECUTION.
sql_id Gibt die SQL-ID an. Wenn angegeben, ist das Tracing auf die SQL-Anweisung mit dieser SQL-ID beschränkt.

Beispiel

Das folgende Beispiel aktiviert das SQL-Tracing für eine bestimmte SQL-Anweisung und enthält Informationen zu Bind-Variablen und Wait-Ereignissen:

BEGIN
    DBMS_USERDIAG.SESSION_SQL_TRACE_ENABLE(
        sql_id    => '5yka4rvxpbjc6',
        binds     => 1,
        waits     => 1,
        plan_stat => 'ADAPTIVE');
END;
/

Im folgenden Beispiel wird das SQL-Tracing für eine andere Session mit der Session-ID und der Seriennummer aktiviert:

BEGIN
    DBMS_USERDIAG.SESSION_SQL_TRACE_ENABLE(
        sid   => 39,
        ser   => 15593,
        binds => 1,
        waits => 1);
END;
/

Hinweise zur Verwendung

  • Sie müssen als Benutzer ADMIN angemeldet sein oder über die Berechtigung EXECUTE für das Package DBMS_USERDIAG verfügen, um diese Prozedur ausführen zu können.
  • SQL-Tracing ist standardmäßig deaktiviert. Aktivieren Sie eine Tracingmethode für eine Tracingregel, führen Sie die Workload aus, und deaktivieren Sie das Tracing mit denselben identifizierenden Attributen.
  • Geben Sie eine Tracingmethode für eine Tracingregel an. Sie können Tracing-Ziele nach SQL-ID, Session, Client-ID, Service, Modul und Aktion identifizieren.
  • Höhere Trace-Ebenen, einschließlich Bind-Variablen und Wait-Ereignis-Tracing, können große Trace-Dateien generieren und die Anwendungsperformance beeinträchtigen.
  • Ein lokaler Benutzer kann keine Session verfolgen, die zu einem allgemeinen Benutzer gehört.
  • DBMS_USERDIAG.ENABLE_SQL_TRACE_EVENT ist veraltet. Verwenden Sie stattdessen SESSION_SQL_TRACE_ENABLE und SESSION_SQL_TRACE_DISABLE.

Weitere Informationen finden Sie unter Prozedur SESSION_SQL_TRACE_DISABLE.

Prozedur SESSION_SQL_TRACE_DISABLE

Verwenden Sie die Prozedur DBMS_USERDIAG.SESSION_SQL_TRACE_DISABLE, um das SQL-Tracing für die aktuelle Session oder für Sessions zu deaktivieren, die mit den angegebenen Tracingattributen übereinstimmen.

Deaktivieren Sie das Tracing nach Abschluss der Workload. Wenn das Tracing deaktiviert ist, lädt die Datenbank die erfassten Tracedaten in den für das SQL-Tracing konfigurierten Cloud-Objektspeicher-Bucket hoch. Sie können die Tracedaten in der generierten Tracedatei oder in der Ansicht SESSION_CLOUD_TRACE prüfen.

Syntax

DBMS_USERDIAG.SESSION_SQL_TRACE_DISABLE (
    level         IN BINARY_INTEGER DEFAULT 1,
    sid           IN BINARY_INTEGER DEFAULT 0,
    ser           IN BINARY_INTEGER DEFAULT 0,
    instance_name IN VARCHAR2       DEFAULT NULL,
    binds         IN BINARY_INTEGER DEFAULT 0,
    waits         IN BINARY_INTEGER DEFAULT 0,
    client_id     IN VARCHAR2       DEFAULT NULL,
    service       IN VARCHAR2       DEFAULT NULL,
    module        IN VARCHAR2       DEFAULT NULL,
    action        IN VARCHAR2       DEFAULT NULL,
    plan_stat     IN VARCHAR2       DEFAULT NULL,
    sql_id        IN VARCHAR2       DEFAULT NULL
);

Parameter

Parameter Beschreibung
level Gibt die SQL-Traceebene an. Ebene 1 erfasst grundlegende Trace-Daten. Ebene 4 enthält Informationen zu Bind-Variablen und Ebene 8 Informationen zu Wait-Ereignissen. Die Werte können kombiniert werden. Dieser Parameter ist optional und standardmäßig 1.
sid Gibt die Session-ID der Zielsession an. Der Standardwert 0 gibt die aktuelle Sitzung an.
ser Gibt die Seriennummer der Zielsession an. Der Standardwert 0 gibt die aktuelle Sitzung an. Verwenden Sie sid und ser, um eine andere Session zu identifizieren.
instance_name Gibt die Datenbankinstanz an, die die Zielsession enthält.
binds Gibt an, ob Informationen zu Bind-Variablen eingeschlossen werden sollen. Ein Wert ungleich null enthält Informationen zu Bind-Variablen und fügt Tracing der Ebene 4 hinzu. Der Standardwert ist 0.
waits Gibt an, ob Wait-Ereignisinformationen eingeschlossen werden sollen. Ein Wert ungleich Null enthält Wait-Ereignisinformationen und fügt Tracing der Ebene 8 hinzu. Der Standardwert ist 0.
client_id Gibt die Client-ID an, mit der Sessions über Datenbankinstanzen hinweg abgeglichen werden.
service Gibt den Datenbankservice an, mit dem Sessions abgeglichen werden.
module Gibt das Anwendungsmodul an, das mit service zum Abgleichen von Sessions verwendet wird.
action Gibt die Anwendungsaktion an, die mit service und module zum Abgleichen von Sessions verwendet wird.
plan_stat Gibt die Option für Ausführungsplanstatistiken an. Gültige Werte sind NEVER, FIRST_EXECUTION, ALL_EXECUTIONS und ADAPTIVE. Der Standardwert ist FIRST_EXECUTION.
sql_id Gibt die SQL-ID an. Wenn angegeben, ist das Tracing auf die SQL-Anweisung mit dieser SQL-ID beschränkt.

Geben Sie dieselben identifizierenden Attribute an, die Sie beim Aktivieren von Tracing verwendet haben.

Beispiel

Im folgenden Beispiel wird das SQL-Tracing für die mit 5yka4rvxpbjc6 identifizierte SQL-Anweisung deaktiviert:

BEGIN
    DBMS_USERDIAG.SESSION_SQL_TRACE_DISABLE(
        sql_id => '5yka4rvxpbjc6');
END;
/

Im folgenden Beispiel wird das SQL-Tracing für die Session deaktiviert, die mit der Session-ID 39 und der Seriennummer 15593 identifiziert wird:

BEGIN
    DBMS_USERDIAG.SESSION_SQL_TRACE_DISABLE(
        sid => 39,
        ser => 15593);
END;
/

Hinweise zur Verwendung

  • Verwenden Sie dieselben identifizierenden Attribute in SESSION_SQL_TRACE_DISABLE, die Sie in SESSION_SQL_TRACE_ENABLE verwendet haben.
  • Wenn die Zielsession beendet wird, bevor das Tracing deaktiviert wird, lädt die Datenbank die Tracedatei hoch, wenn die Session beendet wird.
  • Tracedaten können Anwendungsdaten enthalten. Schützen Sie den Cloud Object Storage-Bucket und die Zugangsdaten entsprechend.
  • Die Tracedaten sind für die Dauer der Session, in der das Tracing aktiviert wurde, in der Ansicht SESSION_CLOUD_TRACE verfügbar. Nach Beendigung der Session sind die Daten in der View nicht mehr verfügbar.

Weitere Informationen finden Sie unter Prozedur SESSION_SQL_TRACE_ENABLE.