Migración mediante espacios de tabla transportables de Oracle

Inicie sesión en su host de origen como propietario de su inicio de Oracle.

Asegúrese de que sus variables de entorno ORACLE_HOME y ORACLE_SID apunten hacia la base de datos de origen.

Inicie sesión en la base de datos como administrador y compruebe que la versión de zona horaria, el juego de caracteres de la base de datos y el conjunto de caracteres nacionales sean los mismos que los de la base de datos de destino.

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

Configure la utilidad de espacio de tabla transportable tal como se describe en la nota de soporte de Oracle 2471245.1.

La configuración incluye la edición del archivo xtt.properties en el host de origen. El siguiente archivo xtt.properties de ejemplo especifica las copias de seguridad de tres espacios de tabla del directorio /dsk1/backups. Estos son los espacios de tabla que pretende transportar a la instancia de base de datos de destino. También especifica el ID de la plataforma de origen para convertir el endianness automáticamente.

#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

Si los espacios de tabla están en modo de solo lectura, inicie sesión en la base de datos de origen como usuario con el privilegio ALTER TABLESPACE y coloque los espacios de tabla en modo de lectura/escritura. De no ser así, vaya al siguiente paso.

En el siguiente ejemplo se establecen tbs1, tbs2 y tbs3 en modo de lectura/escritura.

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

Realice una copia de seguridad de los espacios de tabla con el script xttdriver.pl. Si lo desea, puede especificar --debug para que ejecute el script en modo de depuración.

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

Inicie SQL*Plus u Oracle SQL Developer e inicie sesión en la instancia de base de datos de destino de RDS para Oracle.

Descargue las copias de seguridad del bucket de Amazon S3 en la instancia de base de datos de destino mediante el procedimiento de Amazon RDS rdsadmin.rdsadmin_s3_tasks.download_from_s3 para d. En el siguiente ejemplo se descargan todos los archivos de un bucket de Amazon S3 denominado amzn-s3-demo-bucket en el directorio DATA_PUMP_DIR.

EXEC UTL_FILE.FREMOVE ('DATA_PUMP_DIR', 'res.txt');
SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
  p_bucket_name    =>  'amzn-s3-demo-bucket',
  p_directory_name =>  'DATA_PUMP_DIR') 
AS TASK_ID FROM DUAL;

La instrucción SELECT devuelve el identificador de la tarea en un tipo de datos VARCHAR2. Para obtener más información, consulte Descarga de archivos desde un bucket de Amazon S3 en una instancia de base de datos de Oracle.

Inicie un cliente de Oracle SQL e inicie sesión como usuario maestro en su instancia de base de datos de destino de RDS para Oracle.

Ejecute el procedimiento rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces y especifique los espacios de tabla que se van a importar y el directorio que contiene las copias de seguridad.

En el siguiente ejemplo se importan los espacios de tabla TBS1, TBS2 y TBS3 del directorio DATA_PUMP_DIR. La plataforma de origen es AIX-Based Systems (64 bits), con el id. de plataforma 6. Puede encontrar los id. de plataforma consultando 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

(Opcional) Supervise el progreso consultando la tabla rdsadmin.rds_xtts_operation_info. La columna xtts_operation_state muestra el valor EXECUTING, COMPLETED o FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Para ver el registro de la importación finalizada, utilice el ID de la tarea del paso anterior.

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

Asegúrese de que se haya completado correctamente la importación antes de continuar con el siguiente paso.

Inicie un cliente de Oracle SQL e inicie sesión como usuario maestro en su instancia de base de datos de destino de RDS para Oracle.

Ejecute el procedimiento rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces y especifique los espacios de tabla que se van a importar y el directorio que contiene las copias de seguridad.

En el siguiente ejemplo se importan los espacios de tabla TBS1, TBS2 y TBS3 del directorio DATA_PUMP_DIR.

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

(Opcional) Supervise el progreso consultando la tabla rdsadmin.rds_xtts_operation_info. La columna xtts_operation_state muestra el valor EXECUTING, COMPLETED o FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Para ver el registro de la importación finalizada, utilice el ID de la tarea del paso anterior.

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

Asegúrese de que se haya completado correctamente la importación antes de continuar con el siguiente paso.

Realice una instantánea manual de la base de datos siguiendo las instrucciones de Creación de una instantánea de base de datos para una instancia de base de datos single-AZ.

Inicie el cliente de Oracle SQL e inicie sesión como usuario maestro en su instancia de base de datos de destino.

Cree los usuarios que posean esquemas en los espacios de tabla transportados, si estos usuarios aún no existen.

CREATE USER tbs_owner IDENTIFIED BY password;

Importe los metadatos, especificando el nombre del archivo de volcado y su ubicación en el directorio.

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

(Opcional) Consulte la tabla del historial de espacios de tabla transportables para ver el estado de la importación de los metadatos.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Cuando finalice la operación, los espacios de tabla estarán en modo de solo lectura.

(Opcional) Vea el archivo de registro.

En el ejemplo siguiente se muestra el contenido del directorio BDUMP y, a continuación, se consulta el registro de importación.

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'));

Inicie SQL*Plus o SQL Developer e inicie sesión como usuario maestro en su instancia de base de datos de destino.

Valide los espacios de tabla mediante el procedimiento 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;
/

Coloque los espacios de tabla en modo de lectura/escritura.

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

Elimine las copias de seguridad antiguas en DATA_PUMP_DIR de la siguiente manera:

1. Para enumerar los archivos de copia de seguridad, ejecute rdsadmin.rdsadmin_file_util.listdir.

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

2. Para eliminar las copias de seguridad una por una, llame a UTL_FILE.FREMOVE.

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

Si ha importado espacios de tabla pero no ha importado metadatos para estos espacios de tabla, puede eliminar los archivos de datos huérfanos de la siguiente manera:

1. Haga una lista de los archivos de datos huérfanos que debe eliminar. En el siguiente ejemplo se ejecuta el procedimiento rdsadmin.rdsadmin_transport_util.list_xtts_orphan_files.

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

2. Para eliminar los archivos huérfanos, ejecute el procedimiento rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import.

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

   La operación de limpieza genera un archivo de registro que utiliza el formato de nombre rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log del directorio BDUMP.

3. Lea el archivo de registro generado en el paso anterior. En el siguiente ejemplo se lee el registro 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.

Si ha importado espacios de tabla y metadatos para estos espacios de tabla, pero se ha topado con errores de compatibilidad u otros problemas de Oracle Data Pump, limpie los archivos de datos parcialmente transportados de la siguiente manera:

1. Enumere los espacios de tabla que contienen archivos de datos parcialmente transportados mediante consultas DBA_TABLESPACES.

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

2. Elimine los espacios de tabla y los archivos de datos parcialmente transportados.

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;