Migration à l'aide des espaces de table transportables Oracle

Connectez-vous à votre hôte source en tant que propriétaire de votre répertoire de base Oracle.

Assurez-vous que vos variables d'environnement ORACLE_HOME et ORACLE_SID pointent vers votre base de données source.

Connectez-vous à votre base de données en tant qu'administrateur et vérifiez que la version de fuseau horaire, le jeu de caractères de base de données et le jeu de caractères national sont identiques à ceux de votre base de données cible.

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

Configurez l'utilitaire d'espace de table transportable comme décrit dans la note de support Oracle 2471245.1 (langue française non garantie).

La configuration inclut la modification du fichier xtt.properties sur votre hôte source. L'exemple de fichier xtt.properties suivant spécifie les sauvegardes de trois espaces de table dans le répertoire /dsk1/backups. Il s'agit des espaces de table que vous souhaitez transporter vers votre instance de base de données cible. Il spécifie également l'identifiant de la plateforme source pour convertir automatiquement l'endianisme.

#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 vos espaces de table sont en mode lecture seule, connectez-vous à votre base de données source en tant qu'utilisateur disposant du privilège ALTER TABLESPACE et placez vos espaces de table en mode lecture/écriture. Sinon, passez à l'étape suivante.

L'exemple suivant place tbs1, tbs2 et tbs3 en mode lecture/écriture.

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

Sauvegardez vos espaces de table à l'aide du script xttdriver.pl. Vous pouvez éventuellement spécifier --debug pour exécuter le script en mode débogage.

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

Démarrez SQL *Plus ou Oracle SQL Developer et connectez-vous à votre instance de base de données RDS pour Oracle.

Téléchargez les sauvegardes depuis le compartiment Amazon S3 vers votre instance de base de données cible en utilisant la RDS procédure Amazon rdsadmin.rdsadmin_s3_tasks.download_from_s3 pour d. L'exemple suivant télécharge tous les fichiers d'un compartiment Amazon S3 nommé amzn-s3-demo-bucket vers le répertoire 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;

L'instruction SELECT renvoie l'ID de la tâche dans un type de données VARCHAR2. Pour de plus amples informations, veuillez consulter Téléchargement des fichiers d'un compartiment Amazon S3 vers une instance de base de données Oracle.

Démarrez un SQL client Oracle et connectez-vous à votre instance de base RDS de données cible Oracle en tant qu'utilisateur principal.

Exécutez la procédure rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces en spécifiant les espaces de table à importer et le répertoire contenant les sauvegardes.

L'exemple suivant importe les tablespaces TBS1TBS2, et TBS3 depuis le répertoire. DATA_PUMP_DIR La plate-forme source est AIX Based Systems (64 bits), dont l'ID de plate-forme est6. Vous pouvez trouver la plateforme IDs en V$TRANSPORTABLE_PLATFORM interrogeant.

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

(Facultatif) Surveillez la progression en interrogeant la table rdsadmin.rds_xtts_operation_info. La colonne xtts_operation_state indique la valeur EXECUTING, COMPLETED ou FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Consultez le journal de l'importation terminée en utilisant l'ID de tâche issu de l'étape précédente.

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

Assurez-vous de la réussite de l'importation avant de passer à l'étape suivante.

Démarrez un SQL client Oracle et connectez-vous à votre instance de base RDS de données cible Oracle en tant qu'utilisateur principal.

Exécutez la procédure rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces en spécifiant les espaces de table à importer et le répertoire contenant les sauvegardes.

L'exemple suivant importe les tablespaces TBS1TBS2, et TBS3 depuis le répertoire. DATA_PUMP_DIR

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

(Facultatif) Surveillez la progression en interrogeant la table rdsadmin.rds_xtts_operation_info. La colonne xtts_operation_state indique la valeur EXECUTING, COMPLETED ou FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Consultez le journal de l'importation terminée en utilisant l'ID de tâche issu de l'étape précédente.

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

Assurez-vous de la réussite de l'importation avant de passer à l'étape suivante.

Prenez un instantané de base de données manuel en suivant les instructions fournies dans Création d'un instantané de base de données pour une instance de base de données mono-AZ pour Amazon RDS.

Démarrez votre SQL client Oracle et connectez-vous à votre instance de base de données cible en tant qu'utilisateur principal.

Créez les utilisateurs propriétaires des schémas dans vos espaces de table transportés, si ces utilisateurs n'existent pas encore.

CREATE USER tbs_owner IDENTIFIED BY password;

Importez les métadonnées en spécifiant le nom du fichier de vidage et l'emplacement du répertoire.

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

(Facultatif) Interrogez la table d'historique des espaces de table transportables pour voir le statut de l'importation des métadonnées.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Une fois l'opération terminée, vos espaces de table sont en mode lecture seule.

(Facultatif) Affichez le fichier journal.

L'exemple suivant répertorie le contenu du BDUMP répertoire, puis interroge le journal d'importation.

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

Démarrez SQL *Plus ou SQL Developer et connectez-vous à votre instance de base de données cible en tant qu'utilisateur principal.

Validez les espaces de table à l'aide de la procédure 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;
/

Placez vos espaces de table en mode lecture/écriture.

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

Supprimez les anciennes sauvegardes DATA_PUMP_DIR comme suit :

1. Répertoriez les fichiers de sauvegarde en exécutant rdsadmin.rdsadmin_file_util.listdir.

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

2. Supprimez les sauvegardes une par une en appelant UTL_FILE.FREMOVE.

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

Si vous avez importé des espaces de table mais n'avez pas importé de métadonnées pour ces espaces de table, vous pouvez supprimer les fichiers de données orphelins comme suit :

1. Répertoriez les fichiers de données orphelins que vous devez supprimer. L'exemple suivant exécute la procédure 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. Supprimez les fichiers orphelins en exécutant la procédure rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import.

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

   L'opération de nettoyage génère un fichier journal qui utilise le format de nom rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log dans le répertoire BDUMP.

3. Lisez le fichier journal généré à l'étape précédente. L'exemple suivant lit le journal 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 vous avez importé des espaces de table et importé des métadonnées pour ces espaces de table, mais que vous avez rencontré des erreurs de compatibilité ou d'autres problèmes liés à Oracle Data Pump, nettoyez les fichiers de données partiellement transportés comme suit :

1. Répertoriez les espaces de table qui contiennent des fichiers de données partiellement transportés en interrogeant DBA_TABLESPACES.

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

2. Supprimez les espaces de table et les fichiers de données partiellement transportés.

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;