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
ADMINangemeldet sein oder über die BerechtigungEXECUTEfür das PackageDBMS_USERDIAGverfü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_EVENTist veraltet. Verwenden Sie stattdessenSESSION_SQL_TRACE_ENABLEundSESSION_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 inSESSION_SQL_TRACE_ENABLEverwendet 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_TRACEverfü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.