Prosedur tersimpan untuk database untuk RDS untuk Db2 - Layanan Basis Data Relasional Amazon
rdsadmin.create_databaserdsadmin.deactivate_databaserdsadmin.activate_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_retention

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. Untuk informasi selengkapnya, lihat Memilih halaman kode, wilayah, dan pemeriksaan untuk database Anda di IBM Db2 dokumentasi.

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. Default-nya adalah 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, silakan lihat Pengantar cadangan dan Memulihkan instans DB ke waktu tertentu untuk Amazon RDS.

database_code_set

Kode yang ditetapkan untuk database. Tipe datanya varchar. Default-nya adalah UTF-8.

database_territory

Kode negara dua huruf untuk basis data. Tipe datanya varchar. Default-nya adalah 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 (Inggris EBCDIC AS).

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

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

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

  • EBCDIC_932_5026— Halaman kode ASCII Jepang, pemeriksaan; CCSID 037 (Inggris EBCDIC AS).

  • EBCDIC_932_5035— Halaman kode ASCII Jepang, pemeriksaan; CCSID 500 (EBCDICInternasional).

  • EBCDIC_1252_037— Halaman kode Windows Latin, pemeriksaan; CCSID 037 (Bahasa Inggris EBCDIC AS).

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

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

  • IDENTITY_16BIT— Skema Pengkodean Kompatibilitas untuk urutan UTF pemeriksaan -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.

Default-nya adalah 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 di IBM Db2 dokumentasi.

database_autoconfigure_str

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

Untuk informasi selengkapnya, silakan lihat AUTOCONFIGURE perintah di IBM Db2 dokumentasi.

Catatan penggunaan

Jika Anda berencana untuk 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.

  • RDSuntuk Db2 hanya menggunakan AUTOMATIC STORAGE tablespaces.

  • RDSuntuk Db2 menggunakan nilai default untuk NUMSEGS dan. DFT_EXTENT_SZ

  • RDSuntuk Db2 menggunakan enkripsi penyimpanan dan tidak mendukung enkripsi basis data.

Untuk informasi lebih lanjut tentang pertimbangan ini, lihat CREATE DATABASE perintah di IBM Db2 dokumentasi.

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

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, lihatMemecahkan masalah kesalahan dari prosedur yang disimpan.

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. Untuk mengembalikan basis data yang dinonaktifkan secara online, hubungi prosedur yang rdsadmin.activate_database disimpan.

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

Contoh

Contoh berikut menonaktifkan database yang disebut. TESTDB

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

rdsadmin.activate_database

Mengaktifkan database.

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 ketika mereka dibuat. Jika Anda menonaktifkan database untuk menghemat sumber daya memori, panggil prosedur yang rdsadmin.activate_database disimpan untuk mengaktifkannya lagi.

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

Contoh

Contoh berikut mengaktifkan database yang disebutTESTDB.

db2 "call rdsadmin.activate_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 database saat membuat instans RDS untuk Db2 DB dengan menggunakan RDS konsol Amazon 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 informasi instans Db2 DB Anda RDS untuk:

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, lihatMemecahkan masalah kesalahan dari prosedur yang disimpan.

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, lihatMemecahkan masalah kesalahan dari prosedur yang disimpan.

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 kontrol denganrdsadmin.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. Untuk informasi lebih lanjut, lihat IBM Db2 dokumentasi.

RESTORE_DATABASE_PARALLELISM

Jumlah manipulator buffer yang akan dibuat selama operasi pemulihan. Nilai ini harus kurang dari dua kali lipat jumlah vCPUs untuk instans DB. Jika pengaturan ini tidak dikonfigurasi, Db2 menentukan nilai yang akan digunakan selama operasi pemulihan. Untuk informasi lebih lanjut, lihat IBM Db2 dokumentasi.

Contoh

Contoh 1: Menentukan jumlah manipulator buffer yang akan dibuat

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 akan 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 instans Db2 RDS DB Anda.

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 basis data yang akan dipulihkan. Nama ini harus sama dengan nama basis data dalam citra cadangan. 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 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 instans Db2 DB. RDS Untuk informasi selengkapnya, lihat Menggunakan AWS layanan untuk memigrasikan data dari Db2 ke Amazon untuk Db2 RDS.

Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:

  • Sebelum memulihkan database, Anda harus menyediakan ruang penyimpanan untuk instans Db2 DB Anda RDS 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 Db2 DB AndaRDS. 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

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

  • RDSuntuk 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 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, lihatMemecahkan masalah kesalahan dari prosedur yang disimpan.

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, 
    'rollfoward_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. Default-nya adalah END OF LOGS.

complete_rollforward

Menentukan apakah untuk menyelesaikan proses roll-forward. Tipe datanya varchar. Default-nya adalah 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_rollfoward(
    ?,
    'TESTDB')"

rdsadmin.db2pd_command

Mengumpulkan informasi tentang database RDS untuk 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 di IBM Db2 dokumentasi.

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 db2pdutilitas untuk menjalankan berbagai perintah. db2pdUtilitas memerlukan SYSADM otorisasi, yang tidak dimiliki oleh pengguna master RDS untuk Db2. Namun, dengan prosedur RDS tersimpan Amazon, pengguna master dapat menggunakan utilitas untuk menjalankan berbagai perintah. Untuk informasi selengkapnya tentang utilitas, lihat db2pd - Memantau dan memecahkan masalah perintah database Db2 di IBM Db2 dokumentasi.

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 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 Db2 DB instance dan database yang disebut: TESTDB

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

rdsadmin.force_application

Memaksa aplikasi dari database RDS for 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 database RDS for 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 APPLICATIONperintah. FORCE APPLICATIONPerintah membutuhkanSYSADM,SYSMAINT, atau SYSCTRL otorisasi, yang tidak dimiliki oleh pengguna master RDS untuk Db2. Namun, dengan prosedur RDS tersimpan Amazon, pengguna master dapat menggunakan perintah. Untuk informasi selengkapnya, lihat FORCEAPPLICATIONperintah di 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 database RDS untuk Db2:

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

Contoh 2: Menentukan beberapa aplikasi

Contoh berikut memaksa menangani aplikasi9991,8891, dan 1192 off dari database RDS untuk 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 yang ditentukan RDS 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. Kami menyarankan jika Anda menggunakan alat replikasi seperti AWS DMS untuk mengubah pengambilan data (CDC) atau IBM 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')"