SQL-Tracing in autonomer KI-Datenbank ausführen

Mit SQL-Tracing können Sie die Quelle einer übermäßigen Datenbank-Workload identifizieren, z.B. eine High-Load-SQL-Anweisung in Ihrer Anwendung. Autonomous AI Database unterstützt das sessionbasierte Tracing mit ALTER SESSION und das gezielte Tracing mit dem Package DBMS_USERDIAG.

SQL-Tracing ist standardmäßig deaktiviert. Um Tracedaten zu erfassen, aktivieren Sie eine Tracingregel, führen Sie die Workload aus, die Sie untersuchen möchten, und deaktivieren Sie die Regel mit denselben identifizierenden Attributen. Wenn das Tracing deaktiviert ist, lädt die Datenbank die erfassten Daten in Cloud Object Storage hoch. Sie können die Daten in der generierten Tracedatei oder in der Ansicht SESSION_CLOUD_TRACE prüfen.

Die Tracing-Methode bestimmt, wie die Datenbank die zu tracenden Sessions identifiziert. Client-ID und Service-, Modul- und Aktionstracing können übereinstimmende Sessions über Datenbankinstanzen hinweg identifizieren, während das sessionbasierte Tracing auf eine bestimmte Session auf einer bestimmten Instanz abzielt. Client-ID und Service-, Modul- und Aktionstracing unterstützen Bind-Variablen und Wait-Ereignisinformationen. Da das grundlegende Tracing für diese Tracingmethoden nicht verfügbar ist, ist das Wait Tracing standardmäßig aktiviert, wenn Sie das Bind- oder Wait Tracing nicht explizit angeben. Sessionbasiertes Tracing unterstützt Basis-, Bind- und Wait Trace-Ebenen.

SQL-Tracing in autonomer KI-Datenbank konfigurieren

Konfigurieren Sie die Datenbank so, dass SQL-Trace-Dateien in Cloud Object Storage gespeichert werden, bevor Sie das SQL-Tracing aktivieren.

Hinweis

Hinweis: Wenn Sie das SQL-Tracing aktivieren, kann die Anwendungsperformance für die Session beeinträchtigt werden, während die Traceerfassung aktiviert ist. Diese erwartete Auswirkung wird durch den Overhead beim Erfassen und Speichern von Tracedaten verursacht.

Voraussetzungen für SQL-Tracing

Die folgende Konfiguration ist sowohl für das ALTER SESSION-Tracing als auch für das DBMS_USERDIAG-Tracing erforderlich. Führen Sie diese Schritte aus, bevor Sie eine der beiden Tracingmethoden aktivieren.

So konfigurieren Sie die Datenbank für das SQL-Tracing:

  1. Erstellen Sie einen Bucket, in dem Tracedateien in Cloud Object Storage gespeichert werden.

    Um SQL-Tracedateien zu speichern, können Sie jeden Cloud Object Storage-Service verwenden, der von der autonomen KI-Datenbank unterstützt wird.

    Beispiel: So erstellen Sie einen Bucket in Oracle Cloud Infrastructure Object Storage:

    1. Öffnen Sie die Oracle Cloud Infrastructure-Konsole.

    2. Wählen Sie Speicher aus dem Menü.

    3. Wählen Sie unter Storage die Option Object Storage und Archive Storage aus.

    4. Klicken Sie auf Bucket erstellen.

    5. Geben Sie auf der Seite Bucket erstellen den Bucket-Namen ein, und klicken Sie auf Erstellen.

    Wenn Sie Oracle Cloud Infrastructure Object Storage verwenden, werden SQL-Tracingdateien nur in Buckets unterstützt, die in der Standardspeicherebene erstellt wurden. Wählen Sie als Storage Tier Standard aus. Informationen zur Object Storage-Standardebene finden Sie unter Überblick über Object Storage.

  2. Erstellen Sie mit DBMS_CLOUD.CREATE_CREDENTIAL Zugangsdaten für Ihren Cloud Object Storage-Account.

    Beispiel:

    BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'DEF_CRED_NAME',
        username        => 'adb_user@example.com',
        password        => 'password');
    END;
    /

    Hinweis

    Hinweis: Wenn sich Ihr Benutzeraccount in der Standardidentitätsdomain befindet, ist die Angabe nur des Benutzernamens ausreichend. Wenn Ihr Benutzeraccount zu einer nicht standardmäßigen Identitätsdomain gehört, stellen Sie dem Benutzernamen den Identitätsdomainnamen gefolgt von / voran. Beispiel: identity_domain_name/adb_user@example.com.

    Geben Sie für Oracle Cloud Infrastructure als username Ihren Oracle Cloud Infrastructure-Benutzernamen und als password Ihr Oracle Cloud Infrastructure-Authentifizierungstoken an. Weitere Informationen finden Sie unter Mit Authentifizierungstoken arbeiten.

    Informationen zu den Parametern und deren Werten für den von Ihnen verwendeten Cloud Object Storage-Service finden Sie unter Prozedur CREATE_CREDENTIAL.

  3. Legen Sie Datenbankeigenschaften fest, um den Cloud Object Storage-Speicherort für SQL-Trace-Dateien und die für den Zugriff verwendeten Zugangsdaten anzugeben.

    1. Legen Sie die Datenbankeigenschaft DEFAULT_LOGGING_BUCKET fest, um den Logging-Bucket anzugeben.

      Beispiel: Wenn Sie den Bucket in Oracle Cloud Infrastructure Object Storage erstellt haben:

      SET DEFINE OFF;
      ALTER DATABASE PROPERTY SET
         DEFAULT_LOGGING_BUCKET = 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucket_name/o/';

      In diesem Beispiel ist namespace-string der Oracle Cloud Infrastructure Object Storage-Namespace, und bucket_name ist der Name des erstellten Buckets. Weitere Informationen finden Sie unter Object Storage-Namespaces.

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

    2. Setzen Sie die Datenbankeigenschaft DEFAULT_CREDENTIAL auf die Zugangsdaten, die Sie in Schritt 2 erstellt haben. Fügen Sie den Schemanamen mit den Zugangsdaten hinzu. In diesem Beispiel ist das Schema ADMIN.

      ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME';

DBMS_USERDIAG-Spezifische Voraussetzungen

Die oben genannten allgemeinen Voraussetzungen gelten für das DBMS_USERDIAG-Tracing. Führen Sie außerdem die folgenden Voraussetzungen aus, bevor Sie dieses Package verwenden:

  • Sie müssen als Benutzer ADMIN angemeldet sein oder über die Berechtigung EXECUTE für DBMS_USERDIAG verfügen.
  • Rufen Sie für das sessionbasierte Tracing die Zielsession-ID und die Seriennummer ab. Sie können V$SESSION abfragen, um diese Werte zu identifizieren.
  • Stellen Sie für das Tracing von Client-IDs sicher, dass die Anwendung die Client-ID festlegt, z.B. SALES_APP.
  • Identifizieren Sie bei Service-, Modul- und Aktionstracing die Anwendungsattribute, die für die Übereinstimmung mit den Zielsessions verwendet werden.
  • Verwenden Sie das Bind- und Wait-Tracing nur, wenn Sie diese zusätzlichen Diagnoseinformationen benötigen. Diese Optionen können große Trace-Dateien generieren, die Anwendungsperformance beeinträchtigen und den PGA-Speicher erhöhen, der von der Session während der Erfassung von Trace-Daten verwendet wird.

Nachdem Sie die allgemeinen und DBMS_USERDIAG-spezifischen Voraussetzungen erfüllt haben, wählen Sie die Tracingmethode aus, die am besten zu Ihrem Diagnoseziel passt. Verwenden Sie ALTER SESSION, um die Aktivität in der aktuellen Session zu verfolgen, oder verwenden Sie DBMS_USERDIAG, um eine bestimmte Workload oder eine Gruppe von Sessions als Ziel festzulegen.

Trace-Sessions mit ALTER SESSION

Verwenden Sie ALTER SESSION, um das SQL-Tracing für die aktuelle Datenbanksession zu aktivieren. Diese Methode erfasst Trace-Informationen für die in dieser Session ausgeführte Arbeit.

Bevor Sie das SQL-Tracing aktivieren, konfigurieren Sie die Datenbank so, dass SQL-Tracedateien gespeichert werden. Weitere Informationen finden Sie unter SQL-Tracing in autonomer KI-Datenbank konfigurieren.

So aktivieren Sie das SQL-Tracing für die aktuelle Session:

  1. (Optional) Legen Sie eine Client-ID für die Anwendung fest. Diese ID wird als Komponente des Trace-Dateinamens verwendet.

    Beispiel:

    BEGIN
      DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
    END;
    /

    DBMS_SESSION.SET_IDENTIFIER legt die Client-ID für die aktuelle Session fest.

  2. (Optional) Legen Sie einen Modulnamen für die Anwendung fest. Der Modulname wird auch als Komponente des Trace-Dateinamens verwendet.

    Beispiel:

    BEGIN
      DBMS_APPLICATION_INFO.SET_MODULE('modname', NULL);
    END;
    /
  3. Aktivieren Sie die SQL-Tracefunktion.

    Beispiel:

    ALTER SESSION SET SQL_TRACE = TRUE;

    ALTER SESSION SET SQL_TRACE = TRUE aktiviert das Tracing für die aktuelle Session.

  4. Führen Sie die Workload aus, die Sie analysieren möchten. SQL-Tracing-Daten werden erfasst, während die Workload in der Session ausgeführt wird.

  5. SQL-Tracing deaktivieren.

SQL-Tracing in autonomer KI-Datenbank deaktivieren

Deaktivieren Sie das SQL-Tracing nach Abschluss der Workload. Wenn Sie das Tracing deaktivieren, werden die erfassten Daten in die Session und in eine Tracedatei im Cloud Object Storage-Bucket geschrieben, der für das SQL-Tracing konfiguriert ist.

So deaktivieren Sie das SQL-Tracing für die aktuelle Session:

  1. Deaktivieren Sie die SQL Trace-Funktion.

    Beispiel:

    ALTER SESSION SET SQL_TRACE = FALSE;

    ALTER SESSION SET SQL_TRACE = FALSE deaktiviert das Tracing für die aktuelle Session.

  2. (Optional) Setzen Sie die Datenbankeigenschaft DEFAULT_LOGGING_BUCKET zurück, um den Wert des Logging-Buckets zu löschen.

    Beispiel:

    ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

    Mit dieser Anweisung wird der für das SQL-Tracing konfigurierte Logging-Bucket gelöscht.

Nachdem Sie das SQL-Tracing deaktiviert haben, können Sie die Tracedaten auf eine der folgenden Arten anzeigen:

Tracen Sie Workloads mit DBMS_USERDIAG

Verwenden Sie das Package DBMS_USERDIAG, um das SQL-Tracing für eine bestimmte SQL-Anweisung, Session, Client-ID oder Anwendungsservice, Modul und Aktion zu aktivieren und zu deaktivieren. Mit diesem Ansatz können Sie gezielte Diagnoseinformationen für die bestimmte untersuchte SQL-Workload erfassen und gleichzeitig die nicht zugehörige Datenbankaktivität in der Analyse minimieren.

Vorteile von DBMS_USERDIAG SQL Tracing

DBMS_USERDIAG bietet die folgenden Funktionen:

  • Geltungsbereich des Tracings für eine bestimmte SQL-Anweisung mit der zugehörigen SQL_ID festlegen.
  • Verfolgen Sie eine weitere aktive Session, indem Sie die Session-ID und die Seriennummer angeben.
  • Verfolgen Sie die Anwendungsaktivität nach Client-ID.
  • Verfolgen Sie die Anwendungsaktivität nach Service, Modul und Aktion.
  • Schließen Sie Bind-Variablenwerte und Wait-Ereignisdetails ein, wenn eine genauere Diagnose erforderlich ist.
  • Sammeln Sie Ausführungsplanstatistiken für die erste Ausführung, jede Ausführung oder eine adaptive Gruppe von Ausführungen basierend auf dem Ermittlungsbedarf.

SQL-Tracing für eine bestimmte SQL-ID aktivieren

Verwenden Sie eine SQL_ID, um nur die übereinstimmende SQL-Anweisung zu tracen. In diesem Beispiel werden Informationen zu Bind-Variablen und Wait-Ereignissen erfasst, und adaptive Planstatistiken werden aktiviert.

Der Parameter sys ist in der autonomen KI-Datenbank nicht betriebsbereit und wird in den Beispielen in diesem Thema nicht verwendet.

Zum Beispiel:

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

Der Parameter sql_id begrenzt das Tracing auf die angegebene SQL-Anweisung. Die Parameter binds und waits umfassen Informationen zu Bind-Variablen und Wait-Ereignissen, und plan_stat gibt die Erfassungsoption für Planstatistiken an.

Führen Sie die Workload aus, die SQL-ID 5yka4rvxpbjc6 verwendet, und deaktivieren Sie dann das Tracing:

Zum Beispiel:

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

Der Parameter sql_id gibt die zu deaktivierende Tracingregel an. Verwenden Sie denselben identifizierenden Wert, den Sie beim Aktivieren des Tracings angegeben haben.

Der Wert sql_id muss die Anweisung identifizieren, die Sie verfolgen möchten. Die gültigen plan_stat-Werte sind FIRST_EXECUTION, NEVER, ALL_EXECUTIONS und ADAPTIVE.

SQL-Tracing für eine andere Session aktivieren

Verwenden Sie die Zielsession-ID und die Seriennummer, um eine andere Session zu verfolgen. In diesem Beispiel ist 39 die Session-ID und 15593 die Seriennummer.

Zum Beispiel:

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

Die Parameter sid und ser identifizieren die Zielsession. Die Parameter binds und waits ermöglichen die Erfassung von Bind-Variablen und Wait-Ereignisinformationen.

Führen Sie die Workload in der Zielsession aus, und deaktivieren Sie dann das Tracing aus einer Session mit den erforderlichen Berechtigungen:

Zum Beispiel:

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

Die Parameter sid und ser geben die Tracingregel an, die mit der Zielsession verknüpft ist.

Wenn die Zielsession beendet wird, bevor das Tracing deaktiviert wird, lädt die Datenbank die Tracedatei hoch, wenn die Session beendet wird.

SQL-Tracing nach Client-ID aktivieren

Verwenden Sie eine Client-ID, um übereinstimmende Sessions über Datenbankinstanzen hinweg zu verfolgen. In diesem Beispiel setzt die Anwendung die Client-ID auf SALES_APP.

Zum Beispiel:

BEGIN
  DBMS_USERDIAG.SESSION_SQL_TRACE_ENABLE(
    client_id => 'SALES_APP',
    binds     => 1,
    waits     => 1);
END;
/

Der Parameter client_id identifiziert die Anwendungssessions, die verfolgt werden sollen. Die Parameter binds und waits ermöglichen die Erfassung zusätzlicher Diagnoseinformationen.

Führen Sie die Anwendungs-Workload aus, und deaktivieren Sie dann das Tracing mit derselben Client-ID:

Zum Beispiel:

BEGIN
  DBMS_USERDIAG.SESSION_SQL_TRACE_DISABLE(
    client_id => 'SALES_APP');
END;
/

Der Parameter client_id gibt die zu deaktivierende Tracingregel an. Verwenden Sie dieselbe Client-ID, die Sie beim Aktivieren des Tracings angegeben haben.

SQL-Tracing nach Service, Modul und Aktion aktivieren

Verwenden Sie Anwendungsattribute, um Sessions zu verfolgen, die einen bestimmten Service, ein bestimmtes Modul und eine bestimmte Aktion verwenden. In diesem Beispiel ist das Tracing auf den Service HIGH, das Modul ORDER_PROCESSING und die Aktion CREATE_ORDER beschränkt.

Zum Beispiel:

BEGIN
  DBMS_USERDIAG.SESSION_SQL_TRACE_ENABLE(
    service => 'HIGH',
    module  => 'ORDER_PROCESSING',
    action  => 'CREATE_ORDER',
    binds   => 1,
    waits   => 1);
END;
/

Die Parameter service, module und action geben die Anwendungssessions an, die verfolgt werden sollen. Die Parameter binds und waits ermöglichen die Erfassung zusätzlicher Diagnoseinformationen.

Führen Sie die Anwendungs-Workload aus, und deaktivieren Sie das Tracing, indem Sie dieselben Service-, Modul- und Aktionswerte verwenden:

Zum Beispiel:

BEGIN
  DBMS_USERDIAG.SESSION_SQL_TRACE_DISABLE(
    service => 'HIGH',
    module  => 'ORDER_PROCESSING',
    action  => 'CREATE_ORDER');
END;
/

Die Parameter service, module und action geben die zu deaktivierende Tracingregel an. Verwenden Sie dieselben Werte, die Sie beim Aktivieren des Tracings angegeben haben.

Die Anwendung muss die Service-, Modul- und Aktionsattribute für ihre Sessions festlegen. Mit DBMS_APPLICATION_INFO.SET_MODULE können Sie das Modul und die Aktion festlegen. Der Abgleich erfolgt über Datenbankinstanzen hinweg, wenn die Anwendungsattribute identisch sind.

In den folgenden Themen finden Sie weitere Informationen:

SQL-Tracing prüfen

Sie können die folgenden Views abfragen, um zu prüfen, ob das Tracing aktiviert ist, und um die Tracingregeln zu prüfen:

SELECT sid, serial#, sql_trace
FROM   V$SESSION
WHERE  sid = 39;
SELECT *
FROM   DBA_ENABLED_TRACES;

Die Spalte TRACE_TYPE in DBA_ENABLED_TRACES identifiziert die Tracingmethode, wie SQL-ID, Session, Client-ID oder Service, Modul und Aktion.

Tracedatei im Cloud-Objektspeicher in autonomer KI-Datenbank speichern

Beschreibt die Benennung der Ausgabedatei für SQL-Trace-Dateien und zeigt die Befehle an, mit denen TKPROF Tracedateidaten organisiert und angezeigt werden.

Wenn Sie das SQL-Tracing deaktivieren, werden die in der Session erfassten Tracedaten 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 Cloud Object Storage:

default_logging_bucket/sqltrace/clientID/moduleName/sqltrace_numID1_numID2.trc

Die Komponenten des Dateinamens sind:

  • default_logging_bucket: Der Wert der Datenbankeigenschaft DEFAULT_LOGGING_BUCKET. Siehe SQL-Tracing in autonomer KI-Datenbank konfigurieren.
  • clientID: Die Client-ID. Siehe Trace-Sessions mit ALTER SESSION.
  • moduleName: Der Modulname. Siehe Trace-Sessions mit ALTER SESSION.
  • numID1_numID2: Zwei IDs, mit denen die Tracedatei eindeutig von Tracedateien unterschieden wird, die von anderen Sessions generiert werden, die denselben Bucket verwenden. Wenn eine Session eine parallele Abfrage ausführt, kann die SQL Trace-Funktion mehrere Trace-Dateien mit unterschiedlichen Werten erstellen.

Hinweis

Hinweis: Wenn das SQL-Tracing mehrmals in derselben Session aktiviert und deaktiviert ist, generiert jede Tracingiteration eine separate Tracedatei. Nachfolgende Dateien enthalten ein numerisches Suffix, um das Überschreiben früherer Trace-Dateien zu vermeiden. Das Suffix beginnt bei 1 und wird für jede nachfolgende Tracingiteration inkrementiert.

Beispiel: Im Folgenden finden Sie einen Beispielnamen für eine generierte Tracedatei, wenn die Client-ID sqlt_test und der Modulname modname lautet:

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 Object Storage in das lokale System.

  2. Navigieren Sie zu dem Verzeichnis, in dem die Tracedatei gespeichert wird.

  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 Oracle AI Database SQL Tuning Guide.

Tracedaten in SESSION_CLOUD_TRACE-Ansicht in autonomer KI-Datenbank anzeigen

Wenn Sie das SQL-Tracing aktivieren, sind dieselben Traceinformationen, die in der Tracedatei für Cloud Object Storage gespeichert sind, in der Ansicht SESSION_CLOUD_TRACE in der Session verfügbar, in der das Tracing aktiviert wurde.

Während Sie sich noch in der Datenbanksession befinden, können Sie SQL-Tracingdaten in der View SESSION_CLOUD_TRACE anzeigen. Die Ansicht 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 für Tracedaten in der Spalte TRACE an. Jede Zeile der Traceausgabe, die in eine Tracedatei geschrieben wird, wird zu einer Zeile in der Ansicht und ist in der Spalte TRACE verfügbar.

Nachdem Sie das SQL-Tracing deaktiviert haben, fragen Sie die View SESSION_CLOUD_TRACE ab. Zum Beispiel:

SELECT trace
FROM   SESSION_CLOUD_TRACE
ORDER BY row_number;

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

Wenn das SQL-Tracing mehrmals in derselben Session aktiviert und deaktiviert ist, zeigt SESSION_CLOUD_TRACE die Tracedaten für alle Iterationen kumulativ an. Wenn Sie das Tracing in einer Session erneut aktivieren, nachdem Sie es zuvor deaktiviert haben, werden die durch eine frühere Iteration erzeugten Tracedaten nicht entfernt.