Wenn Sie mit der Workload-erfassung in einem Produktionssystem beginnen, werden alle Anforderungen von externen Clients, die an Oracle Database weitergeleitet werden, verfolgt und in Binärdateien gespeichert, die als Capture-Dateien bezeichnet werden.

Eine Workload-Erfassung führt zur Erstellung von zwei Unterverzeichnissen, cap und capfiles für die Capture-Dateien. Die Capture-Dateien stellen alle relevanten Informationen zu den Clientanforderungen bereit, einschließlich Transaktionsdetails, Bind-Werten und SQL-Text. Die Capture-Dateien sind plattformunabhängig und können in ein anderes System transportiert werden.

Führen Sie DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE aus, um die Workload-Erfassung auf einer Autonomous Database-Instanz zu initiieren.

Weitere Informationen finden Sie unter Autonomous Database-Instanz klonen, verschieben oder upgraden.

Um einen Workload Capture-Vorgang in Ihrer Autonomous Database-Instanz zu initiieren, müssen Sie als Benutzer ADMIN angemeldet sein oder über die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN verfügen.

Beispiel zum Starten von Workload Capture:

BEGIN 
   DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name => 'test',
        duration     => 60);
   END;
/

Dadurch wird der Workload Capture-Vorgang in Ihrer Autonomous Database-Instanz gestartet.

Parameter:

• capture_name: Der Name der Workload-Erfassung.

• duration: Gibt die Dauer (in Minuten) an, für die Sie die Workload erfassen müssen. Dieser Parameter ist optional.

Weitere Informationen finden Sie unter Prozedur START_WORKLOAD_CAPTURE.

Workload-Erfassungsereignisse

Sie können das Informationsereignis com.oraclecloud.databaseservice.autonomous.database.information abonnieren, um am Anfang von START_WORKLOAD_CAPTURE benachrichtigt zu werden. Weitere Informationen finden Sie unter (Optional) Informationsereignisse abonnieren, die über Capture- und Replay-Details benachrichtigt werden sollen.

Capture- und Wiedergabeansichten der Workload

Informationen zur Workload-Erfassung und -Wiedergabe finden Sie in den Ansichten DBA_CAPTURE_REPLAY_STATUS und DBA_CAPTURE_REPLAY_HISTORY. Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_STATUS und Ansicht DBA_CAPTURE_REPLAY_HISTORY.

Um eine Workload-Erfassung abzubrechen, müssen Sie als Benutzer ADMIN angemeldet sein oder die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN besitzen.

Beispiel:

BEGIN
    DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

Dadurch wird der aktuelle Workload Capture-Vorgang abgebrochen, und der aktualisierbare Klon wird aktualisiert.

Sie können die View DBA_CAPTURE_REPLAY_STATUS abfragen, um den Workload-Status "Abbrechen" zu prüfen.

Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_STATUS.

Weitere Informationen finden Sie unter Prozedur CANCEL_WORKLOAD_CAPTURE.

Beispiel für das Beenden eines Workload Capture-Vorgangs in Ihrer Autonomous Database-Instanz:

BEGIN
    DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE;
END;
/

Um diese Prozedur auszuführen, müssen Sie als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN besitzen. Wenn Sie diese Prozedur ausführen, wird eine Workload Capture-Datei als ZIP-Datei in den Objektspeicher hochgeladen.

Weitere Informationen finden Sie unter Prozedur FINISH_WORKLOAD_CAPTURE.

Workload-Erfassungsereignisse

Sie können das Informationsereignis com.oraclecloud.databaseservice.autonomous.database.information abonnieren, um über eine Workload-Erfassung benachrichtigt zu werden. Dazu gehören:

• Der Abschluss von FINISH_WORKLOAD_CAPTURE.

• Das Feld captureDownloadURL mit der PAR-URL für den Zugriff auf die Erfassung und Berichte im Objektspeicher. Die Erfassung und die Berichte sind ab dem Datum der Generierung der PAR-URL sieben (7) Tage lang gültig.

Weitere Informationen finden Sie unter (Optional) Informationsereignisse abonnieren, die über Capture- und Replay-Details benachrichtigt werden sollen.

Capture- und Wiedergabeansichten der Workload

Sie können die View DBA_CAPTURE_REPLAY_STATUS abfragen, um den Status eines abgeschlossenen Workload Capture-Vorgangs zu prüfen. Weitere Informationen finden Sie in der Ansicht DBA_CAPTURE_REPLAY_STATUS.

Informationen zur Workload-Erfassung und -Wiedergabe finden Sie in der Ansicht DBA_CAPTURE_REPLAY_HISTORY. Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_HISTORY.

Sie können die Spalten ID, NAME, START_TIME und END_TIME der View DBA_WORKLOAD_CAPTURES abfragen, um die Details der Workload-Erfassung abzurufen. Weitere Informationen finden Sie unter DBA_WORKLOAD_CAPTURES.

Sie haben zwei Optionen, um einen aktualisierbaren Klon für die Wiedergabe eines Workload Capture-Vorgangs vorzubereiten. Sie können DBMS_CLOUD_ADMIN.PREPARE_REPLAY ausführen, um automatisch einen aktualisierbaren Klon für eine Workload-Wiedergabe vorzubereiten. Diese Prozedur aktualisiert den aktualisierbaren Klon auf die Startzeit des Capture-Vorgangs und trennt die Verbindung zum aktualisierbaren Klon. Außerdem können Sie einen aktualisierbaren Klon manuell vorbereiten, um eine Workload-Erfassung wiederzugeben.

Aktualisierbaren Klon für Workload-Wiedergabe automatisch vorbereiten

Beispiel für die automatische Vorbereitung eines aktualisierbaren Klons für eine Workload-Wiedergabe:

BEGIN
 DBMS_CLOUD_ADMIN.PREPARE_REPLAY (
    capture_name    'test'
END;
/

Um diese Prozedur auszuführen, müssen Sie als Benutzer ADMIN angemeldet sein oder die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN besitzen.

DBMS_CLOUD_ADMIN.PREPARE_REPLAY führt folgende Schritte aus:

• Aktualisiert den aktualisierbaren Klon auf den Zeitstempel für den Capture-Start.

• Trennen Sie den aktualisierbaren Klon.

Optional können Sie an dieser Stelle vor der Wiedergabe eines Capture-Vorgangs Änderungen an einem aktualisierbaren Klon vornehmen. Beispiel: Ändern Sie Parameterwerte, und schalten Sie bestimmte Funktionen ein/aus, um die Auswirkungen auf die Wiedergabe zu sehen.

Aktualisierbaren Klon für Workload-Wiedergabe manuell vorbereiten

Diese manuellen aktualisierbaren Klonschritte sind nicht erforderlich, wenn Sie einen aktualisierbaren Klon automatisch vorbereiten, indem Sie DBMS_CLOUD_ADMIN.PREPARE_REPLAY ausführen.

Führen Sie die folgenden Schritte aus, um die Workload-Wiedergabe manuell vorzubereiten:

1. Suchen Sie den Zeitstempel für den Capture-Start, indem Sie die View DBA_WORKLOAD_CAPTURES abfragen. Weitere Informationen finden Sie unter DBA_WORKLOAD_CAPTURES.

2. Aktualisieren Sie den aktualisierbaren Klon auf den Zeitstempel für den Capture-Start. Weitere Informationen finden Sie unter Aktualisierbaren Klon in Autonomous Database aktualisieren.

3. Trennen Sie den aktualisierbaren Klon manuell. Weitere Informationen finden Sie unter Aktualisierbaren Klon von der Quelldatenbank trennen.

4. Optional können Sie vor der Wiedergabe eines Capture-Vorgangs Änderungen am aktualisierbaren Klon vornehmen. Beispiel: Ändern Sie Parameterwerte, und schalten Sie bestimmte Funktionen ein/aus, um die Auswirkung auf die Wiedergabe zu sehen.

Führen Sie die Prozedur DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD aus, um die Workload-Wiedergabe in der Datenbank zu initiieren. Sie müssen als ADMIN-Benutzer angemeldet sein oder die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN besitzen, um DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD auszuführen.

Sie können eine erfasste Workload auf einem aktualisierbaren Klon oder auf einem vollständigen Klon der Autonomous Database-Instanz, von der die Workload erfasst wurde, wiedergeben. Die Capture- und Wiedergabeziele müssen sich in einem konsistenten logischen Status befinden.

Workload in einem aktualisierbaren Klon wiedergeben

Im folgenden Beispiel werden die Capture-Dateien aus Object Storage heruntergeladen, die erfasste Workload wiedergegeben und ein Wiedergabebericht in Object Storage hochgeladen.

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      capture_name => 'CAP_TEST1');
END;
/

Der Parameter CAPTURE_NAME gibt den Namen der Workload-Erfassung an. Dieser Parameter ist erforderlich.

Workload bei einem vollständigen Klon wiedergeben

Im folgenden Beispiel werden Capture-Dateien aus Object Storage heruntergeladen, die erfasste Workload auf dem Klon wiedergegeben und ein Wiedergabebericht in Object Storage hochgeladen.

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
       capture_name                => 'CAP_TEST1',        
       capture_source_tenancy_ocid => 'OCID1.TENANCY.REGION1..ID1',         
       capture_source_db_name      => 'ADWFINANCE');
END;
/

Der Parameter CAPTURE_NAME gibt den Namen der Workload-Erfassung an. Dieser Parameter ist erforderlich.

Der Parameter CAPTURE_SOURCE_TENANCY_OCID gibt die OCID des Quellmandanten der Workload-Erfassung an. Dieser Parameter ist erforderlich, wenn die Workload-Erfassung in einem vollständigen Klon ausgeführt wird.

Der Parameter CAPTURE_SOURCE_DB_NAME gibt den Namen der Quelldatenbank des Workload Capture-Vorgangs an. Dieser Parameter ist erforderlich, wenn die Workload-Erfassung in einem vollständigen Klon ausgeführt wird.

Weitere Informationen finden Sie unter Prozedur REPLAY_WORKLOAD.

Workload-Wiedergabeereignisse

Abonnieren Sie das Informationsereignis com.oraclecloud.databaseservice.autonomous.database.information, um über Folgendes informiert zu werden

• Start und Abschluss einer REPLAY_WORKLOAD.

• Der Link "Objektspeicher", um Wiedergabeberichte herunterzuladen. Das Ereignis stellt eine PAR-URL für den Zugriff auf die Berichte im Feld replayDownloadURL bereit. Die Berichte sind ab dem Datum der Generierung der PAR-URL sieben (7) Tage lang gültig.

Weitere Informationen finden Sie unter Informationsereignisse in Autonomous Database.

Capture- und Wiedergabeansichten der Workload

Sie können die View DBA_CAPTURE_REPLAY_STATUS abfragen, um den Status der Workload-Wiedergabe zu prüfen.

Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_STATUS.

Informationen zur Workload-Erfassung und -Wiedergabe finden Sie in der Ansicht DBA_CAPTURE_REPLAY_HISTORY. Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_HISTORY.

Diese Capture-Replay-Option ist besonders nützlich, wenn Sie Ihre Workloads, die auf Oracle Database 19c ausgeführt werden, vor dem Upgrade auf Oracle Database 23ai testen möchten.

Führen Sie die folgenden Schritte aus, um Ihre Workloads in einer anderen Datenbankversion wiederzugeben:

1. (Optional) Abonnieren Sie Informationsereignisse, die über Capture- und Replay-Details benachrichtigt werden sollen

2. Erfassen Sie Ihre Workloads in einer Autonomous Database mit Oracle Database 19c. Weitere Informationen finden Sie unter Workload auf einer Autonomous Database-Instanz erfassen.

3. Führen Sie DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE aus, um die Workload-Erfassung in der Oracle Database-Datenbankinstanz 19c sourceAutonomous abzuschließen.

4. Bereiten Sie den aktualisierbaren Oracle Database 23ai-Zielklon vor. Weitere Informationen finden Sie unter Aktualisierbaren Klon für Workload-Wiedergabe vorbereiten.

5. Nachdem Sie die Workload-Erfassung abgeschlossen und das aktualisierbare Klon des Oracle Database 23ai-Ziels vorbereitet haben, geben Sie die Workload auf dem Ziel wieder. Weitere Informationen finden Sie unter Workload auf einer Autonomous Database-Instanz wiedergeben.

Wenn Sie mit der Workload-Erfassung im Produktionssystem beginnen, werden alle Anforderungen von externen Clients, die an Oracle Database weitergeleitet werden, verfolgt und in Binärdateien gespeichert, die als Capture-Dateien bezeichnet werden.

Wenn Sie eine Workload erfassen, werden zwei Unterverzeichnisse erstellt, cap und capfiles für die Capture-Dateien.

Die Capture-Dateien stellen alle relevanten Informationen zu den Clientanforderungen bereit, einschließlich Transaktionsdetails, Bind-Werten und SQL-Text.

Die Capture-Dateien sind plattformunabhängig und können in ein anderes System transportiert werden.

Informationen zum Erfassen einer Workload auf einer On-Premise-Datenbank finden Sie unter Workload Capture.

Führen Sie DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD aus, um die Workload-Wiedergabe in der Datenbank zu initiieren. Sie müssen als Benutzer ADMIN angemeldet sein oder die Berechtigung EXECUTE für DBMS_CLOUD_ADMIN besitzen, um REPLAY_WORKLOAD auszuführen.

Beispiel für die Wiedergabe einer Workload, die aus einer On-Premise-Datenbank erfasst wurde, in einer Autonomous Database-Instanz:

BEGIN 
   DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
      credential_name => 'CRED_TEST',   
      synchronization => TRUE,
      process_capture => TRUE);    
END;
/

Dadurch werden die Capture-Dateien heruntergeladen, die in dem im Parameter location_uri angegebenen Object Storage-Speicherort enthalten sind, und die Workload-Erfassung wird aus den Capture-Dateien wiedergegeben. Die Wiedergabe generiert die Wiedergabe- und Automatic Workload Repository-Berichte und lädt sie in den im Parameter location_uri angegebenen Object Storage-Speicherort hoch.

In diesem Beispiel ist namespace-string der Oracle Cloud Infrastructure-Objektspeicher-Namespace und bucketname der Bucket-Name. Weitere Informationen finden Sie unter Object Storage-Namespaces.

Weitere Informationen zum Hochladen von Dateien in Object Storage finden Sie unter Dateien in den Oracle Cloud Infrastructure Object Storage-Bucket hochladen.

Weitere Informationen zu Object Storage finden Sie unter Zu Oracle Cloud Infrastructure Object Storage navigieren und Bucket erstellen.

Der Parameter credential_name gibt die Zugangsdaten für den Zugriff auf den Object Storage Bucket an. Die angegebenen Zugangsdaten müssen über Schreibberechtigungen für den Object Storage-Bucket verfügen. Die Schreibberechtigungen sind erforderlich, um den Wiedergabebericht in den Bucket hochzuladen.

Wenn Sie den Wert credential_name nicht angeben, wird DEFAULT_CREDENTIAL verwendet.

Sie müssen keine Zugangsdaten für den Zugriff auf Oracle Cloud Infrastructure Object Storage erstellen, wenn Sie Zugangsdaten für den Resource Principal aktivieren. Weitere Informationen finden Sie unter Resource Principal für den Zugriff auf Oracle Cloud Infrastructure-Ressourcen verwenden.

Der Parameter synchronization gibt die Synchronisierungsmethode an, die bei der Workload-Wiedergabe verwendet wird. Der Wert TRUE gibt an, dass die Synchronisierung SCN-basiert ist.

process_capture gibt an, ob Sie den Wert process_capture angeben müssen. Der Wert TRUE gibt an, dass die Wiedergabe process_capture enthält.

Weitere Informationen finden Sie unter Prozedur REPLAY_WORKLOAD.

Workload-Wiedergabeereignisse

Sie können das Informationsereignis com.oraclecloud.databaseservice.autonomous.database.information abonnieren, um über die Ereignisse WorkloadReplayBegin und WorkloadReplayEnd benachrichtigt zu werden. Diese Ereignisse enthalten Informationen zu:

• Start und Abschluss der REPLAY_WORKLOAD.

• Das Feld replayDownloadURL mit der PAR-URL für den Zugriff auf die Berichte im Objektspeicher. Die PAR-URL ist ab dem Generierungsdatum 7 Tage lang gültig.

Weitere Informationen finden Sie unter Informationsereignisse in Autonomous Database.

Capture- und Wiedergabeansichten der Workload

Sie können die Views DBA_CAPTURE_REPLAY_STATUS und DBA_CAPTURE_REPLAY_HISTORY abfragen, um den Workload-Wiedergabestatus zu prüfen.

Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_STATUS und Ansicht DBA_CAPTURE_REPLAY_HISTORY.

Mit Autonomous Database können Sie eine Instanz bereitstellen oder einen aktualisierbaren Klon mit der Patchebenenoption Frühzeitig erstellen. Auf Instanzen, die auf der Patchebene Frühzeitig ausgeführt werden, wendet Autonomous Database anstehende Wartungspatches eine Woche an, bevor die Patches auf Produktionsdatenbanken eingespielt werden (Datenbanken, die auf der Patchebene Regelmäßig bereitgestellt werden). Mit dem Feature WORKLOAD_AUTO_REPLAY können Sie sicherstellen, dass ein bevorstehender Patch vor dem Produktionsstart für Ihre Workload getestet wird. Auf diese Weise können Sie überprüfen, ob der Patch ein bekanntes Problem behebt oder kein Problem verursacht, das sich auf Ihre Workload auswirkt.

Um Informationen über Erfassungen und Wiederholungen zu erhalten, abonnieren Sie Informationsereignisse. Informationsereignisse bieten Benachrichtigungen für Workload-Erfassungs- und -Antwortereignisse und enthalten eine PAR-URL, über die Sie die Capture-Datei und den Wiedergabebericht herunterladen können. Weitere Informationen finden Sie unter (Optional) Informationsereignisse abonnieren, die über Capture- und Replay-Details benachrichtigt werden sollen.

Wenn WORKLOAD_AUTO_REPLAY aktiviert ist, erfasst die Quelldatenbank eine Workload, indem sie für eine bestimmte Anzahl von Minuten ausgeführt wird. Standardmäßig wird die Workload-Erfassung gestartet, wenn Sie WORKLOAD_AUTO_REPLAY aktivieren (optional können Sie Parameter verwenden, um den Tag und die Uhrzeit des Capture-Starts festzulegen). Als Nächstes prüft Autonomous Database die Zieldatenbank, um den Patching-Status zu prüfen. Nachdem der bevorstehende wöchentliche Patch eingespielt wurde, zeigt Autonomous Database die Workload in der Zieldatenbank an. Dieser Capture-Wiedergabezyklus wird jede Woche automatisch fortgesetzt. Autonomous Database erfasst die Workload in der Quelldatenbank, wartet auf das Einspielen des bevorstehenden Patches und gibt die Workload im aktualisierbaren Klon wieder.

Beachten Sie Folgendes, um WORKLOAD_AUTO_REPLAY zu aktivieren:

• Die Quelldatenbank muss die Patchebene Regulär verwenden.

• Die Zieldatenbank muss die Patchebene Frühzeitig verwenden.

• Die Zieldatenbank muss ein aktualisierbarer Klon der Quelldatenbank sein und erstellt werden, bevor Sie WORKLOAD_AUTO_REPLAY aktivieren.

• Eine Quelldatenbank kann WORKLOAD_AUTO_REPLAY für maximal einen aktualisierbaren Klon aktivieren (Sie können dieses Feature für maximal einen aktualisierbaren Klon aktivieren, selbst wenn Sie mehrere aktualisierbare Klone aus derselben Quelldatenbank erstellen).

• Nachdem Sie WORKLOAD_AUTO_REPLAY aktiviert haben, wird der Capture-Wiedergabezyklus jede Woche fortgesetzt. Autonomous Database führt einen Capture-Vorgang in der Quelldatenbank aus und zeigt dann die Workload in der Zieldatenbank wieder an, bis Sie WORKLOAD_AUTO_REPLAY deaktivieren.

Informationen zu Workload-Erfassungen und -Wiedergaben finden Sie in der Ansicht DBA_CAPTURE_REPLAY_HISTORY. Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_HISTORY.

Autonomous Database wendet automatisch Patches auf die Datenbank an. Oracle bietet aufgrund dieser Patches ein Servicegradziel ohne Regressionen in der Produktionsdatenbank. Weitere Informationen finden Sie unter Service Level Objective für Nullregression.

In diesem Beispiel wird WORKLOAD_AUTO_REPLAY in der Quell-Autonomous Database und in der angegebenen aktualisierbaren Zieldatenbank aktiviert. Wenn WORKLOAD_AUTO_REPLAY aktiviert ist, führt Autonomous Database jede Woche einen Capture-Vorgang in der Quelldatenbank aus und gibt die Workload in der Zieldatenbank wieder, bis Sie WORKLOAD_AUTO_REPLAY deaktivieren.

Um Informationen über Erfassungen und Wiederholungen zu erhalten, abonnieren Sie Informationsereignisse. Informationsereignisse bieten Benachrichtigungen für Workload-Erfassungs- und -Antwortereignisse und enthalten eine PAR-URL, über die Sie die Capture-Datei und den Wiedergabebericht herunterladen können. Weitere Informationen finden Sie unter (Optional) Informationsereignisse abonnieren, die über Capture- und Replay-Details benachrichtigt werden sollen.

Informationen zu Workload-Erfassungen und -Wiedergaben finden Sie in der Ansicht DBA_CAPTURE_REPLAY_HISTORY. Weitere Informationen finden Sie unter Ansicht DBA_CAPTURE_REPLAY_HISTORY.

Führen Sie DBMS_CLOUD_ADMIN.DISABLE_FEATURE aus, um die automatische Workload-Wiedergabe zu deaktivieren. Beispiele:

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'WORKLOAD_AUTO_REPLAY');   
END;
/

Sie müssen als ADMIN angemeldet sein oder über DBMS_CLOUD_ADMIN-Berechtigungen verfügen, um DBMS_CLOUD_ADMIN.DISABLE_FEATURE auszuführen.

Weitere Informationen finden Sie unter Prozedur DISABLE_FEATURE.