Bermigrasi menggunakan tablespace yang dapat dipindahkan Oracle

Masuk ke host sumber sebagai pemilik beranda Oracle.

Pastikan variabel lingkungan ORACLE_HOME dan ORACLE_SID mengarah ke basis data sumber Anda.

Masuk ke basis data sebagai administrator, dan pastikan versi zona waktu, set karakter DB, dan set karakter nasional sama dengan yang ada di basis data target.

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

Siapkan utilitas tablespace yang dapat dipindahkan seperti yang dijelaskan di Oracle Support note 2471245.1.

Penyiapan termasuk mengedit file xtt.properties di host sumber Anda. Sampel file xtt.properties berikut menetapkan pencadangan tiga tablespace di dalam direktori /dsk1/backups. Ketiganya adalah tablespace yang akan Anda pindahkan ke instans DB target. Sampel tersebut juga menentukan ID platform sumber untuk mengonversi endian secara otomatis.

#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

Jika tablespace Anda dalam mode hanya baca, masuk ke basis data sumber Anda sebagai pengguna dengan hak akses ALTER TABLESPACE, dan ubah modenya menjadi baca/tulis. Jika tidak, lewati ke langkah berikutnya.

Contoh berikut menempatkan tbs1, tbs2, dan tbs3 dalam mode baca/tulis.

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

Cadangkan tablespace Anda menggunakan skrip xttdriver.pl. Secara opsional, Anda dapat menentukan --debug untuk menjalankan skrip dalam mode debug.

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

Mulailah SQL *Plus atau Oracle SQL Developer dan masuk ke instans Oracle RDS DB Anda.

Unduh cadangan dari bucket Amazon S3 ke instans DB target Anda dengan menggunakan prosedur RDS Amazon rdsadmin.rdsadmin_s3_tasks.download_from_s3 ke d. Contoh berikut ini mengunduh semua file dari bucket Amazon S3 bernama amzn-s3-demo-bucket ke direktori 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;

Pernyataan SELECT mengembalikan ID tugas dalam jenis data VARCHAR2. Untuk informasi selengkapnya, lihat Mengunduh file dari bucket Amazon S3 ke instans DB Oracle.

Mulai SQL klien Oracle dan masuk ke target RDS Anda untuk instans Oracle DB sebagai pengguna utama.

Jalankan prosedur rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces, tentukan tablespace yang akan diimpor dan direktori yang berisi cadangan.

Contoh berikut mengimpor tablespaces TBS1, TBS2, dan TBS3 dari direktori DATA_PUMP_DIR. Platform sumbernya adalah AIX Based Systems (64-bit), yang memiliki ID platform6. Anda dapat menemukan platform IDs dengan menanyakanV$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

(Opsional) Pantau kemajuan dengan membuat kueri tabel rdsadmin.rds_xtts_operation_info. Kolom xtts_operation_state menampilkan nilai EXECUTING, COMPLETED, atau FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Lihat log impor yang telah selesai menggunakan ID tugas dari langkah sebelumnya.

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

Pastikan impor sudah berhasil sebelum melanjutkan ke langkah berikutnya.

Mulai SQL klien Oracle dan masuk ke target RDS Anda untuk instans Oracle DB sebagai pengguna utama.

Jalankan prosedur rdsadmin.rdsadmin_transport_util.import_xtts_tablespaces, tentukan tablespace yang akan diimpor dan direktori yang berisi cadangan.

Contoh berikut mengimpor tablespaces TBS1, TBS2, dan TBS3 dari direktori DATA_PUMP_DIR.

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

(Opsional) Pantau kemajuan dengan membuat kueri tabel rdsadmin.rds_xtts_operation_info. Kolom xtts_operation_state menampilkan nilai EXECUTING, COMPLETED, atau FAILED.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Lihat log impor yang telah selesai menggunakan ID tugas dari langkah sebelumnya.

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

Pastikan impor sudah berhasil sebelum melanjutkan ke langkah berikutnya.

Ambil snapshot DB manual dengan mengikuti petunjuk di Membuat snapshot DB untuk instans DB AZ tunggal untuk Amazon RDS.

Mulai SQL klien Oracle Anda dan masuk ke instans DB target Anda sebagai pengguna utama.

Buat pengguna yang memiliki skema di tablespace yang dipindahkan, jika pengguna tersebut belum ada.

CREATE USER tbs_owner IDENTIFIED BY password;

Impor metadata, tentukan nama file dump dan lokasi direktorinya.

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

(Opsional) Kueri tabel riwayat tablespace yang dapat dipindahkan untuk melihat status impor metadata.

SELECT * FROM rdsadmin.rds_xtts_operation_info;

Setelah operasi selesai, tablespace Anda berada dalam mode hanya baca.

(Opsional) Lihat file log.

Contoh berikut mencantumkan isi BDUMP direktori dan kemudian query log impor.

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

Mulailah SQL *Plus atau SQL Pengembang dan masuk ke instans DB target Anda sebagai pengguna utama.

Validasi tablespace menggunakan prosedur 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;
/

Posisikan tablespace Anda ke dalam mode baca/tulis.

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

Hapus cadangan lama di DATA_PUMP_DIR sebagai berikut:

1. Buat daftar file cadangan dengan menjalankan rdsadmin.rdsadmin_file_util.listdir.

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

2. Hapus cadangan satu per satu dengan memanggil UTL_FILE.FREMOVE.

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

Jika Anda mengimpor tablespace tetapi tidak mengimpor metadatanya, Anda dapat menghapus file data tanpa induk sebagai berikut:

1. Buat daftar file data tanpa induk yang perlu dihapus. Contoh berikut menjalankan prosedur 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. Hapus file tanpa induk dengan menjalankan prosedur rdsadmin.rdsadmin_transport_util.cleanup_incomplete_xtts_import.

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

   Operasi pembersihan menghasilkan file log yang menggunakan format nama rds-xtts-delete_xtts_orphaned_files-YYYY-MM-DD.HH24-MI-SS.FF.log dalam direktori BDUMP.

3. Baca file log yang dihasilkan pada langkah sebelumnya. Contoh berikut membaca 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.

Jika Anda mengimpor tablespace beserta metadatanya, tetapi terjadi kesalahan kompatibilitas atau masalah Oracle Data Pump lainnya, bersihkan file data yang dipindahkan sebagian sebagai berikut:

1. Buat daftar tablespace yang berisi file data yang dipindahkan sebagian dengan kueri DBA_TABLESPACES.

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

2. Hapus tabelspace dan file data yang dipindahkan sebagian.

   DROP TABLESPACE TBS_3 INCLUDING CONTENTS AND DATAFILES;