Prosedur tersimpan untuk database untuk RDS untuk Db2 - Layanan Basis Data Relasional Amazon
rdsadmin.create_databaserdsadmin.deactivate_databaserdsadmin.activate_databaserdsadmin.reactivate_databaserdsadmin.drop_databaserdsadmin.update_db_paramrdsadmin.set_configurationrdsadmin.show_configurationrdsadmin.restore_databaserdsadmin.rollforward_databaserdsadmin.complete_rollforwardrdsadmin.db2pd_commandrdsadmin.force_applicationrdsadmin.set_archive_log_retentionrdsadmin.show_archive_log_retentionrdsadmin.list_archive_log_information

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Prosedur tersimpan untuk database untuk RDS untuk Db2

Prosedur tersimpan bawaan yang dijelaskan dalam topik ini mengelola database untuk Amazon RDS untuk Db2. Untuk menjalankan prosedur ini, pengguna master harus terlebih dahulu terhubung ke rdsadmin database.

Prosedur tersimpan ini digunakan dalam berbagai tugas. Daftar ini tidak lengkap.

Lihat prosedur tersimpan bawaan berikut untuk informasi tentang sintaks, parameter, catatan penggunaan, dan contohnya.

rdsadmin.create_database

Membuat basis data.

Sintaks

db2 "call rdsadmin.create_database('database_name')"

Parameter

catatan

Prosedur tersimpan ini tidak memvalidasi kombinasi parameter yang diperlukan. Saat Anda memanggilrdsadmin.get_task_status, fungsi yang ditentukan pengguna dapat mengembalikan kesalahan karena kombinasidatabase_codeset,database_territory, dan database_collation itu tidak valid. Lihat informasi yang lebih lengkap di Choosing the code page, territory, and collation for your database dalam dokumentasi IBM Db2.

Parameter berikut diperlukan:

database_name

Nama basis data yang akan dibuat. Tipe datanya varchar.

Parameter berikut ini bersifat opsional:

database_page_size

Ukuran halaman default basis data. Nilai yang valid:4096,8192,16384,32768. Tipe datanya integer. Nilai default-nya 8192.

penting

Amazon RDS mendukung atomisitas tulis untuk halaman 4 KiB, 8 KiB, dan 16 KiB. Sebaliknya, 32 halaman KiB berisiko robek, atau sebagian data ditulis ke meja. Jika Anda menggunakan 32 halaman KiB, kami sarankan Anda mengaktifkan point-in-time pemulihan dan pencadangan otomatis. Jika tidak, Anda berisiko tidak dapat pulih dari halaman yang sobek. Untuk informasi selengkapnya, lihat Pengantar cadangan dan Memulihkan instans DB ke waktu yang ditentukan untuk Amazon RDS.

database_code_set

Kode yang ditetapkan untuk database. Tipe datanya varchar. Nilai default-nya UTF-8.

database_territory

Kode negara dua huruf untuk basis data. Tipe datanya varchar. Nilai default-nya US.

database_collation

Urutan pemeriksaan yang menentukan bagaimana string karakter yang disimpan dalam database diurutkan dan dibandingkan. Tipe datanya varchar.

Nilai valid:

  • COMPATIBILITY— Urutan pemeriksaan IBM Db2 Versi 2.

  • EBCDIC_819_037— Halaman kode ISO Latin, pemeriksaan; CCSID 037 (EBCDIC US English).

  • EBCDIC_819_500— Halaman kode ISO Latin, pemeriksaan; CCSID 500 (EBCDIC International).

  • EBCDIC_850_037— Halaman kode Latin ASCII, pemeriksaan; CCSID 037 (EBCDIC US English).

  • EBCDIC_850_500— Halaman kode Latin ASCII, pemeriksaan; CCSID 500 (EBCDIC International).

  • EBCDIC_932_5026— Halaman kode ASCII Jepang, pemeriksaan; CCSID 5026 (EBCDIC US English).

  • EBCDIC_932_5035— Halaman kode ASCII Jepang, pemeriksaan; CCSID 5035 (EBCDIC International).

  • EBCDIC_1252_037— Halaman kode Windows Latin, pemeriksaan; CCSID 037 (EBCDIC US English).

  • EBCDIC_1252_500— Halaman kode Windows Latin, pemeriksaan; CCSID 500 (EBCDIC International).

  • IDENTITY— Pemeriksaan default. String dibandingkan byte untuk byte.

  • IDENTITY_16BIT— Skema Pengkodean Kompatibilitas untuk urutan pemeriksaan UTF-16:8-bit (CESU-8). Untuk informasi selengkapnya, lihat Laporan Teknis Unicode #26 di situs web Unicode Consortium.

  • NLSCHAR— Hanya untuk digunakan dengan halaman kode Thailand (CP874).

  • SYSTEM— Jika Anda menggunakanSYSTEM, database menggunakan urutan pemeriksaan secara otomatis untuk database_codeset dandatabase_territory.

Nilai default-nya IDENTITY.

Selain itu, RDS untuk Db2 mendukung kelompok pengumpulan berikut: dan. language-aware-collation locale-sensitive-collation Untuk informasi selengkapnya, lihat Memilih pemeriksaan untuk database Unicode dalam dokumentasi. IBM Db2

database_autoconfigure_str

Sintaks AUTOCONFIGURE perintah, misalnya,'AUTOCONFIGURE APPLY DB'. Tipe datanya varchar. Defaultnya adalah string kosong atau null.

Lihat informasi yang lebih lengkap di AUTOCONFIGURE command dalam dokumentasi IBM Db2.

Catatan penggunaan

Jika Anda berencana memodifikasi db2_compatibility_vector parameter, ubah parameter sebelum membuat database. Untuk informasi selengkapnya, lihat Mengatur parameter db2_compatibility_vector.

Pertimbangan-pertimbangan khusus:

  • PerintahCREATE DATABASE yang dikirim ke instans Db2 menggunakan opsi RESTRICTIVE.

  • RDS untuk Db2 hanya menggunakan tablespace. AUTOMATIC STORAGE

  • RDS for Db2 menggunakan nilai-nilai default untuk NUMSEGS dan DFT_EXTENT_SZ.

  • RDS for Db2 menggunakan enkripsi penyimpanan dan tidak mendukung enkripsi basis data.

Lihat informasi yang lebih lengkap tentang semua pertimbangan ini di CREATE DATABASE command dalam dokumentasi IBM Db2.

Sebelum memanggil rdsadmin.create_database, Anda harus menghubungi basis data rdsadmin. Dalam contoh berikut, ganti master_username dan master_password dengan RDS Anda untuk informasi instans Db2 DB:

db2 connect to rdsadmin user master_username using master_password

Lihat informasi tentang pemeriksaan status pembuatan basis data di rdsadmin.get_task_status.

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.create_database, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut membuat database yang disebut TESTJP dengan kombinasi yang benar daridatabase_code_set,database_territory, dan database_collation parameter untuk Jepang:

db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"

rdsadmin.deactivate_database

Menonaktifkan database.

Sintaks

db2 "call rdsadmin.deactivate_database(
    ?,
    'database_name')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk dinonaktifkan. Tipe datanya varchar.

Catatan penggunaan

Anda dapat menonaktifkan database untuk menghemat sumber daya memori atau untuk membuat perubahan konfigurasi database lainnya. Untuk mengembalikan database yang dinonaktifkan kembali online, hubungi prosedur yang rdsadmin.activate_database disimpan.

Untuk informasi tentang memeriksa status menonaktifkan database, lihat. rdsadmin.get_task_status

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.deactivate_database, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut menonaktifkan database yang disebut. TESTDB

db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"

rdsadmin.activate_database

Mengaktifkan database.

Untuk informasi selengkapnya tentang perbedaan antara rdsadmin.reactivate_database dan rdsadmin.activate_database, lihat Catatan penggunaan.

Sintaks

db2 "call rdsadmin.activate_database(
    ?,
    'database_name')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk diaktifkan. Tipe datanya varchar.

Catatan penggunaan

Semua database diaktifkan secara default saat dibuat. Jika Anda menonaktifkan database pada instans DB mandiri untuk menghemat sumber daya memori atau untuk membuat perubahan konfigurasi database lainnya, panggil prosedur rdsadmin.activate_database tersimpan untuk mengaktifkan database lagi.

Untuk informasi tentang memeriksa status mengaktifkan database, lihatrdsadmin.get_task_status.

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.activate_database, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut mengaktifkan database yang disebutTESTDB.

db2 "call rdsadmin.activate_database(?, 'TESTDB')"

rdsadmin.reactivate_database

Mengaktifkan kembali database.

Untuk informasi tentang perbedaan antara rdsadmin.activate_database danrdsadmin.reactivate_database, lihatCatatan penggunaan.

Sintaks

db2 "call rdsadmin.reactivate_database(
    ?,
    'database_name')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk mengaktifkan kembali. Tipe datanya varchar.

Catatan penggunaan

Ketika Anda memanggil prosedur rdsadmin.reactivate_database tersimpan, prosedur tersimpan pertama menonaktifkan database dengan memanggil prosedur rdsadmin.deactivate_database tersimpan, dan kemudian mengaktifkan database dengan memanggil prosedur tersimpan. rdsadmin.activate_database

Setelah Anda membuat perubahan pada konfigurasi database, Anda mungkin perlu mengaktifkan kembali database pada RDS untuk instans Db2 DB. Untuk menentukan apakah Anda perlu mengaktifkan kembali database, sambungkan ke database dan jalankandb2 get db cfg show detail.

Untuk database pada instans DB mandiri, Anda dapat menggunakan prosedur rdsadmin.reactivate_database penyimpanan untuk mengaktifkan kembali database. Atau, jika Anda sudah memanggil prosedur rdsadmin.deactivate_database tersimpan, Anda dapat memanggil prosedur yang rdsadmin.activate_database disimpan sebagai gantinya.

Untuk informasi tentang memeriksa status mengaktifkan kembali database, lihat. rdsadmin.get_task_status

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.reactivate_database, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut mengaktifkan kembali database yang disebut. TESTDB

db2 "call rdsadmin.reactivate_database(?, 'TESTDB')"

rdsadmin.drop_database

Mengedrop basis data.

Sintaks

db2 "call rdsadmin.drop_database('database_name')"

Parameter

Parameter berikut diperlukan:

database_name

Nama basis data yang akan didrop. Tipe datanya varchar.

Catatan penggunaan

Anda dapat menjatuhkan database dengan menelepon rdsadmin.drop_database hanya jika kondisi berikut terpenuhi:

  • Anda tidak menentukan nama basis data saat membuat instans basis data RDS for Db2 dengan menggunakan konsol Amazon RDS atau AWS CLI. Untuk informasi selengkapnya, lihat Membuat instans DB.

  • Anda membuat basis data dengan memanggil prosedur tersimpan rdsadmin.create_database.

  • Anda memulihkan basis data dari citra offline atau cadangan dengan memanggil prosedur tersimpan rdsadmin.restore_database.

Sebelum memanggil rdsadmin.drop_database, Anda harus menghubungi basis data rdsadmin. Dalam contoh berikut, ganti master_username dan master_password dengan RDS Anda untuk informasi instans Db2 DB:

db2 connect to rdsadmin user master_username using master_password

Lihat informasi tentang pemeriksaan status pengedropan basis data di rdsadmin.get_task_status.

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.drop_database, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut menjatuhkan database yang disebutTESTDB:

db2 "call rdsadmin.drop_database('TESTDB')"

rdsadmin.update_db_param

Memperbarui parameter-parameter basis data.

Sintaks

db2 "call rdsadmin.update_db_param(
    'database_name', 
    'parameter_to_modify', 
    'changed_value)"

Parameter

Parameter-parameter berikut diperlukan:

database_name

Nama database untuk menjalankan tugas. Tipe datanya varchar.

parameter_to_modify

Nama parameter yang akan diubah. Tipe datanya varchar. Untuk informasi selengkapnya, lihat Amazon RDS untuk parameter Db2.

changed_value

Nilai untuk mengubah nilai parameter. Tipe datanya varchar.

Catatan penggunaan

Lihat informasi tentang pemeriksaan status pembaruan parameter basis data di rdsadmin.get_task_status.

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.update_db_param, lihatKesalahan prosedur tersimpan.

Contoh

Contoh 1: Memperbarui parameter

Contoh berikut memperbarui archretrydelay parameter 100 untuk database yang disebutTESTDB:

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'archretrydelay', 
    '100')"

Contoh 2: Menunda validasi objek

Contoh berikut menunda validasi objek yang dibuat pada database yang dipanggil TESTDB untuk menghindari pemeriksaan ketergantungan:

db2 "call rdsadmin.update_db_param(
    'TESTDB', 
    'auto_reval', 
    'deferred_force')"

rdsadmin.set_configuration

Mengkonfigurasi pengaturan khusus untuk database.

Sintaks

db2 "call rdsadmin.set_configuration(
    'name',  
    'value')"

Parameter

Parameter-parameter berikut diperlukan:

name

Nama pengaturan konfigurasi. Tipe datanya varchar.

value

Nilai untuk pengaturan konfigurasi. Tipe datanya varchar.

Catatan penggunaan

Tabel berikut menunjukkan pengaturan konfigurasi yang dapat Anda kontrolrdsadmin.set_configuration.

Nama Penjelasan

RESTORE_DATABASE_NUM_BUFFERS

Jumlah buffer yang akan dibuat selama operasi pemulihan. Nilai ini harus kurang dari ukuran memori total kelas instans DB. Jika pengaturan ini tidak dikonfigurasi, Db2 menentukan nilai yang akan digunakan selama operasi pemulihan. Lihat informasi yang lebih lengkap dalam dokumentasi IBM Db2.

RESTORE_DATABASE_PARALLELISM

Jumlah manipulator buffer yang akan dibuat selama operasi pemulihan. Nilai ini harus kurang dari dua kali lipat jumlah v CPUs untuk instance DB. Jika pengaturan ini tidak dikonfigurasi, Db2 menentukan nilai yang akan digunakan selama operasi pemulihan. Lihat informasi yang lebih lengkap dalam dokumentasi IBM Db2.

Contoh

Contoh 1: Menentukan jumlah manipulator buffer untuk membuat

Contoh berikut menetapkan RESTORE_DATABASE_PARALLELISM konfigurasi ke8.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_PARALLELISM', 
    '8')"

Contoh 2: Menentukan jumlah buffer untuk membuat

Contoh berikut menetapkan RESTORE_DATABASE_NUM_BUFFERS konfigurasi ke150.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_BUFFERS', 
    '150')"

rdsadmin.show_configuration

Mengembalikan pengaturan saat ini yang dapat Anda atur dengan menggunakan prosedur yang disimpanrdsadmin.set_configuration.

Sintaks

db2 "call rdsadmin.show_configuration(
    'name')"

Parameter

Parameter berikut bersifat opsional:

name

Nama pengaturan konfigurasi untuk mengembalikan informasi tentang. Tipe datanya varchar.

Nama konfigurasi berikut valid:

  • RESTORE_DATABASE_NUM_BUFFERS — Jumlah buffer yang akan dibuat selama operasi pemulihan.

  • RESTORE_DATABASE_PARALLELISM — Jumlah manipulator buffer yang dibuat selama operasi pemulihan.

Catatan penggunaan

Jika Anda tidak menentukan nama pengaturan konfigurasi, rdsadmin.show_configuration mengembalikan informasi untuk semua pengaturan konfigurasi yang dapat Anda atur dengan menggunakan prosedur tersimpanrdsadmin.set_configuration.

Contoh

Contoh berikut mengembalikan informasi tentang RESTORE_DATABASE_PARALLELISM konfigurasi saat ini.

db2 "call rdsadmin.show_configuration(
    'RESTORE_DATABASE_PARALLELISM')"

rdsadmin.restore_database

Memulihkan database dari bucket Amazon S3 ke RDS untuk instans Db2 DB.

Sintaks

db2 "call rdsadmin.restore_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    restore_timestamp, 
    'backup_type')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database target untuk mengembalikan dalam RDS untuk Db2. Tipe datanya varchar.

Misalnya, jika nama database sumber adalah TESTDB dan Anda mengatur database_name keNEWDB, maka Amazon RDS mengembalikan NEWDB sebagai database sumber.

s3_bucket_name

Nama bucket Amazon S3 tempat cadangan Anda berada. Tipe datanya varchar.

s3_prefix

Awalan yang digunakan untuk pencocokan file selama pengunduhan. Tipe datanya varchar.

Jika parameter ini kosong, maka semua file di bucket Amazon S3 akan diunduh. Berikut ini adalah contoh awalan:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101
restore_timestamp

Stempel waktu citra cadangan basis data. Tipe datanya varchar.

Stempel waktu disertakan dalam nama file cadangan. Misalnya, 20230615010101 adalah stempel waktu untuk nama file SAMPLE.0.rdsdb.DBPART000.20230615010101.001.

backup_type

Jenis cadangan. Tipe datanya varchar. Nilai-nilai yang valid: OFFLINE, ONLINE.

Gunakan ONLINE untuk migrasi waktu henti nyaris nol. Untuk informasi selengkapnya, lihat Migrasi dari Linux kepada Linux dengan downtime mendekati nol untuk Amazon untuk Db2 RDS.

Catatan penggunaan

Anda dapat menggunakan prosedur tersimpan ini untuk memigrasikan database Db2 ke RDS untuk instans Db2 DB. Untuk informasi selengkapnya, lihat Menggunakan AWS layanan untuk memigrasikan data dari Db2 ke Amazon untuk Db2 RDS. Anda juga dapat menggunakan prosedur tersimpan ini untuk membuat beberapa salinan dari database yang sama dengan nama database berbeda yang menggunakan gambar pemulihan yang sama.

Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:

  • Sebelum memulihkan database, Anda harus menyediakan ruang penyimpanan untuk RDS Anda untuk instans Db2 DB yang sama dengan atau lebih besar dari jumlah ukuran cadangan Anda dan database Db2 asli pada disk. Untuk informasi selengkapnya, lihat Insufficient disk space.

  • Saat Anda memulihkan cadangan, Amazon RDS mengekstrak file cadangan pada instans basis data RDS for Db2 Anda. Setiap file cadangan harus 5 TB atau lebih kecil. Jika file cadangan melebihi 5 TB, Anda harus membagi file cadangan tersebut ke dalam beberapa file yang lebih kecil.

  • Untuk mengembalikan semua file menggunakan prosedur rdsadmin.restore_database tersimpan, jangan sertakan akhiran nomor file setelah stempel waktu dalam nama file. Misalnya, s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101 mengembalikan file-file berikut:

    SAMPLE.0.rdsdb.DBPART000.20230615010101.001
SAMPLE.0.rdsdb.DBPART000.20230615010101.002
SAMPLE.0.rdsdb.DBPART000.20230615010101.003
SAMPLE.0.rdsdb.DBPART000.20230615010101.004
SAMPLE.0.rdsdb.DBPART000.20230615010101.005

  • RDS untuk Db2 tidak mendukung penyimpanan non-otomatis. Untuk informasi selengkapnya, lihat Tablespaces not restored.

  • RDS untuk Db2 tidak mendukung rutinitas yang tidak berpagar. Untuk informasi selengkapnya, lihat Non-fenced routines not allowed.

  • Untuk meningkatkan kinerja operasi pemulihan database, Anda dapat mengonfigurasi jumlah buffer dan manipulator buffer untuk RDS untuk digunakan. Untuk memeriksa konfigurasi saat ini, gunakanrdsadmin.show_configuration. Untuk mengubah konfigurasi, gunakanrdsadmin.set_configuration.

Lihat cara membawa online basis data dan menerapkan log transaksi tambahan setelah memulihkan basis data di rdsadmin.rollforward_database.

Lihat informasi tentang pemeriksaan status pemulihan basis data Anda di rdsadmin.get_task_status.

Untuk pesan kesalahan yang ditampilkan saat meneleponrdsadmin.restore_database, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut mengembalikan cadangan offline dengan satu file atau beberapa file yang memiliki: s3_prefix backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

db2 "call rdsadmin.restore_database(
    ?,
    'SAMPLE',
    'amzn-s3-demo-bucket',
    'backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101',
    20230615010101,
    'OFFLINE')"

rdsadmin.rollforward_database

Membawa online basis data dan menerapkan log transaksi tambahan setelah memulihkan basis data dengan memanggil rdsadmin.restore_database.

Sintaks

db2 "call rdsadmin.rollforward_database(
    ?,
    'database_name',
    's3_bucket_name', 
    s3_prefix, 
    'rollforward_to_option', 
    'complete_rollforward')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk melakukan operasi pada. Tipe datanya varchar.

s3_bucket_name

Nama bucket Amazon S3 tempat cadangan Anda berada. Tipe datanya varchar.

s3_prefix

Awalan yang digunakan untuk pencocokan file selama pengunduhan. Tipe datanya varchar.

Jika parameter ini kosong, maka semua file di bucket S3 akan diunduh. Contoh berikut adalah contoh awalan:

backupfolder/SAMPLE.0.rdsdb.DBPART000.20230615010101

Parameter input berikut adalah opsional:

rollforward_to_option

Titik yang ingin Anda tuju untuk pengguliran maju. Tipe datanya varchar. Nilai-nilai yang valid: END_OF_LOGS, END_OF_BACKUP. Nilai default-nya END OF LOGS.

complete_rollforward

Menentukan apakah untuk menyelesaikan proses roll-forward. Tipe datanya varchar. Nilai default-nya TRUE.

Jika TRUE, maka setelah selesai, basis data akan online dan dapat diakses. Jika FALSE, maka basis data tetap dalam keadaan ROLL-FORWARD PENDING.

Catatan penggunaan

Setelah memanggil rdsadmin.restore_database, Anda harus memanggil rollforward_database untuk menerapkan log arsip dari bucket S3. Anda juga dapat menggunakan prosedur tersimpan ini untuk memulihkan log transaksi tambahan setelah memanggil rdsadmin.restore_database.

Jika Anda mengatur complete_rollforward ke FALSE, maka basis data Anda dalam keadaan ROLL-FORWARD PENDING dan offline. Untuk membawa database online, Anda harus meneleponrdsadmin.complete_rollforward.

Lihat informasi tentang pemeriksaan status pengguliran maju basis data di rdsadmin.get_task_status.

Contoh

Contoh 1: Membawa database dengan log transaksi online

Contoh berikut bergulir ke cadangan online database dengan log transaksi dan kemudian membawa database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    null,
    null,
    'END_OF_LOGS',
    'TRUE')"

Contoh 2: Membawa database tanpa log transaksi online

Contoh berikut bergulir ke cadangan online database tanpa log transaksi, dan kemudian membawa database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/,
    'END_OF_BACKUP',
    'TRUE')"

Contoh 3: Tidak membawa database dengan log transaksi online

Contoh berikut bergulir ke backup online database dengan log transaksi, dan kemudian tidak membawa database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    null,
    'onlinebackup/TESTDB',
    'END_OF_LOGS',
    'FALSE')"

Contoh 4: Tidak membawa database dengan log transaksi tambahan secara online

Contoh berikut bergulir ke backup online database dengan log transaksi tambahan, dan kemudian tidak membawa database online:

db2 "call rdsadmin.rollforward_database(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'logsfolder/S0000155.LOG',
    'END_OF_LOGS',
    'FALSE')"

rdsadmin.complete_rollforward

Membawa online basis data dari keadaan ROLL-FORWARD PENDING.

Sintaks

db2 "call rdsadmin.complete_rollforward(
    ?,
    'database_name')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama basis data yang ingin Anda bawa online. Tipe datanya varchar.

Catatan penggunaan

Jika Anda menelepon rdsadmin.rollforward_database dengan complete_rollforward set toFALSE, maka database Anda dalam ROLL-FORWARD PENDING keadaan dan offline. Untuk menyelesaikan proses pengguliran maju dan membawa online basis data, panggil rdsadmin.complete_rollforward.

Lihat informasi tentang memeriksa status penyelesaian proses pengguliran maju di rdsadmin.get_task_status.

Contoh

Contoh berikut membawa TESTDB database online:

db2 "call rdsadmin.complete_rollforward(
    ?,
    'TESTDB')"

rdsadmin.db2pd_command

Mengumpulkan informasi tentang RDS untuk database Db2.

Sintaks

db2 "call rdsadmin.db2pd_command('db2pd_cmd')"

Parameter

Parameter input berikut diperlukan:

db2pd_cmd

Nama db2pd perintah yang ingin Anda jalankan. Tipe datanya varchar.

Parameter harus dimulai dengan tanda hubung. Untuk daftar parameter, lihat db2pd - Memantau dan memecahkan masalah perintah database Db2 dalam dokumentasi. IBM Db2

Opsi berikut tidak didukung:

  • -addnode

  • -alldatabases

  • -alldbp

  • -alldbs

  • -allmembers

  • -alm_in_memory

  • -cfinfo

  • -cfpool

  • -command

  • -dbpartitionnum

  • -debug

  • -dump

  • -everything

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    catatan

    -pages summary didukung.

  • -pdcollection

  • -repeat

  • -stack

  • -totalmem

fileSubopsi tidak didukung, misalnya,. db2pd -db testdb -tcbstats file=tcbstat.out

Penggunaan stacks opsi tidak didukung, misalnya,db2pd -edus interval=5 top=10 stacks.

Catatan penggunaan

Prosedur tersimpan ini mengumpulkan informasi yang dapat membantu pemantauan dan pemecahan masalah RDS untuk database Db2.

Prosedur yang disimpan menggunakan IBM db2pd utilitas untuk menjalankan berbagai perintah. db2pdUtilitas memerlukan SYSADM otorisasi, yang tidak dimiliki oleh pengguna master RDS untuk Db2. Namun, dengan prosedur tersimpan Amazon RDS, pengguna master dapat menggunakan utilitas untuk menjalankan berbagai perintah. Untuk informasi lebih lanjut tentang utilitas, lihat db2pd - Memantau dan memecahkan masalah perintah database Db2 dalam dokumentasi. IBM Db2

Output dibatasi hingga maksimum 2 GB.

Untuk informasi tentang memeriksa status pengumpulan informasi tentang database, lihatrdsadmin.get_task_status.

Contoh

Contoh 1: Mengembalikan uptime instans DB

Contoh berikut mengembalikan uptime dari RDS untuk contoh Db2 DB:

db2 "call rdsadmin.db2pd_command('-')"

Contoh 2: Mengembalikan uptime database

Contoh berikut mengembalikan uptime dari database yang disebutTESTDB:

db2 "call rdsadmin.db2pd_command('-db TESTDB -')"

Contoh 3: Mengembalikan penggunaan memori instans DB

Contoh berikut mengembalikan penggunaan memori RDS untuk contoh Db2 DB:

db2 "call rdsadmin.db2pd_command('-dbptnmem')"

Contoh 4: Mengembalikan set memori instans dan database DB

Contoh berikut mengembalikan set memori RDS untuk contoh Db2 DB dan database yang disebut: TESTDB

db2 "call rdsadmin.db2pd_command('-inst -db TESTDB -memsets')"

rdsadmin.force_application

Memaksa aplikasi dari RDS untuk database Db2.

Sintaks

db2 "call rdsadmin.force_application(
    ?,
    'applications')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

applications

Aplikasi yang ingin Anda paksa dari RDS untuk database Db2. Tipe datanya varchar. Nilai yang benar: ALL atau application_handle.

Pisahkan nama beberapa aplikasi dengan koma. Contoh: 'application_handle_1,application_handle_2'.

Catatan penggunaan

Prosedur tersimpan ini memaksa semua aplikasi keluar dari database sehingga Anda dapat melakukan pemeliharaan.

Prosedur yang disimpan menggunakan IBM FORCE APPLICATION perintah. FORCE APPLICATIONPerintah membutuhkanSYSADM,SYSMAINT, atau SYSCTRL otorisasi, yang tidak dimiliki oleh pengguna master RDS untuk Db2. Namun, dengan prosedur tersimpan Amazon RDS, pengguna master dapat menggunakan perintah tersebut. Untuk informasi selengkapnya, lihat perintah FORCE APPLICATION dalam IBM Db2 dokumentasi.

Untuk informasi tentang memeriksa status memaksa aplikasi keluar dari database, lihatrdsadmin.get_task_status.

Contoh

Contoh 1: Menentukan semua aplikasi

Contoh berikut memaksa semua aplikasi off dari RDS untuk database Db2:

db2 "call rdsadmin.force_application(
    ?,
    'ALL')"

Contoh 2: Menentukan beberapa aplikasi

Contoh berikut memaksa menangani aplikasi9991,8891, dan 1192 off dari RDS untuk database Db2:

db2 "call rdsadmin.force_application(
    ?,
    '9991, 8891, 1192')"

rdsadmin.set_archive_log_retention

Mengkonfigurasi jumlah waktu (dalam jam) untuk menyimpan file log arsip untuk RDS yang ditentukan untuk database Db2.

Sintaks

db2 "call rdsadmin.set_archive_log_retention(
    ?,            
    'database_name',  
    'archive_log_retention_hours')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk mengonfigurasi penyimpanan log arsip untuk. Tipe datanya varchar.

archive_log_retention_hours

Jumlah jam untuk menyimpan file log arsip. Tipe datanya smallint. Defaultnya adalah0, dan maksimum adalah 168 (7 hari).

Jika nilainya0, Amazon RDS tidak menyimpan file log arsip.

Catatan penggunaan

Secara default, RDS untuk Db2 mempertahankan log selama 5 menit. Sebaiknya jika Anda menggunakan alat replikasi seperti AWS DMS untuk pengambilan data perubahan (CDC) atauIBM Q Replication, Anda mengatur retensi log di alat tersebut selama lebih dari 5 menit.

Anda dapat melihat pengaturan penyimpanan log arsip saat ini dengan meneleponrdsadmin.show_archive_log_retention.

Anda tidak dapat mengonfigurasi pengaturan penyimpanan log arsip pada rdsadmin database.

Contoh

Contoh 1: Mengatur waktu retensi

Contoh berikut menetapkan waktu penyimpanan log arsip untuk database yang dipanggil TESTDB ke 24 jam.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '24')"

Contoh 2: Menonaktifkan waktu retensi

Contoh berikut menonaktifkan penyimpanan log arsip untuk database yang disebutTESTDB.

db2 "call rdsadmin.set_archive_log_retention(
    ?,
    'TESTDB', 
    '0')"

rdsadmin.show_archive_log_retention

Mengembalikan pengaturan penyimpanan log arsip saat ini untuk database tertentu.

Sintaks

db2 "call rdsadmin.show_archive_log_retention(
    ?,
    'database_name')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk menampilkan pengaturan penyimpanan log arsip untuk. Tipe datanya varchar.

Contoh

Contoh berikut menunjukkan pengaturan penyimpanan log arsip untuk database yang disebutTESTDB.

db2 "call rdsadmin.show_archive_log_retention(
    ?
    'TESTDB')"

rdsadmin.list_archive_log_information

Mengembalikan rincian tentang file log arsip, seperti ukuran, tanggal pembuatan dan waktu, dan nama file log individu untuk database yang ditentukan. Ini juga mengembalikan jumlah penyimpanan total yang digunakan oleh file log dalam database.

Sintaks

db2 "call rdsadmin.list_archive_log_information(
    ?,
    'database_name')"

Parameter

Parameter output berikut diperlukan:

?

Penanda parameter yang mengeluarkan pesan kesalahan. Parameter ini hanya menerima. ?

Parameter input berikut diperlukan:

database_name

Nama database untuk mencantumkan informasi log arsip untuk. Tipe datanya varchar.

Contoh

Contoh berikut mengembalikan informasi log arsip untuk database yang disebutTESTDB.

db2 "call rdsadmin.list_archive_log_information(
    ?
    'TESTDB')"