SQL-Tracing in Autonomous Database on Dedicated Exadata Infrastructure verwenden

Mit SQL-Tracing können Sie mit Autonomous Database on Dedicated Exadata Infrastructure die Quelle einer übermäßigen Datenbank-Workload identifizieren, beispielsweise eine High-Load-SQL-Anweisung in Ihrer Anwendung.

SQL-Tracing

Wenn ein Anwendungsvorgang länger als erwartet dauert, können Sie mit einem Trace aller im Rahmen dieses Vorgangs ausgeführten SQL-Anweisungen mit Details wie der Zeit, die diese SQL-Anweisung in den Parse-, Ausführungs- und Abrufphasen verbracht hat, die Ursache des Performanceproblems identifizieren und beheben. Um dies zu erreichen, können Sie SQL-Tracing in einer Autonomous Database verwenden.

SQL-Tracing ist in Autonomous Database standardmäßig deaktiviert. Sie müssen es aktivieren, um mit dem Erfassen der SQL-Tracingdaten zu beginnen. Um SQL-Anweisungen zu verfolgen, implementieren Sie die folgenden Aufgaben als ADMIN-Benutzer:
  • Beginnen Sie mit der Konfiguration der Datenbank, um SQL Trace-Dateien zu speichern. Weitere Informationen finden Sie unter SQL-Tracing in Autonomous Database konfigurieren.
  • Aktivieren Sie dann das SQL-Tracing. Siehe SQL-Tracing in Autonomous Database aktivieren.

    Hinweis:

    Das Aktivieren von SQL-Tracing kann die Anwendungsperformance für die Session beeinträchtigen, während die Traceerfassung aktiviert ist. Diese Performanceauswirkungen sind aufgrund des Overheads beim Erfassen und Speichern von Tracedaten zu erwarten.
  • Um die Erfassung der SQL-Tracingdaten zu stoppen, müssen Sie das SQL-Tracing deaktivieren. Siehe SQL-Tracing deaktivieren.
  • Wenn Sie SQL-Tracing deaktivieren, werden die Tracingdaten, die während der Ausführung der Session mit aktiviertem Tracing erfasst wurden, in die Ansicht SESSION_CLOUD_TRACE in Ihrer Session und in eine Tracedatei im Bucket geschrieben, die Sie beim Einrichten von SQL-Tracing konfigurieren. Sie haben zwei Möglichkeiten, die Tracedaten anzuzeigen:

SQL-Tracing in Autonomous Database konfigurieren

So konfigurieren Sie SQL-Tracing für Autonomous Database:
  1. Erstellen Sie einen Bucket zum Speichern von Tracedateien in Ihrem Cloud-Objektspeicher.
    Um die SQL-Tracingdateien zu speichern, kann sich der Bucket in einem beliebigen Cloud-Objektspeicher befinden, den Autonomous Database unterstützt. Beispiel: Informationen zum Erstellen eines Buckets in Oracle Cloud Infrastructure Object Storage finden Sie unter Bucket erstellen.

    Tipp:

    Stellen Sie sicher, dass Sie Standard als Storage Tier auswählen, wenn Sie Ihren Bucket in Oracle Cloud Infrastructure Object Storage erstellen, da SQL-Tracingdateien nur mit Buckets unterstützt werden, die in der Standard-Storage Tier erstellt wurden. Informationen zur Standard-Tier in Object Storage finden Sie unter Storage Tiers.
  2. Erstellen Sie mit DBMS_CLOUD.CREATE_CREDENTIAL Zugangsdaten für Ihren Cloud-Objektspeicheraccount.
    Beispiel:
    BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'adb_user@example.com', 
    password => 'password'
);END;
/

    Einzelheiten zu den Argumenten für die Parameter username und password für verschiedene Objektspeicherservices finden Sie unter Prozedur CREATE_CREDENTIAL.

  3. Legen Sie Initialisierungsparameter fest, um die Cloud-Objektspeicher-URL für einen Bucket für SQL-Tracedateien und die Zugangsdaten für den Zugriff auf den Cloud-Objektspeicher anzugeben.
    1. Legen Sie die Datenbankeigenschaft DEFAULT_LOGGING_BUCKET fest, um den Logging-Bucket im Cloud-Objektspeicher anzugeben.
      Beispiel: Wenn Sie den Bucket mit Oracle Cloud Infrastructure (OCI) Object Storage erstellen:
      SET DEFINE OFF;
ALTER DATABASE PROPERTY SET 
   DEFAULT_LOGGING_BUCKET = 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucket_name/o/';

      Dabei ist namespace-string der OCI Object Storage-Namespace und bucket_name der Name des zuvor erstellten Bucket. Weitere Informationen finden Sie unter Object Storage-Namespaces.

      Eine Liste der Regionen finden Sie unter Regionen und Availability-Domains.

      Der Cloud-Objektspeicher, den Sie für SQL-Tracingdateien verwenden, kann jeder Cloud-Objektspeicher sein, den Autonomous Database unterstützt.

    2. Setzen Sie die Datenbankeigenschaft DEFAULT_CREDENTIAL auf die Zugangsdaten, die Sie in Schritt 2 erstellt haben.
      Beispiel:
      ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME';

      Der Schemaname muss in die Zugangsdaten aufgenommen werden. In diesem Beispiel lautet das Schema ADMIN.

SQL-Tracing in Autonomous Database aktivieren

Hinweis:

Das Aktivieren von SQL-Tracing kann die Anwendungsperformance für die Session beeinträchtigen, während die Traceerfassung aktiviert ist. Diese Performanceauswirkungen sind aufgrund des Overheads beim Erfassen und Speichern von Tracedaten zu erwarten.

So aktivieren Sie SQL-Tracing für eine Datenbank-Session:

  1. Optional können Sie eine Client-ID für die Anwendung festlegen. Dieser Schritt ist optional, wird jedoch empfohlen. Beim SQL-Tracing wird die Client-ID als Komponente des Trace-Dateinamens verwendet, wenn die Trace-Datei in den Cloud-Objektspeicher geschrieben wird.
    Beispiel:
    BEGIN
  DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
END;
/
  2. Legen Sie optional einen Modulnamen für die Anwendung fest. Dieser Schritt ist optional, wird jedoch empfohlen. Beim SQL-Tracing wird der Modulname als Komponente des Tracedateinamens verwendet, wenn die Tracedatei in den Cloud-Objektspeicher geschrieben wird.

    Beispiel:

    BEGIN
  DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
END;
/
  3. Aktivieren Sie die SQL Trace-Funktion.
    ALTER SESSION SET SQL_TRACE = TRUE;
  4. Führen Sie Ihre Workload aus.
    Dieser Schritt umfasst die Ausführung der gesamten Anwendung oder bestimmter Teile der Anwendung. Während Sie Ihre Workload in der Datenbanksession ausführen, werden SQL-Tracingdaten erfasst.
  5. SQL Tracing deaktivieren.
    Wenn Sie SQL deaktivieren, werden die für die Session erfassten Daten in eine Tabelle in Ihrer Session und in eine Trace-Datei in dem Bucket geschrieben, den Sie bei der Einrichtung von SQL-Tracing konfigurieren.

SQL-Tracing deaktivieren

So deaktivieren Sie SQL-Tracing:
  1. Deaktivieren Sie die SQL Trace-Funktion.
    ALTER SESSION SET SQL_TRACE = FALSE;
  2. Optional können Sie bei Bedarf für Ihre Umgebung die Datenbankeigenschaft DEFAULT_LOGGING_BUCKET zurücksetzen, um den Wert für den Logging-Bucket im Cloud-Objektspeicher zu löschen.
    Beispiel:
    ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';
Wenn Sie SQL-Tracing deaktivieren, werden die Tracingdaten, die während der Ausführung der Session mit aktiviertem Tracing erfasst wurden, in eine Tabelle kopiert und an eine Tracedatei im Cloud-Objektspeicher gesendet.

Im Cloud-Objektspeicher gespeicherte Tracedatei in Autonomous Database anzeigen

Sie verwenden SQL-Tracedateidaten, um die Anwendungsperformance in Autonomous Database zu analysieren. Wenn Sie SQL Trace in Ihrer Datenbanksession deaktivieren, werden Daten in den mit DEFAULT_LOGGING_BUCKET konfigurierten Cloud-Objektspeicher-Bucket geschrieben.

Die SQL Trace-Funktion schreibt die in der Session erfassten Tracedaten im folgenden Format in den Cloud-Objektspeicher:

default_logging_bucket/sqltrace/clientID/moduleName/sqltrace_numID1_numID2.trc

Der Dateiname besteht aus folgenden Komponenten:

  • default_logging_bucket: Der Wert der Datenbankeigenschaft DEFAULT_LOGGING_BUCKET. Weitere Informationen finden Sie unter SQL-Tracing in Autonomous Database konfigurieren.

  • clientID: Die Client-ID. Weitere Informationen finden Sie unter SQL-Tracing in Autonomous Database aktivieren.

  • moduleName: Der Modulname. Weitere Informationen finden Sie unter SQL-Tracing in Autonomous Database aktivieren.

  • numID1_numID2: Zwei IDs, die von der SQL Trace-Funktion bereitgestellt werden. Die numerischen Werte numID1 und numID2 unterscheiden jeden Trace-Dateinamen eindeutig von anderen Sessions, die Tracing verwenden und Trace-Dateien im selben Bucket im Cloud-Objektspeicher erstellen.

    Wenn der Datenbankservice Parallelität unterstützt und eine Session eine parallele Abfrage ausführt, kann die SQL Trace-Funktion mehrere Trace-Dateien mit unterschiedlichen Werten für numID1 und numID2 erstellen.

Hinweis:

Wenn SQL-Tracing innerhalb derselben Session mehrmals aktiviert und deaktiviert wird, generiert jede Traciteration eine separate Tracedatei im Cloud-Objektspeicher. Um zu vermeiden, dass vorherige Traces überschrieben werden, die in der Session generiert wurden, folgen nachfolgend generierte Dateien derselben Namenskonvention und fügen ein numerisches Suffix zum Namen der Trace-Datei hinzu. Dieses numerische Suffix beginnt mit der Zahl 1 und wird für jede nachfolgende Tracingiteration um 1 erhöht.

Beispiel: Der folgende Name ist ein Beispiel für eine generierte Trace-Datei, wenn Sie die Client-ID auf "sql_test" und den Modulnamen auf "modname" setzen:

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

Sie können TKPROF ausführen, um die Tracedatei in eine lesbare Ausgabedatei zu übersetzen.

  1. Kopieren Sie die Tracedatei aus dem Objektspeicher in Ihr lokales System.
  2. Navigieren Sie zu dem Verzeichnis, in dem die Tracedatei gespeichert ist.
  3. Führen Sie das Utility TKPROF in der Eingabeaufforderung des Betriebssystems mit der folgenden Syntax aus:
    tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
 [aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
 [explain=user/password] [record=filename4] [width=n]

    Die Eingabe- und Ausgabedateien sind die einzigen erforderlichen Argumente.

  4. Um die Onlinehilfe anzuzeigen, rufen Sie TKPROF ohne Argumente auf.
    Informationen zur Verwendung des Utilitys TKPROF finden Sie unter Tools für End-to-End Application Tracing in der Dokumentation Oracle Database 19c SQL Tuning Guide oder Oracle Database 23ai SQL Tuning Guide.

Tracedaten in der SESSION_CLOUD_TRACE-View in Autonomous Database anzeigen

Wenn Sie SQL-Tracing aktivieren, sind in der View SESSION_CLOUD_TRACE in der Session, in der das Tracing aktiviert wurde, dieselben Traceinformationen verfügbar, die in der Tracedatei im Cloud-Objektspeicher gespeichert wurden.
In der Datenbanksession können Sie SQL-Tracingdaten in der View SESSION_CLOUD_TRACE anzeigen. Die View SESSION_CLOUD_TRACE enthält zwei Spalten: ROW_NUMBER und TRACE.
DESC SESSION_CLOUD_TRACE

Name       Null? Type
---------- ----- ------------------------------
ROW_NUMBER       NUMBER
TRACE            VARCHAR2(32767)

ROW_NUMBER gibt die Reihenfolge der in der Spalte TRACE gefundenen Tracedaten an. Jede Zeile der Traceausgabe in einer Tracedatei wird zu einer Zeile in der Tabelle und ist in der Spalte TRACE verfügbar.

Nachdem Sie SQL-Tracing für die Session deaktiviert haben, können Sie Abfragen in der View SESSION_CLOUD_TRACE ausführen.

Beispiel:
SELECT trace FROM SESSION_CLOUD_TRACE ORDERBY row_number;

Die Daten in SESSION_CLOUD_TRACE bleiben für die Dauer der Session erhalten. Nachdem Sie sich abgemeldet oder die Session geschlossen haben, sind die Daten nicht mehr verfügbar.

Wenn SQL Trace innerhalb derselben Session mehrere Male aktiviert und deaktiviert wird, zeigt SESSION_CLOUD_TRACE die Trace-Daten für alle Iterationen kumulativ an. Daher werden Tracedaten, die durch eine frühere Iteration erzeugt wurden, nicht entfernt, wenn Sie Tracing in einer Session erneut aktivieren, nachdem Sie es zuvor deaktiviert haben.