Migrieren mithilfe von Oracle Transportable Tablespaces

Melden Sie sich als Eigentümer Ihres Oracle-Basisverzeichnisses bei Ihrem Quell-Host an.

Stellen Sie sicher, dass Ihre Umgebungsvariablen ORACLE_HOME und ORACLE_SID auf Ihre Quelldatenbank verweisen.

Melden Sie sich als Administrator bei Ihrer Datenbank an und stellen Sie sicher, dass die Zeitzonenversion, der DB-Zeichensatz und der nationale Zeichensatz mit denen in Ihrer Zieldatenbank übereinstimmen.

SELECT * FROM V$TIMEZONE_FILE;
SELECT * FROM NLS_DATABASE_PARAMETERS 
  WHERE PARAMETER IN ('NLS_CHARACTERSET','NLS_NCHAR_CHARACTERSET');

Richten Sie das Transportable-Tablespace-Dienstprogramm wie im Oracle-Support-Hinweis 2471245.1 beschrieben ein.

Das Setup beinhaltet die Bearbeitung der xtt.properties-Datei auf Ihrem Quell-Host. Die folgende xtt.properties-Beispieldatei spezifiziert Backups von drei Tabellenbereichen im /dsk1/backups-Verzeichnis. Dies sind die Tabellenbereiche, die Sie zu Ihrer Ziel-DB-Instance transportieren möchten. Es gibt auch die Quell-Plattform-ID an, um den Endianismus automatisch zu konvertieren.

#linux system 
platformid=13
#list of tablespaces to transport
tablespaces=TBS1,TBS2,TBS3
#location where backup will be generated
src_scratch_location=/dsk1/backups
#RMAN command for performing backup
usermantransport=1

Wenn sich Ihre Tabellenbereiche im schreibgeschützten Modus befinden, melden Sie sich als Benutzer mit ALTER TABLESPACE-Berechtigung bei Ihrer Quelldatenbank an und versetzen Sie Ihre Tabellenbereiche in den Lese-/Schreibmodus. Andernfalls überspringen Sie diesen Schritt und gehen Sie direkt zum nächsten.

Im folgenden Beispiel werden tbs1, tbs2 und tbs3 in den Lese-/Schreibmodus versetzt.

ALTER TABLESPACE tbs1 READ WRITE;
ALTER TABLESPACE tbs2 READ WRITE;
ALTER TABLESPACE tbs3 READ WRITE;

Sichern Sie Ihre Tabellenbereiche mithilfe des xttdriver.pl-Skripts. Optional können Sie --debug angeben, damit das Skript im Debug-Modus ausgeführt wird.

export TMPDIR=location_of_log_files
cd location_of_xttdriver.pl
$ORACLE_HOME/perl/bin/perl xttdriver.pl --backup

Starten Sie SQL*Plus oder Oracle SQL Developer und melden Sie sich bei Ihrer DB-Instance von RDS für Oracle an.

Laden Sie die Backups aus dem Amazon-S3-Bucket auf Ihre Ziel-DB-Instance herunter, indem Sie die Amazon-RDS-Prozedur rdsadmin.rdsadmin_s3_tasks.download_from_s3 verwenden. Das folgende Beispiel lädt alle Dateien von einem Amazon S3-Bucket mit dem Namen DOC-EXAMPLE-BUCKET in das Verzeichnis DATA_PUMP_DIR herunter.

EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'res.txt');
SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
  p_bucket_name    =>  'DOC-EXAMPLE-BUCKET',
  p_directory_name =>  'DATA_PUMP_DIR') 
AS TASK_ID FROM DUAL;

Die Anweisung SELECT gibt die ID der Aufgabe in einem VARCHAR2-Datentyp zurück. Weitere Informationen finden Sie unter Hochladen von Dateien aus einem Amazon S3-Bucket zu einer Oracle-DB-Instance.

Starten Sie einen Oracle-SQL-Client und melden Sie sich als Hauptbenutzer bei Ihrer DB-Instance von RDS für Oracle an.

Führen Sie die Prozedur rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces aus und geben Sie dabei die zu importierenden Tabellenbereiche und das Verzeichnis mit den Backups an.

Im folgenden Beispiel werden die Tabellenbereiche TBS1, TBS2 und TBS3 aus dem Verzeichnis DATA_PUMP_DIR importiert. Die Quellplattform ist AIX-based Systems (64-Bit) mit der Plattform-ID von. 6 Sie können die Plattform-IDs finden, indem Sie sie abfragen. V$TRANSPORTABLE_PLATFORM

VAR task_id CLOB

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces(
        'TBS1,TBS2,TBS3',
        'DATA_PUMP_DIR',
        p_platform_id => 6);
END;
/

PRINT task_id

(Optional) Überwachen Sie den Fortschritt, indem Sie die Tabelle rdsadmin.rds_xtts_operation_info abfragen. Die Spalte xtts_operation_state enthält den Wert EXECUTING, COMPLETED oder FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Sehen Sie sich das Protokoll des abgeschlossenen Imports an, indem Sie die Task-ID aus dem vorherigen Schritt verwenden.

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||'&task_id'||'.log'));

Stellen Sie sicher, dass der Import erfolgreich abgeschlossen wurde, bevor Sie mit dem nächsten Schritt fortfahren.

Starten Sie einen Oracle-SQL-Client und melden Sie sich als Hauptbenutzer bei Ihrer DB-Instance von RDS für Oracle an.

Führen Sie die Prozedur rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces aus und geben Sie dabei die zu importierenden Tabellenbereiche und das Verzeichnis mit den Backups an.

Im folgenden Beispiel werden die Tabellenbereiche TBS1, TBS2 und TBS3 aus dem Verzeichnis DATA_PUMP_DIR importiert.

BEGIN
  :task_id:=rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces('TBS1,TBS2,TBS3','DATA_PUMP_DIR');
END;
/
PRINT task_id

(Optional) Überwachen Sie den Fortschritt, indem Sie die Tabelle rdsadmin.rds_xtts_operation_info abfragen. Die Spalte xtts_operation_state enthält den Wert EXECUTING, COMPLETED oder FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Sehen Sie sich das Protokoll des abgeschlossenen Imports an, indem Sie die Task-ID aus dem vorherigen Schritt verwenden.

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file('BDUMP', 'dbtask-'||'&task_id'||'.log'));

Stellen Sie sicher, dass der Import erfolgreich abgeschlossen wurde, bevor Sie mit dem nächsten Schritt fortfahren.

Folgen Sie den Anweisungen unter Erstellen eines DB-Snapshots für eine Single-AZ-DB-Instance und erstellen Sie einen manuellen DB-Snapshot.

Starten Sie Ihren Oracle-SQL-Client und melden Sie sich als Hauptbenutzer bei Ihrer Ziel-DB-Instance an.

Erstellen Sie die Benutzer, denen Schemas in Ihren transportierten Tabellenbereichen gehören, falls diese Benutzer noch nicht existieren.

CREATE USER tbs_owner IDENTIFIED BY password;

Importieren Sie die Metadaten und geben Sie dabei den Namen der Dump-Datei und deren Verzeichnispfad an.

BEGIN
  rdsadmin.rdsadmin_transport_util.import_xtts_metadata('xttdump.dmp','DATA_PUMP_DIR');
END;
/

(Optional) Fragen Sie die Transportable-Tablespace-Verlaufstabelle ab, um den Status des Metadatenimports zu sehen.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Wenn der Vorgang abgeschlossen ist, befinden sich Ihre Tabellenbereiche im schreibgeschützten Modus.

(Optional) Sehen Sie sich die Protokolldatei an.

Das folgende Beispiel listet den Inhalt des BDUMP-Verzeichnisses auf und fragt dann das Importprotokoll ab.

SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'BDUMP'));

SELECT * FROM TABLE(rdsadmin.rds_file_util.read_text_file(
  p_directory => 'BDUMP',
  p_filename => 'rds-xtts-import_xtts_metadata-2023-05-22.01-52-35.560858000.log'));

Starten Sie SQL*Plus oder SQL Developer und melden Sie sich als Hauptbenutzer bei Ihrer Ziel-DB-Instance an.

Validieren Sie die Tabellenbereiche mithilfe der Prozedur rdsadmin.rdsadmin_rman_util.validate_tablespace.

SET SERVEROUTPUT ON
BEGIN
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS1',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS2',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
    rdsadmin.rdsadmin_rman_util.validate_tablespace(
        p_tablespace_name     => 'TBS3',
        p_validation_type     => 'PHYSICAL+LOGICAL',
        p_rman_to_dbms_output => TRUE);
END;
/

Versetzen Sie Ihre Tabellenbereiche in den Lese-/Schreibmodus.

ALTER TABLESPACE TBS1 READ WRITE;
ALTER TABLESPACE TBS2 READ WRITE;
ALTER TABLESPACE TBS3 READ WRITE;

Entfernen Sie alte Backups in DATA_PUMP_DIR wie folgt:

1. Listen Sie die Backup-Dateien auf, indem Sie den Befehl rdsadmin.rdsadmin_file_util.listdir ausführen.

   SELECT * FROM TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'DATA_PUMP_DIR'));

2. Entfernen Sie die Backups nacheinander, indem Sie UTL_FILE.FREMOVE aufrufen.

   EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'backup_filename');

Wenn Sie Tabellenbereiche, aber keine Metadaten für diese Tabellenbereiche importiert haben, können Sie die verwaisten Datendateien wie folgt löschen:

1. Listen Sie die verwaisten Datendateien auf, die Sie löschen müssen. Das folgende Beispiel führt die Prozedur rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files aus.

   SQL> SELECT * FROM TABLE(rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files);
   
   FILENAME       FILESIZE
   -------------- ---------
   datafile_7.dbf 104865792
   datafile_8.dbf 104865792

2. Löschen Sie die verwaisten Dateien, indem Sie die Prozedur rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import ausführen.

   BEGIN
     rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import('DATA_PUMP_DIR');
   END;
   /

   Der Bereinigungsvorgang generiert eine Protokolldatei, die das Namensformat rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log im BDUMP-Verzeichnis verwendet.

3. Lesen Sie die im vorherigen Schritt generierte Protokolldatei. Das folgende Beispiel zeigt das Protokoll rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log.

   SELECT * 
   FROM TABLE(rdsadmin.rds_file_util.read_text_file(
          p_directory => 'BDUMP',
          p_filename  => 'rds-xtts-delete_xtts_orphaned_files-2023-06-01.09-33-11.868894000.log'));
   
   TEXT
   --------------------------------------------------------------------------------
   orphan transported datafile datafile_7.dbf deleted.
   orphan transported datafile datafile_8.dbf deleted.

Wenn Sie Tabellenbereiche sowie Metadaten für diese Tabellenbereiche importiert haben, aber auf Kompatibilitätsfehler oder andere Probleme mit Oracle Data Pump gestoßen sind, bereinigen Sie die teilweise transportierten Datendateien wie folgt:

1. Listen Sie die Tabellenbereiche auf, die teilweise transportierte Datendateien enthalten, indem Sie DBA_TABLESPACES abfragen.

   SQL> SELECT TABLESPACE_NAME FROM DBA_TABLESPACES WHERE PLUGGED_IN='YES';
   
   TABLESPACE_NAME
   --------------------------------------------------------------------------------
   TBS_3

2. Löschen Sie die Tabellenbereiche und die teilweise transportierten Datendateien.

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;