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.backup_databaserdsadmin.restore_databaserdsadmin.rollforward_databaserdsadmin.rollforward_statusrdsadmin.complete_rollforwardrdsadmin.db2pd_commandrdsadmin.force_applicationrdsadmin.set_archive_log_retentionrdsadmin.show_archive_log_retentionrdsadmin.list_archive_log_informationrdsadmin.fgac_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, 32 halaman KiB berisiko robek, atau sebagian data ditulis ke disk. 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.

database_non-restrictive

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

Nilai valid:

  • NDatabase yang dibuat bersifat membatasi dan tidak memberikan otoritas atau hak istimewa.

  • Y— Database yang dibuat tidak membatasi dan memberikan satu set izin ke grup khusus. PUBLIC 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 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.

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

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.

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

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 database pada contoh DB sumber replika, Anda harus menggunakan prosedur rdsadmin.reactivate_database tersimpan untuk mengaktifkan kembali database.

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',
    '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 restart 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 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 kontrol denganrdsadmin.set_configuration.

Nama Deskripsi

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 selengkapnya, lihat mengembalikan perintah 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 v CPUs untuk instance DB. Jika pengaturan ini tidak dikonfigurasi, Db2 menentukan nilai yang akan digunakan selama operasi pemulihan. Untuk informasi selengkapnya, lihat mengembalikan perintah 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 backup database secara paralel. Kami menyarankan Anda menetapkan nilai ini agar sesuai dengan jumlah file cadangan basis data Anda. Untuk informasi selengkapnya, lihat perintah BACKUP 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 Anda untuk instans Db2 DB dan kemudian mengekstraknya. Pengaturan USE_STREAMING_RESTORE untuk TRUE secara signifikan mengurangi kebutuhan penyimpanan dan dapat meningkatkan kinerja pemulihan. Pengaturan ini memerlukan IBM Db2 engine versi 11.5.9.0.sb00063198.r1 atau lebih tinggi, dan konektivitas Amazon S3 melalui elastic network interface (ENI) database Anda. Untuk informasi selengkapnya, lihat Penyimpanan jarak jauh dalam IBM Db2 dokumentasi.

Contoh

Contoh 1: Menentukan jumlah buffer untuk membuat

Contoh berikut menetapkan 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 menetapkan 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 menetapkan RESTORE_DATABASE_NUM_MULTI_PATHS konfigurasi ke5.

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

Contoh 4: Mengatur restorasi untuk mengalirkan data cadangan

Contoh berikut menetapkan 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 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.

  • 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 Anda untuk instans Db2 DB dan kemudian mengekstraknya.

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

Mencadangkan database dari instans 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 instance Db2 DB untuk dicadangkan. Tipe datanya varchar.

Database harus ada dalam 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 dalam instans RDS untuk Db2 DB yang ingin Anda cadangkan, dan dapat diakses melalui peran IAM yang dilampirkan ke instans DB.

s3_prefix

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

Awalan dibatasi hingga 1024 karakter. Ini tidak boleh menyertakan garis miring (/). 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 menetapkan 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 pencadangan. 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 Db2 standar. Menggunakanlibdb2compr.so.

  • ZLIB- Peningkatan kompresi Db2. Penggunaanlibdb2zcompr.so, tetapi biaya penyimpanan yang lebih intensif CPU 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 memengaruhi operasi lainnya. Dampak sebenarnya tergantung pada pemanfaatan sistem secara keseluruhan dan util_impact_lim pengaturan. Anda dapat melihat dan memodifikasi util_impact_lim pengaturan dalam grup parameter. Untuk informasi selengkapnya, lihat Amazon RDS untuk parameter Db2.

num_files

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

Kami menyarankan Anda hanya mengatur parameter ini setelah mengamati kinerja pencadangan secara default yang dihitung secara otomatis Amazon RDS. 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 tablespace yang dapat dibaca oleh utilitas cadangan secara paralel. Tipe datanya integer. Nilai-nilai yang valid: 1–256.

Kami menyarankan Anda hanya mengatur parameter ini setelah mengamati kinerja cadangan pada default yang secara otomatis dihitung oleh mesin Db2 sebagai nilai optimal. Jika Anda menetapkan parameter ini, Amazon RDS 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 mengatur parameter ini setelah mengamati kinerja pencadangan secara default yang dihitung secara otomatis Amazon RDS berdasarkan memori. Jika Anda menyetel parameter ini, Amazon RDS memvalidasi terhadap memori yang tersedia dan tidak akan menjalankan permintaan cadangan jika memori yang tersedia tidak mencukupi. Jika Anda mencadangkan ke beberapa lokasi (num_filesdiatur ke lebih dari1), maka jumlah buffer yang lebih tinggi dapat meningkatkan kinerja. Jika Anda tidak mengatur compression_option keNONE, 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 RDS untuk instans Db2 DB, mengalirkannya ke Amazon S3, dan kemudian memulihkannya di mana pun Anda inginkan. Untuk informasi tentang memulihkan database ke RDS untuk instans Db2 DB, 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 RDS Anda untuk informasi instans Db2 DB:

db2 connect to rdsadmin user master_username using master_password

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

terminate

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

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

Contoh

Semua contoh mencadangkan database yang dipanggil MYDB ke bucket Amazon S3 yang dipanggil amzn-s3-demo-bucket dan menyetelnya kes3_prefix. backups/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 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 disempurnakan, pemanfaatan median, dan beberapa aliran upload paralel

Dalam contoh berikut, database di online dan tersedia selama backup. Contoh ini melakukan kompresi yang ditingkatkan, yang menghasilkan ukuran file yang kecil, tetapi intensif CPU. Ini memiliki dampak sedikit lebih tinggi dari rata-rata 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 menggunakan kompresi default file dan berdampak pada sumber daya sistem. Hal ini juga memungkinkan RDS untuk Db2 untuk menghitung jumlah stream upload paralel ke Amazon S3, tablespace 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 kustom

Dalam contoh berikut, database offline, yang lebih cepat tetapi berarti bahwa database tidak tersedia selama pencadangan. Contoh tidak melakukan kompresi file, berdampak tinggi pada sumber daya sistem, dan menggunakan 20 aliran unggahan ke Amazon S3. Ini menetapkan jumlah maksimum ruang meja untuk dibaca secara paralel, yang dapat menyebabkan permintaan cadangan gagal jika daya pemrosesan tidak mencukupi. Ini juga menetapkan jumlah maksimum buffer 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

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, 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 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 Bermigrasi dari Linux ke Linux dengan downtime mendekati nol untuk Amazon RDS untuk Db2.

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 lebih besar dari database Db2 asli pada disk. Jika Anda mengaktifkanUSE_STREAMING_RESTORE, maka ketika Anda memulihkan cadangan Anda, Amazon RDS mengalirkan file cadangan langsung dari bucket S3 Anda ke RDS Anda untuk instans Db2 DB. Jika Anda tidak mengaktifkanUSE_STREAMING_RESTORE, Anda harus menyediakan ruang penyimpanan untuk RDS Anda untuk instans Db2 DB 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 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, manipulator buffer, dan jumlah beberapa jalur cadangan untuk digunakan RDS. Untuk mengoptimalkan penggunaan penyimpanan dan berpotensi meningkatkan kinerja, Anda juga dapat langsung melakukan streaming cadangan dari Amazon S3. 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 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 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

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

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

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

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

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

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

Setelah rdsadmin.restore_database() selesai, gunakan sintaks di Contoh 3 atau Contoh 4 untuk memajukan log tanpa membawa database 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.

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

Catatan penggunaan

Setelah Anda meneleponrdsadmin.rollforward_database, Anda dapat menelepon rdsadmin.rollforward_status untuk memeriksa status rollforward dalam 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 dalam ROLL-FORWARD PENDING keadaan dan offline. Untuk menyelesaikan proses pengguliran maju dan membawa online basis data, panggil rdsadmin.complete_rollforward.

Untuk informasi tentang memeriksa status penyelesaian proses rollforward, lihat. rdsadmin.rollforward_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 daftar 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')"

rdsadmin.fgac_command

Menjalankan perintah kontrol akses berbutir 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 berbutir halus yang ingin Anda jalankan. Tipe datanya varchar.

Perintah berikut valid:

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

  • ALTER PERMISSION— Mengubah properti 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— Menjatuhkan izin baris yang ada.

  • DROP SECURITY LABEL— Menjatuhkan label keamanan dari LBAC.

  • DROP SECURITY POLICY— Menjatuhkan 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 dalam database Anda pada RDS untuk instans Db2 DB. RDS untuk Db2 mendukung dua jenis FGAC pada database:

  • Kontrol akses berbasis label (LBAC)

  • Kontrol akses baris dan kolom (RCAC)

Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:

  • Untuk menghindari kutipan tunggal ('), gunakan kutipan tunggal tambahan. 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 disebut. testdb

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