View a markdown version of this page

Prosedur tersimpan untuk database untuk RDS untuk Db2 - Amazon Relational Database Service
rdsadmin.create_databaserdsadmin.copy_active_logsrdsadmin.deactivate_databaserdsadmin.activate_databaserdsadmin.reactivate_databaserdsadmin.drop_databaserdsadmin.update_db_parameterrdsadmin.set_konfigurasirdsadmin.show_configurationrdsadmin.backup_databaserdsadmin.restore_databaserdsadmin.rollforward_databaserdsadmin.rollforward_statusrdsadmin.complete_rollforwardrdsadmin.db2pd_perintahrdsadmin.force_aplikasirdsadmin.set_archive_log_retensirdsadmin.show_archive_log_retensirdsadmin.list_archive_log_informationrdsadmin.enable_archive_log_copyrdsadmin.disable_archive_log_copyrdsadmin.fgac_perintahrdsadmin.db2support_command

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',
    'database_page_size',
    'database_code_set',
    'database_territory',
    'database_collation',
    'database_autoconfigure_str',
    'database_non-restrictive')"

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, halaman 32 KiB berisiko menulis robek, atau sebagian data ditulis ke disk. Jika Anda menggunakan halaman 32 KiB, sebaiknya aktifkan pemulihan point-in-time dan backup otomatis. Jika tidak, Anda berisiko tidak dapat pulih dari halaman yang sobek. Untuk informasi selengkapnya, lihat Pengantar cadangan dan Memulihkan instance DB ke waktu tertentu 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 kolasi yang menentukan bagaimana string karakter yang disimpan dalam database diurutkan dan dibandingkan. Tipe datanya varchar.

Nilai valid:

  • COMPATIBILITY- Urutan pengumpulan IBM Db2 Versi 2.

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

  • EBCDIC_819_500— Halaman kode Latin ISO, kolasi; CCSID 500 (EBCDIC Internasional).

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

  • EBCDIC_850_500— Halaman kode Latin ASCII, kolasi; CCSID 500 (EBCDIC Internasional).

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

  • EBCDIC_932_5035— Halaman kode Jepang ASCII, kolasi; CCSID 5035 (EBCDIC Internasional).

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

  • EBCDIC_1252_500— Halaman kode Windows Latin, kolasi; CCSID 500 (EBCDIC Internasional).

  • IDENTITY— Kolasi default. String dibandingkan byte demi byte.

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

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

  • SYSTEM- Jika Anda menggunakanSYSTEM, database menggunakan urutan kolasi secara otomatis untuk database_codeset dandatabase_territory.

Nilai default-nya IDENTITY.

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

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.

database_non-restrictive

Pemberian otoritas default dan hak istimewa dalam database. Tipe datanya varchar. Nilai default-nya N.

Nilai valid:

  • N- Database yang dibuat terbatas dan tidak memberikan otoritas atau hak istimewa.

  • Y- Basis data yang dibuat tidak membatasi dan memberikan satu set izin ke grup PUBLIC khusus. Untuk informasi selengkapnya, lihat Hak istimewa default yang diberikan saat membuat database dalam 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.

  • RDS untuk Db2 hanya menggunakan AUTOMATIC STORAGE tablespaces.

  • 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 informasi instans DB RDS untuk Db2:

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 dikembalikan saat menelep rdsadmin.create_database on, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut membuat database yang dipanggil 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.copy_active_logs

Menyalin log aktif database RDS untuk Db2 ke Amazon S3. Log diunggah ke direktori di bawah lokasi yang Anda konfigurasikanARCHIVE_LOG_COPY_TARGET_S3_ARN.

Sintaks

db2 "call rdsadmin.copy_active_logs(
    ?,
    '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 menyalin log aktif. Tipe datanya varchar.

Catatan penggunaan

Sebelum meneleponrdsadmin.copy_active_logs, Anda harus mengonfigurasi salinan log arsip untuk database. Untuk informasi selengkapnya, lihat Menyalin log arsip ke Amazon S3.

File log aktif diunggah ke bucket Amazon S3 Anda di bawah s3_prefix rds-archive-log-copy/ dbi_resource_id / database_name - database_unique_id /active_logs_task_ task_id/. Awalan Amazon S3 menggunakan konfigurasi untukARCHIVE_LOG_COPY_TARGET_S3_ARN.

Untuk informasi tentang memeriksa status menyalin log aktif, lihatrdsadmin.get_task_status.

Contoh

Contoh berikut menyalin log aktif untuk database yang disebutTESTDB.

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

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 yang akan 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 secara online, panggil prosedur ter rdsadmin.activate_database simpan.

Anda tidak dapat menonaktifkan database pada instance DB sumber selama replikasi dengan memanggil prosedur rdsadmin.deactivate_database tersimpan.

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

Untuk pesan kesalahan yang dikembalikan saat menelep rdsadmin.deactivate_database on, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut menonaktifkan database yang disebutTESTDB.

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 yang akan diaktifkan. Tipe datanya varchar.

Catatan penggunaan

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

Prosedur tersimpan ini hanya mengaktifkan database yang ada pada instance DB mandiri dan yang dinonaktifkan dengan memanggil prosedur ter rdsadmin.deactivate_database simpan. Untuk mengaktifkan database pada instance DB sumber replika, Anda harus memanggil prosedur rdsadmin.reactivate_database tersimpan.

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

Untuk pesan kesalahan yang dikembalikan saat menelep rdsadmin.activate_database on, 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 yang akan diaktifkan kembali. Tipe datanya varchar.

Catatan penggunaan

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

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

Untuk database pada instance DB mandiri, Anda dapat menggunakan prosedur rdsadmin.reactivate_database penyimpanan untuk mengaktifkan kembali database. Atau, jika Anda sudah memanggil prosedur ter rdsadmin.deactivate_database simpan, Anda dapat memanggil prosedur ter rdsadmin.activate_database simpan sebagai gantinya.

Untuk database pada instance DB sumber replika, Anda harus menggunakan prosedur rdsadmin.reactivate_database tersimpan untuk mengaktifkan kembali database.

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

Untuk pesan kesalahan yang dikembalikan saat menelep rdsadmin.reactivate_database on, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut mengaktifkan kembali database yang disebutTESTDB.

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 menghapus database dengan memanggil 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 informasi instans DB RDS untuk Db2:

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 dikembalikan saat menelep rdsadmin.drop_database on, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut menjatuhkan database yang disebutTESTDB:

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

rdsadmin.update_db_parameter

Memperbarui parameter-parameter basis data.

Sintaks

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

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.

Parameter berikut bersifat opsional:

restart_database

Menentukan apakah RDS memulai ulang database jika restart diperlukan. Tipe datanya varchar. Untuk memodifikasi logprimary danlogfilsiz, atur parameter ini ke'YES'.

Catatan penggunaan

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

Untuk pesan kesalahan yang dikembalikan saat menelep rdsadmin.update_db_param on, 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_konfigurasi

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 kendalikanrdsadmin.set_configuration.

Nama Deskripsi

ARCHIVE_LOG_COPY_TARGET_S3_ARN

Menentukan bucket S3 ARN tempat log arsip disalin. Pengaturan ini berlaku untuk semua database pada instance DB yang telah Menyalin log arsip ke Amazon S3 diaktifkan.

RDS_PASSWORD_MAX_LENGTH

Menentukan panjang kata sandi maksimum. Nilai harus antara 8 dan 128 karakter. Nilai default adalah 128.

RDS_PASSWORD_MIN_LENGTH

Menentukan panjang kata sandi minimum. Nilai harus antara 8 dan 128 karakter. Nilai default adalah 8.

RDS_PASSWORD_MIN_NUMERIC

Menentukan jumlah minimum karakter numerik yang diperlukan dalam kata sandi. Nilai harus antara 0 dan 128. Nilai default-nya adalah 0.

RDS_PASSWORD_MIN_UPPER_CASE_CHAR

Menentukan jumlah minimum karakter huruf besar yang diperlukan dalam kata sandi. Nilai harus antara 0 dan 128. Nilai default-nya adalah 0.

RDS_PASSWORD_MIN_LOWER_CASE_CHAR

Menentukan jumlah minimum karakter huruf kecil yang diperlukan dalam kata sandi. Nilai harus antara 0 dan 128. Nilai default-nya adalah 0.

RDS_PASSWORD_RULES

Menentukan konfigurasi aturan kata sandi. Nilai-nilai yang valid adalah DEFAULT atau CUSTOM.

RESTORE_DATABASE_NUM_BUFFERS

Jumlah buffer yang akan dibuat selama operasi pemulihan. Nilai ini harus kurang dari ukuran memori total kelas instance DB. Jika pengaturan ini tidak dikonfigurasi, Db2 menentukan nilai yang akan digunakan selama operasi pemulihan. Untuk informasi selengkapnya, lihat perintah RE STORE DATABASE dalam IBM Db2 dokumentasi.

RESTORE_DATABASE_NUM_MULTI_PATHS

Jumlah jalur (atau I/O aliran) yang akan digunakan selama pemulihan dari operasi Amazon S3. Untuk menggunakan pengaturan konfigurasi ini, Anda harus memiliki beberapa file cadangan. Nilai ini dapat meningkatkan kinerja saat memulihkan database dengan volume data yang besar karena mengembalikan beberapa file cadangan database secara paralel. Sebaiknya tetapkan nilai ini agar sesuai dengan jumlah file cadangan database Anda. Untuk informasi selengkapnya, lihat perintah BACKUP DATABASE dalam IBM Db2 dokumentasi.

RESTORE_DATABASE_PARALLELISM

Jumlah manipulator buffer yang akan dibuat selama operasi pemulihan. Nilai ini harus kurang dari dua kali lipat jumlah vCPU untuk instance DB. Jika pengaturan ini tidak dikonfigurasi, Db2 menentukan nilai yang akan digunakan selama operasi pemulihan. Untuk informasi selengkapnya, lihat perintah RE STORE DATABASE dalam IBM Db2 dokumentasi.

USE_STREAMING_RESTORE

Menentukan apakah akan melakukan streaming data cadangan secara langsung selama pemulihan daripada terlebih dahulu mengunduh seluruh cadangan ke RDS untuk instans DB Db2 Anda dan kemudian mengekstraknya. Pengaturan USE_STREAMING_RESTORE untuk mengurangi kebutuhan penyimpanan TRUE secara signifikan dan dapat meningkatkan kinerja pemulihan. Pengaturan ini memerlukan mesin IBM Db2 versi 11.5.9.0.sb00063198.r1 atau lebih tinggi, dan konektivitas Amazon S3 melalui antarmuka jaringan elastis (ENI) database Anda. Untuk informasi selengkapnya, lihat Penyimpanan jarak jauh dalam IBM Db2 dokumentasi.
catatan

Perilaku berikut berlaku untuk parameter konfigurasi kata sandi:

  • RDS untuk Db2 secara otomatis diset RDS_PASSWORD_RULES el ke CUSTOM ketika parameter kata sandi diatur.

  • Saat Anda menyetel RDS_PASSWORD_RULES keDEFAULT, RDS untuk Db2 mengatur ulang semua parameter kata sandi ke defaultnya.

  • Anda tidak dapat mengatur parameter kata sandi keNULL. Untuk mengatur ulang semua parameter kata sandi ke defaultnya, gunakanset_configuration('RDS_PASSWORD_RULES', 'DEFAULT').

Contoh

Contoh 1: Menentukan jumlah buffer yang akan dibuat

Contoh berikut mengatur RESTORE_DATABASE_NUM_BUFFERS konfigurasi ke150.

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

Contoh 2: Menentukan jumlah manipulator buffer yang akan dibuat

Contoh berikut mengatur RESTORE_DATABASE_PARALLELISM konfigurasi ke8.

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

Contoh 3: Menentukan jumlah jalur atau I/O aliran yang akan digunakan selama pemulihan

Contoh berikut mengatur RESTORE_DATABASE_NUM_MULTI_PATHS konfigurasi ke5.

db2 "call rdsadmin.set_configuration(
    'RESTORE_DATABASE_NUM_MULTI_PATHS', 
    '5')"

Contoh 4: Mengatur pemulihan untuk mengalirkan data cadangan

Contoh berikut mengatur USE_STREAMING_RESTORE konfigurasi keTRUE.

db2 "call rdsadmin.set_configuration(
    'USE_STREAMING_RESTORE', 
    'TRUE')"

rdsadmin.show_configuration

Mengembalikan pengaturan saat ini yang dapat Anda atur dengan menggunakan prosedur tersimpanrdsadmin.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 ini 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.

  • RESTORE_DATABASE_NUM_MULTI_PATHS— Jumlah jalur (atau I/O aliran) yang akan digunakan selama pemulihan dari operasi Amazon S3.

  • USE_STREAMING_RESTORE- Menentukan apakah akan melakukan streaming data cadangan secara langsung selama pemulihan daripada terlebih dahulu mengunduh seluruh data cadangan ke RDS untuk instance DB Db2 Anda dan kemudian mengekstraknya.

Catatan penggunaan

Jika Anda tidak menentukan nama setelan konfigurasi, rdsadmin.show_configuration mengembalikan informasi untuk semua pengaturan konfigurasi yang dapat Anda tetapkan 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.backup_database

Mencadangkan database dari instance RDS untuk Db2 DB ke bucket Amazon S3.

Sintaks

db2 "call rdsadmin.backup_database(
    ?,
    'database_name', 
    's3_bucket_name', 
    's3_prefix', 
    'backup_type',
    'compression_option',
    'util_impact_priority', 
    'num_files',
    'parallelism',
    'num_buffers')"

Parameter

Parameter output berikut diperlukan:

?

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

Parameter input berikut diperlukan:

database_name

Nama database target pada RDS untuk instans DB Db2 untuk dicadangkan. Tipe datanya varchar.

Database harus ada di instance DB. Anda tidak dapat membuat cadangan rdsadmin database.

s3_bucket_name

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

Bucket S3 harus ada sebelum memanggilrdsadmin.backup_database, Wilayah AWS sama dengan database target di RDS untuk instans DB Db2 yang ingin Anda cadangkan, dan dapat diakses melalui peran IAM yang dilampirkan ke instance DB.

s3_prefix

Awalan jalur ke Amazon S3 tempat RDS untuk Db2 mengunggah file cadangan. Tipe datanya varchar.

Awalan dibatasi hingga 1024 karakter. Itu tidak boleh menyertakan garis miring di depan atau di belakang (/). Karena keterbatasan IBM streaming ke Amazon S3, kami menyarankan agar awalan menyertakan subdirektori.

Untuk manajemen file yang lebih baik, RDS untuk Db2 membuat direktori tambahan setelahnya. s3_prefix RDS untuk Db2 mengunggah semua file cadangan ke. s3_prefix/dbi_resource_id/db_name Jika Anda mengatur num_files lebih tinggi dari1, db_name direktori akan berisi lebih dari satu file cadangan.

Berikut ini adalah contoh lokasi Amazon S3 untuk file cadangan. Dalam contoh, backups/daily adalah nilai yang ditetapkan untuk s3_prefix parameter.

backups/daily/db-5N7FXOY4GDP7RG2NSH2ZTAI2W4/SAMPLEDB
backup_type

Jenis cadangan yang menentukan apakah database tetap tersedia selama pencadangan. Tipe datanya varchar.

Nilai valid:

  • OFFLINE- Database tidak tersedia selama pencadangan. Jenis ini lebih cepat, tetapi menyebabkan downtime.

  • ONLINE- Database tetap tersedia selama backup. Secara default, ONLINE diatur ke INCLUDE LOGS.

Parameter berikut ini bersifat opsional:

compression_option

Jenis algoritma kompresi yang digunakan yang memengaruhi waktu cadangan, penggunaan CPU, dan biaya penyimpanan. Tipe datanya varchar. Nilai default-nya NONE.

Nilai valid:

  • NONE— Ukuran file terbesar, penggunaan CPU paling sedikit, dan biaya penyimpanan termurah.

  • STANDARD- Kompresi standar Db2. Kegun libdb2compr.so aan.

  • ZLIB- Peningkatan kompresi Db2. Penggunaanlibdb2zcompr.so, tetapi biaya penyimpanan lebih CPU-intensive dan paling mahal.

util_impact_priority

Pengaturan yang mengontrol dampak cadangan pada sumber daya sistem. Tipe datanya integer. Nilai yang valid: 1 — 100 (dari rendah ke tinggi). Nilai default-nya 50.

Nilai yang lebih rendah mengurangi dampak pencadangan pada sumber daya sistem, tetapi mungkin meningkatkan waktu yang diperlukan untuk membuat cadangan database. Nilai yang lebih tinggi mungkin menyelesaikan pencadangan database lebih cepat, tetapi dapat mempengaruhi operasi lain. Dampak aktual tergantung pada keseluruhan pemanfaatan sistem dan util_impact_lim pengaturan. Anda dapat melihat dan memodifikasi util_impact_lim pengaturan dalam kelompok parameter. Untuk informasi selengkapnya, lihat Amazon RDS untuk parameter Db2.

num_files

Jumlah aliran unggahan paralel ke Amazon S3. Tipe datanya integer. Nilai-nilai yang valid: 1–256.

Kami menyarankan Anda hanya menyetel parameter ini setelah mengamati kinerja pencadangan pada default yang dihitung Amazon RDS secara otomatis. Nilai yang lebih tinggi dapat meningkatkan kinerja untuk cadangan besar, terutama dengan koneksi bandwidth tinggi, tetapi pada titik tertentu, nilai yang lebih tinggi menurunkan kinerja. Juga, pastikan untuk memperhitungkan sumber daya sistem dan kapasitas jaringan yang tersedia.

parallelism

Jumlah tablespaces yang dapat dibaca oleh utilitas cadangan secara paralel. Tipe datanya integer. Nilai-nilai yang valid: 1–256.

Kami menyarankan Anda hanya menyetel parameter ini setelah mengamati kinerja cadangan pada default yang dihitung mesin Db2 secara otomatis sebagai nilai optimal. Jika Anda menyetel parameter ini, Amazon RDS akan memvalidasi terhadap prosesor yang tersedia dan tidak akan menjalankan permintaan cadangan jika daya pemrosesan tidak mencukupi.

num_buffers

Jumlah buffer yang akan digunakan. Tipe datanya integer. Nilai-nilai yang valid: 1–268435456.

Kami menyarankan Anda hanya menyetel parameter ini setelah mengamati kinerja cadangan pada default yang dihitung Amazon RDS secara otomatis berdasarkan memori. Jika Anda menyetel parameter ini, Amazon RDS akan memvalidasi terhadap memori yang tersedia dan tidak akan menjalankan permintaan cadangan jika memori yang tersedia tidak mencukupi. Jika Anda membuat cadangan ke beberapa lokasi (num_filesdisetel ke lebih dari1), maka jumlah buffer yang lebih tinggi dapat meningkatkan kinerja. Jika Anda tidak compression_option mengaturNONE, maka Anda dapat meningkatkan kinerja dengan meningkatkan num_buffers danparallelism.

Catatan penggunaan

Prosedur tersimpan ini membuat tugas pencadangan asinkron yang mengalirkan cadangan database Anda langsung ke bucket Amazon S3 Anda dengan menggunakan integrasi Amazon S3. Anda dapat membuat cadangan baik dari server lokal Anda atau dari instance RDS untuk Db2 DB, mengalirkannya ke Amazon S3, lalu mengembalikannya ke mana pun Anda inginkan. Untuk informasi tentang memulihkan database ke RDS untuk instans DB Db2, lihat. rdsadmin.restore_database

Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:

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

db2 connect to rdsadmin user master_username using master_password

Setelah Anda membuat cadangan database Anda, pastikan untuk menghentikan koneksi.

terminate

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

Untuk pesan kesalahan yang dikembalikan saat menelep rdsadmin.backup_database on, lihatKesalahan prosedur tersimpan.

Contoh

Semua contoh membuat cadangan database yang dipanggil MYDB ke bucket Amazon S3 yang dipanggil amzn-s3-demo-bucket dan menyetel s3_prefix kebackups/daily.

Contoh #1: Menentukan database offline dan tidak tersedia dengan pemanfaatan median dan aliran unggahan tunggal

Dalam contoh berikut, database offline, yang lebih cepat tetapi berarti bahwa database tidak tersedia selama pencadangan. Contoh ini tidak melakukan kompresi file, memiliki dampak median pada sumber daya sistem, dan menggunakan aliran unggahan tunggal ke Amazon S3.

db2 call "rdsadmin.backup_database(
    ?, 
    'MYDB',
    'amzn-s3-demo-bucket', 
    'backups/daily',
    'OFFLINE',
    'NONE', 
    50, 
    1)"

Contoh #2: Menentukan database online dan tersedia dengan kompresi yang ditingkatkan, pemanfaatan median, dan beberapa aliran unggahan paralel

Dalam contoh berikut, database online dan tersedia selama pencadangan. Contoh melakukan kompresi yang ditingkatkan, yang menghasilkan ukuran file kecil, tetapi memang demikian CPU-intensive. Ini memiliki dampak yang sedikit lebih tinggi dari median pada sumber daya sistem dan menggunakan lima aliran unggahan ke Amazon S3.

db2 call "rdsadmin.backup_database(
    ?, 
    'MYDB',
    'amzn-s3-demo-bucket', 
    'backups/daily',
    'ONLINE',
    'ZLIB', 
    60, 
    5)"

Contoh #3: Menentukan database offline dan tidak tersedia dengan default dan perhitungan sistem

Dalam contoh berikut, database offline, yang lebih cepat tetapi berarti bahwa database tidak tersedia selama pencadangan. Contoh ini menggunakan kompresi default file dan berdampak pada sumber daya sistem. Ini juga memungkinkan RDS untuk Db2 untuk menghitung jumlah aliran unggahan paralel ke Amazon S3, tablespaces untuk dibaca secara paralel, dan buffer untuk digunakan.

db2 "call rdsadmin.backup_database(
    ?, 
    'MYDB', 
    'amzn-s3-demo-bucket',
    'backups/daily', 
    'OFFLINE')"

Contoh #4: Menentukan database offline dan tidak tersedia tanpa kompresi, pemanfaatan tinggi, dan perhitungan khusus

Dalam contoh berikut, database offline, yang lebih cepat tetapi berarti bahwa database tidak tersedia selama pencadangan. Contoh ini tidak melakukan kompresi file, berdampak tinggi pada sumber daya sistem, dan menggunakan 20 aliran unggahan ke Amazon S3. Ini menetapkan jumlah maksimum tablespaces untuk dibaca secara paralel, yang dapat menyebabkan permintaan cadangan gagal jika daya pemrosesan tidak mencukupi. Ini juga menetapkan jumlah buffer maksimum untuk digunakan, yang dapat menyebabkan permintaan cadangan gagal jika memori tidak mencukupi.

db2 "call rdsadmin.backup_database(
    ?, 
    'MYDB', 
    'amzn-s3-demo-bucket', 
    'backups/daily', 
    'OFFLINE', 
    'NONE', 
    90, 
    20, 
    256, 
    268435456)"

rdsadmin.restore_database

Mengembalikan database dari bucket Amazon S3 ke instans DB RDS untuk Db2 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 database target untuk dipulihkan di RDS untuk Db2. Tipe datanya varchar.

Misalnya, jika nama database sumber adalah TESTDB dan Anda setel database_name keNEWDB, maka Amazon RDS memulihkan NEWDB sebagai basis data 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 diproses. 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 waktu henti hampir nol untuk Amazon RDS untuk Db2.

Catatan penggunaan

Anda dapat menggunakan prosedur tersimpan ini untuk memigrasikan database Db2 ke RDS untuk instans DB Db2. Untuk informasi selengkapnya, lihat Menggunakan AWS layanan untuk memigrasikan data dari Db2 ke Amazon RDS untuk Db2. Anda juga dapat menggunakan prosedur tersimpan ini untuk membuat beberapa salinan 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 untuk instans DB Db2 yang lebih besar dari database Db2 asli pada disk. Jika Anda mengaktifkanUSE_STREAMING_RESTORE, maka ketika Anda memulihkan cadangan, Amazon RDS mengalirkan file cadangan langsung dari bucket S3 Anda ke RDS for Db2 DB instance. Jika tidak mengaktifkanUSE_STREAMING_RESTORE, Anda harus menyediakan ruang penyimpanan untuk RDS untuk instans DB Db2 yang sama dengan atau lebih besar dari jumlah ukuran cadangan ditambah 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 memulihkan 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 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, manipulator buffer, dan jumlah beberapa jalur cadangan untuk digunakan RDS. Untuk mengoptimalkan penggunaan penyimpanan dan meningkatkan kinerja, Anda juga dapat melakukan streaming cadangan dari Amazon S3 secara langsung. Untuk memeriksa konfigurasi saat ini, gunakanrdsadmin.show_configuration. Untuk mengubah konfigurasi, gunakanrdsadmin.set_konfigurasi.

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 dikembalikan saat menelep rdsadmin.restore_database on, lihatKesalahan prosedur tersimpan.

Contoh

Contoh berikut mengembalikan cadangan offline dengan satu file atau beberapa file yang memiliki s3_prefixbackupfolder/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. 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. Berikut ini adalah contoh awalan:

logsfolder/
penting

Awalan S3 harus menunjuk ke lokasi yang hanya berisi file log arsip Db2 dalam format penamaan standar (Ssequence.LOGmisalnyaS0000001.LOG). Jika awalan berisi file non-arsip-log, seperti gambar cadangan, file metadata, atau objek lain, operasi rollforward gagal dengan kesalahan. Gunakan awalan S3 khusus untuk arsip log yang terpisah dari file cadangan Anda.

Parameter input berikut adalah opsional:

rollforward_to_option

Titik yang ingin Anda tuju untuk pengguliran maju. Tipe datanya varchar. Nilai yang valid:END_OF_LOGS, END_OF_BACKUP dengan stempel waktu dalam format. YYYY-MM-DD-HH.MM.SS Nilai default-nya END_OF_LOGS.

complete_rollforward

Menentukan apakah akan 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

Anda dapat menggunakan rds.rollforward_database untuk pencadangan online dengan menyertakan log yang diproduksi di lokasi dalam berbagai skenario.

Skenario 1: Memulihkan database, memajukan log yang disertakan, dan membawa database secara online

Setelah rdsadmin.restore_database() selesai, gunakan sintaks dalam Contoh 1 untuk membawa database dengan log transaksi online.

Skenario 2: Membawa database secara online tetapi tidak meneruskan log yang disertakan.

Setelah rdsadmin.restore_database() selesai, gunakan sintaks dalam Contoh 2 untuk membawa database tanpa log transaksi online.

Skenario 3: Melanjutkan log yang disertakan dalam cadangan, dan menerapkan log transaksi tambahan saat dibuat di lokasi

Setelah rdsadmin.restore_database() selesai, gunakan sintaks dalam Contoh 3 atau Contoh 4 untuk meneruskan log tanpa membawa database secara online.

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.rollforward_status.

penting

Awalan S3 yang Anda tentukan rdsadmin.rollforward_database harus berisi hanya file log arsip dalam Ssequence.LOG format. Jangan menempatkan gambar cadangan, file metadata, atau objek non-log lainnya pada awalan S3 yang sama yang Anda gunakan untuk rollforward. Jika file non-arsip-log hadir dalam awalan, operasi rollforward gagal. Simpan log arsip Anda dalam awalan khusus yang terpisah dari file cadangan database Anda.

Contoh

Contoh 1: Membawa database dengan log transaksi secara online

Contoh berikut ini diteruskan ke cadangan online database dengan log transaksi dan kemudian membawa database secara online:

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

Contoh 2: Membawa database tanpa log transaksi secara online

Contoh berikut ini diteruskan ke cadangan online database tanpa log transaksi, dan kemudian membawa database secara online:

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

A archiveLogs/ walan harus berisi hanya file log arsip dalam Ssequence.LOG format.

Contoh 3: Tidak membawa database dengan log transaksi secara online

Contoh berikut diteruskan ke cadangan online database dengan log transaksi, dan kemudian tidak membuat database online:

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

Ketika s3_bucket_name null, rollforward menggunakan file log yang sudah ada di instance DB dari pemulihan sebelumnya dengan log yang disertakan. Saat Anda menentukans3_prefix, pastikan bahwa itu hanya berisi file log arsip.

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

Contoh berikut diteruskan ke cadangan online database dengan log transaksi tambahan, dan kemudian tidak membuat database online:

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

rdsadmin.rollforward_status

Mengembalikan output dariROLLFORWARD DATABASE database_name QUERY STATUS.

Sintaks

db2 "call rdsadmin.rollforward_status(
    ?,
    '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 melakukan operasi. Tipe datanya varchar.

Catatan penggunaan

Setelah meneleponrdsadmin.rollforward_database, Anda dapat rdsadmin.rollforward_status menelepon untuk memeriksa status rollforward di database.

Untuk informasi tentang memeriksa status prosedur tersimpan ini, lihatrdsadmin.get_task_status.

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 berada dalam ROLL-FORWARD PENDING status dan offline. Untuk menyelesaikan proses pengguliran maju dan membawa online basis data, panggil rdsadmin.complete_rollforward.

Untuk informasi tentang memeriksa status penyelesaian proses rollforward, lihatrdsadmin.rollforward_status.

Contoh

Contoh berikut membawa TESTDB database online:

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

rdsadmin.db2pd_perintah

Mengumpulkan informasi tentang RDS untuk database Db2.

Sintaks

db2 "call rdsadmin.db2pd_command(
                'db2pd_cmd',
                's3_bucket_name',
                's3_prefix')"

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

  • -file | -o

  • -ha

  • -interactive

  • -member

  • -pages

    catatan

    -pages summary didukung.

  • -pdcollection

  • -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.

Parameter berikut ini bersifat opsional:

s3_bucket_name

Nama bucket Amazon S3 tempat Anda ingin mengunggah file output. Tipe datanya varchar. Jika tidak s3_bucket_name s3_prefix ada atau tidak disediakan, informasi yang dikumpulkan dapat diambil dengan meneleponrdsadmin.get_task_status.

s3_prefix

Awalan jalur ke Amazon S3 tempat RDS untuk Db2 mengunggah file output. Tipe datanya varchar. Jika awalan ditentukan, juga s3_bucket_name harus disediakan. Jika dihilangkan saat s3_bucket_name ada, file output diunggah ke direktori root dari bucket yang ditentukan.

Catatan penggunaan

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

Prosedur tersimpan menggunakan IBM db2pd utilitas untuk menjalankan berbagai perintah. db2pdUtilitas memerlukan SYSADM otorisasi, yang tidak dimiliki RDS untuk pengguna master 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

Outputnya dibatasi hingga maksimum 2 GB.

Sebelum memanggil prosedur yang disimpan, tinjau persyaratan berikut:

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

Contoh

Contoh 1: Mengembalikan waktu aktif instans DB

Contoh berikut mengembalikan waktu aktif RDS untuk instans DB Db2:

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

Contoh 2: Mengembalikan uptime database

Contoh berikut mengembalikan uptime database yang disebut: TESTDB

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

Contoh 3: Mengembalikan penggunaan memori instance DB

Contoh berikut mengembalikan penggunaan memori RDS untuk instans DB Db2:

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

Contoh 4: Mengembalikan set memori dari instance DB dan database

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

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

Contoh 5: Mengembalikan penggunaan memori berulang dari instance DB

Contoh berikut mengembalikan penggunaan memori RDS untuk instans DB Db2 setiap 10 detik selama 6 kali:

db2 "call rdsadmin.db2pd_command(
                '-dbptnmem -repeat 10 6',
                'amzn-s3-demo-bucket',
                'db2pdResults')"

rdsadmin.force_aplikasi

Memaksa aplikasi keluar dari database RDS untuk 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 matikan dari database RDS untuk 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 tersimpan menggunakan IBM FORCE APPLICATION perintah. Per FORCE APPLICATION intah memerlukanSYSADM,SYSMAINT, atau SYSCTRL otorisasi, yang tidak dimiliki RDS untuk pengguna master Db2. Namun, dengan prosedur tersimpan Amazon RDS, pengguna master dapat menggunakan perintah tersebut. Untuk informasi selengkapnya, lihat perintah FORCE APPLIC IBM Db2 ATION dalam 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 keluar dari database RDS untuk Db2:

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

Contoh 2: Menentukan beberapa aplikasi

Contoh berikut memaksa penanganan aplikasi9991,8891, dan 1192 mematikan RDS untuk database Db2:

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

rdsadmin.set_archive_log_retensi

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

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. Tipe datanya varchar.

archive_log_retention_hours

Jumlah jam untuk menyimpan file log arsip. Tipe datanya smallint. Defaultnya adalah0, dan maksimumnya adalah 840 (35 hari).

Jika nilainya0, Amazon RDS tidak menyimpan file log arsip.

Catatan penggunaan

Secara default, RDS untuk Db2 menyimpan 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 memanggilrdsadmin.show_archive_log_retensi.

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 menjadi 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_retensi

Mengembalikan pengaturan penyimpanan log arsip saat ini untuk database yang ditentukan.

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 dipanggilTESTDB.

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

rdsadmin.list_archive_log_information

Mengembalikan detail tentang file log arsip, seperti ukuran, tanggal dan waktu pembuatan, dan nama file log individual 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. Tipe datanya varchar.

Contoh

Contoh berikut mengembalikan informasi log arsip untuk database yang dipanggilTESTDB.

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

rdsadmin.enable_archive_log_copy

Mengaktifkan salinan log arsip database RDS Db2 ke Amazon S3.

Sintaks

db2 "call rdsadmin.enable_archive_log_copy(
    ?,
    '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 salinan log arsip ke Amazon S3. Tipe datanya varchar.

Contoh

Contoh berikut memungkinkan salinan log arsip untuk database yang dipanggilTESTDB.

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

rdsadmin.disable_archive_log_copy

Menonaktifkan salinan log arsip database RDS Db2 ke Amazon S3.

Sintaks

db2 "call rdsadmin.disable_archive_log_copy(
    ?,
    '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 yang digunakan untuk menonaktifkan salinan log arsip ke Amazon S3. Tipe datanya varchar.

Contoh

Contoh berikut menonaktifkan salinan log arsip untuk database yang dipanggilTESTDB.

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

rdsadmin.fgac_perintah

Menjalankan perintah kontrol akses halus (FGAC).

Sintaks

db2 "call rdsadmin.fgac_command(
    ?,
    'database_name',
    'fgac_cmd')"

Parameter

Parameter output berikut diperlukan:

?

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

Parameter input berikut diperlukan:

database_name

Nama database tempat Anda ingin menjalankan perintah FGAC. Tipe datanya varchar.

fgac_cmd

Perintah kontrol akses halus yang ingin Anda jalankan. Tipe datanya varchar.

Perintah berikut ini valid:

  • ALTER MASK— Mengubah topeng kolom yang ada dalam kontrol akses baris dan kolom (RCAC).

  • ALTER PERMISSION— Mengubah properti dari izin baris yang ada di RCAC.

  • ALTER SECURITY POLICY— Mengubah kebijakan keamanan yang ada untuk RCAC.

  • ALTER SECURITY LABEL— Mengubah properti label keamanan yang ada di kontrol akses berbasis label (LBAC).

  • ALTER TABLE— Mengubah struktur tabel, termasuk menambahkan kontrol RCAC atau LBAC.

  • CREATE MASK- Membuat topeng kolom baru untuk RCAC.

  • CREATE PERMISSION- Membuat izin baris baru untuk RCAC.

  • CREATE SECURITY LABEL- Membuat label keamanan baru untuk LBAC.

  • CREATE SECURITY POLICY— Membuat kebijakan keamanan baru untuk RCAC.

  • DROP MASK— Menjatuhkan topeng kolom yang ada.

  • DROP PERMISSION— Menghilangkan izin baris yang ada.

  • DROP SECURITY LABEL— Menjatuhkan label keamanan dari LBAC.

  • DROP SECURITY POLICY— Menghapus kebijakan keamanan RCAC yang ada.

  • GRANT EXEMPTION ON RULE- Memungkinkan pengguna untuk melewati aturan LBAC tertentu.

  • GRANT SECURITY LABEL- Menetapkan label keamanan LBAC kepada pengguna.

  • REVOKE EXEMPTION ON RULE— Menghapus pengecualian pengguna dari aturan LBAC.

  • REVOKE SECURITY LABEL— Menghapus label keamanan LBAC dari pengguna.

Catatan penggunaan

Prosedur tersimpan ini mengontrol akses pada tingkat baris atau kolom ke data tabel di database Anda pada RDS untuk instance DB Db2. RDS untuk Db2 mendukung dua jenis FGAC pada database:

  • Label-based kontrol akses (LBAC)

  • Kontrol akses baris dan kolom (RCAC)

Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:

  • Untuk menghindari satu kutipan ('), gunakan kutipan tunggal tambahan. Contoh-contoh berikut menunjukkan cara melarikan diri'apple','banana', dan'fruit'.

    db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"
    db2 "call rdsadmin.fgac_command(
    ?, 
    'testdb', 
    'CREATE SECURITY LABEL COMPONENT FRUITTREE TREE(''fruit'' ROOT, ''apple'' UNDER ''fruit'', ''banana'' UNDER ''fruit'')')"

  • Untuk menghindari tanda kurung ([]), gunakan garis miring terbalik (\). Contoh berikut menunjukkan cara melarikan diri[''apple'',''banana'']. 

    db2 "call rdsadmin.fgac_command(
    ?, '
    testdb', 
    'CREATE SECURITY LABEL COMPONENT FRUITARRAY ARRAY\[''apple'',''banana''\]')"

Contoh

Contoh berikut semua menjalankan perintah FGAC pada database yang dipanggiltestdb.

Contoh 1: Membuat label keamanan baru yang disebut FRUITSET 

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT FRUITSET SET{''apple'',''banana''}')"

Contoh 2: Membuat topeng baru untuk EMP_ID kolom yang diaktifkan saat EMP_ID disetel ke kurang dari tiga 

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE MASK id_MASK ON EMPLOYEE FOR COLUMN EMP_ID RETURN CASE WHEN (EMP_ID < 3) THEN EMP_ID ELSE NULL END ENABLE')"

Contoh 3: Membuat topeng baru untuk DEPARTMENT kolom yang diaktifkan saat SESSION_USER disetel ke security_user 

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE MASK DEPARTMENT_MASK ON EMPLOYEE FOR COLUMN DEPARTMENT RETURN CASE  WHEN SESSION_USER = ''security_user'' THEN DEPARTMENT ELSE NULL END ENABLE')"

Contoh 4: Membuat label keamanan baru yang disebut treelabel 

db2 "call rdsadmin.fgac_command(
    ?,
    'testdb',
    'CREATE SECURITY LABEL COMPONENT treelabel  TREE(''COMPANY'' ROOT, ''HR'' UNDER ''COMPANY'', ''FINANCE'' UNDER ''COMPANY'', ''IT'' UNDER ''COMPANY'')')"

rdsadmin.db2support_command

Mengumpulkan informasi diagnostik tentang database RDS untuk Db2 dan mengunggahnya ke bucket Amazon S3.

Sintaks

db2 "call rdsadmin.db2support_command(
    ?,
    'database_name',
    's3_bucket_name',
    's3_prefix')"

Parameter

Parameter output berikut diperlukan:

?

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

Parameter input berikut diperlukan:

database_name

Nama database untuk mengumpulkan informasi diagnostik. Tipe datanya varchar.

s3_bucket_name

Nama bucket Amazon S3 tempat Anda ingin mengunggah informasi diagnostik. Tipe datanya varchar.

s3_prefix

Awalan jalur ke Amazon S3 tempat RDS untuk Db2 mengunggah file diagnostik. Tipe datanya varchar.

Catatan penggunaan

Prosedur tersimpan ini mengumpulkan informasi diagnostik yang dapat membantu memecahkan masalah RDS untuk database Db2 dan mengunggah informasi tersebut ke bucket Amazon S3.

Prosedur yang disimpan menggunakan IBM db2support utilitas untuk mengumpulkan data diagnostik. Untuk informasi selengkapnya tentang utilitas, lihat db2support - Perintah alat analisis masalah dan pengumpulan lingkungan dalam dokumentasiIBM Db2.

Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:

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

db2 connect to rdsadmin user master_username using master_password

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

Contoh

Contoh 1: Mengumpulkan informasi diagnostik untuk database

Contoh berikut mengumpulkan informasi diagnostik untuk database yang dipanggil TESTDB dan mengunggahnya ke bucket Amazon S3 yang dipanggil amzn-s3-demo-bucket dengan awalan: diagnostics/testdb

db2 "call rdsadmin.db2support_command(
    ?,
    'TESTDB',
    'amzn-s3-demo-bucket',
    'diagnostics/testdb')"

Contoh 2: Mengumpulkan informasi diagnostik dengan awalan berbasis tanggal

Contoh berikut mengumpulkan informasi diagnostik untuk database yang dipanggil MYDB dan mengunggahnya ke bucket Amazon S3 yang dipanggil amzn-s3-demo-bucket dengan awalan berbasis tanggal:

db2 "call rdsadmin.db2support_command(
    ?,
    'MYDB',
    'amzn-s3-demo-bucket',
    'support/2024/01/15')"