Migrar usando espaços de tabela transportáveis da Oracle

Faça login no host de origem como proprietário do início do Oracle.

Certifique-se de que as variáveis de ambiente ORACLE_HOME e ORACLE_SID apontem para o banco de dados de origem.

Faça login em seu banco de dados como administrador e verifique se a versão do fuso horário, o conjunto de caracteres do banco de dados e o conjunto de caracteres nacionais são iguais aos do banco de dados de destino.

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

Configure o utilitário de espaços de tabela transportáveis conforme descrito em Oracle Support note 2471245.1.

A configuração inclui a edição do arquivo xtt.properties em seu host de origem. O exemplo de arquivo xtt.properties a seguir especifica backups de três espaços de tabela no diretório /dsk1/backups. Esses são os espaços de tabela que você pretende transportar para a instância de banco de dados de destino. Também especifica o ID da plataforma de origem para converter a extremidade automaticamente.

#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

Se os espaços de tabela estiverem no modo somente leitura, faça login no banco de dados de origem como um usuário que tem o privilégio ALTER TABLESPACE e coloque os espaços de tabela no modo de leitura/gravação. Caso contrário, vá para a próxima etapa.

O exemplo a seguir coloca tbs1, tbs2 e tbs3 no modo de leitura/gravação.

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

Faça backup dos espaços de tabela usando o script xttdriver.pl. Opcionalmente, você pode especificar --debug para executar o script no modo de depuração.

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

Inicie o SQL*Plus ou o Oracle SQL Developer e faça login em sua instância de banco de dados do RDS para Oracle.

Faça download dos backups do bucket do Amazon S3 para a instância de banco de dados de destino usando o procedimento rdsadmin.rdsadmin_s3_tasks.download_from_s3 do Amazon RDS. O exemplo a seguir baixa todos os arquivos de um bucket do Amazon S3 chamado mys3bucket no diretório DATA_PUMP_DIR.

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

A instrução SELECT retorna o ID da tarefa em um tipo de dados VARCHAR2. Para ter mais informações, consulte Baixar arquivos de um bucket do Amazon S3 para uma instância de banco de dados Oracle.

Inicie um cliente Oracle SQL e faça login como usuário principal na instância de banco de dados de destino do RDS para Oracle.

Execute o procedimento rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces, especificando os espaços de tabela que serão importados e o diretório que contém os backups.

O exemplo a seguir importa os espaços de tabela TBS1, TBS2 e TBS3 do diretório DATA_PUMP_DIR. A plataforma de origem é de sistemas baseados em AIX (64 bits), que tem o ID da plataforma de 6. É possível encontrar os IDs da 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) Monitore o progresso consultando a tabela rdsadmin.rds_xtts_operation_info. A coluna xtts_operation_state mostra o valor EXECUTING, COMPLETED ou FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Veja o log da importação concluída usando o ID de tarefa da etapa anterior.

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

Verifique se importação foi bem-sucedida antes de prosseguir para a próxima etapa.

Inicie um cliente Oracle SQL e faça login como usuário principal na instância de banco de dados de destino do RDS para Oracle.

Execute o procedimento rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces, especificando os espaços de tabela que serão importados e o diretório que contém os backups.

O exemplo a seguir importa os espaços de tabela TBS1, TBS2 e TBS3 do diretório DATA_PUMP_DIR.

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

(Opcional) Monitore o progresso consultando a tabela rdsadmin.rds_xtts_operation_info. A coluna xtts_operation_state mostra o valor EXECUTING, COMPLETED ou FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Veja o log da importação concluída usando o ID de tarefa da etapa anterior.

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

Verifique se importação foi bem-sucedida antes de prosseguir para a próxima etapa.

Gere um snapshot manual do banco de dados seguindo as instruções em Criar um snapshot de banco de dados para uma instância de banco de dados de uma única zona de disponibilidade.

Inicie seu cliente Oracle SQL e faça login como usuário principal na instância de banco de dados de destino.

Crie os usuários proprietários de esquemas nos espaços de tabela transportados, caso esses usuários ainda não existam.

CREATE USER tbs_owner IDENTIFIED BY password;

Importe os metadados, especificando o nome do arquivo de despejo e sua localização no diretório.

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

(Opcional) Consulte a tabela de histórico de espaços de tabela transportáveis para ver o status da importação de metadados.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Quando a operação for concluída, os espaços de tabela ficarão no modo somente leitura.

(Opcional) Veja o arquivo de log.

O exemplo a seguir lista o conteúdo do diretório BDUMP, depois consulta o log de importação.

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 o SQL*Plus ou o SQL Developer e faça login como usuário principal em sua instância de banco de dados de destino.

Valide os espaços de tabela usando o procedimento 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 os espaços de tabela no modo de leitura/gravação.

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

Remova os backups antigos em DATA_PUMP_DIR da seguinte forma:

1. Liste os arquivos de backup executando rdsadmin.rdsadmin_file_util.listdir.

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

2. Remova os backups um por um chamando UTL_FILE.FREMOVE.

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

Se você importou espaços de tabela, mas não importou metadados para esses espaços de tabela, poderá excluir os arquivos de dados órfãos da seguinte forma:

1. Liste os arquivos de dados órfãos que você precisa excluir. O exemplo a seguir executa o procedimento 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. Exclua os arquivos órfãos executando o procedimento rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import.

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

   A operação de limpeza gera um arquivo de log que usa o formato de nome rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log no diretório BDUMP.

3. Leia o arquivo de log gerado na etapa anterior. O exemplo a seguir lê o log 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.

Se você importou espaços de tabela e importou metadados para esses espaços de tabela, mas encontrou erros de compatibilidade ou outros problemas do Oracle Data Pump, limpe os arquivos de dados parcialmente transportados da seguinte forma:

1. Liste os espaços de tabela que contêm arquivos de dados parcialmente transportados consultando DBA_TABLESPACES.

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

2. Elimine os espaços de tabela e os arquivos de dados parcialmente transportados.

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;