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.
+ [Tugas umum untuk database](db2-managing-databases.md)
+ [Membuat database dengan pemeriksaan EBCDIC](db2-ebcdic.md)
+ [Mengumpulkan informasi tentang database](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Memodifikasi parameter konfigurasi database](db2-supported-parameters.md#db2-modifying-parameters-db2-commands)
+ [Migrasi dari Linux ke Linux](db2-one-time-migration-linux.md)
+ [Migrasi dari Linux ke Linux dengan downtime mendekati nol](db2-near-zero-downtime-migration.md)
Lihat prosedur tersimpan bawaan berikut untuk informasi tentang sintaks, parameter, catatan penggunaan, dan contohnya.
**Topics**
+ [rdsadmin.create\$1database](#db2-sp-create-database)
+ [rdsadmin.deactivate\$1database](#db2-sp-deactivate-database)
+ [rdsadmin.activate\$1database](#db2-sp-activate-database)
+ [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database)
+ [rdsadmin.drop\$1database](#db2-sp-drop-database)
+ [rdsadmin.update\$1db\$1param](#db2-sp-update-db-param)
+ [rdsadmin.set\$1configuration](#db2-sp-set-configuration)
+ [rdsadmin.show\$1configuration](#db2-sp-show-configuration)
+ [rdsadmin.backup\$1database](#db2-sp-backup-database)
+ [rdsadmin.restore\$1database](#db2-sp-restore-database)
+ [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database)
+ [rdsadmin.rollforward\$1status](#db2-sp-rollforward-status)
+ [rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward)
+ [rdsadmin.db2pd\$1command](#db2-sp-db2pd-command)
+ [rdsadmin.force\$1application](#db2-sp-force-application)
+ [rdsadmin.set\$1archive\$1log\$1retention](#db2-sp-set-archive-log-retention)
+ [rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-show-archive-log-retention)
+ [rdsadmin.list\$1archive\$1log\$1information](#db2-sp-list-archive-log-information)
+ [rdsadmin.enable\$1archive\$1log\$1copy](#db2-sp-enable_archive_log_copy)
+ [rdsadmin.disable\$1archive\$1log\$1copy](#db2-sp-disable_archive_log_copy)
+ [rdsadmin.fgac\$1command](#db2-sp-fgac-command)
+ [rdsadmin.db2support\$1command](#db2-sp-db2support-command)
## rdsadmin.create\$1database
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 memanggil[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status), fungsi yang ditentukan pengguna dapat mengembalikan kesalahan karena kombinasi`database_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](https://www.ibm.com/docs/en/db2/11.5?topic=support-choosing-code-page-territory-collation-your-database) dalam dokumentasi IBM Db2.
Parameter berikut diperlukan:
*database\$1name*
Nama basis data yang akan dibuat. Tipe datanya `varchar`.
Parameter berikut ini bersifat opsional:
*database\$1page\$1size*
Ukuran halaman default basis data. Nilai yang valid:`4096`,`8192`,`16384`,`32768`. Tipe datanya `integer`. Nilai default-nya `8192`.
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](USER_WorkingWithAutomatedBackups.md) dan [Memulihkan instans DB ke waktu yang ditentukan untuk Amazon RDS](USER_PIT.md).
*database\$1code\$1set*
Kode yang ditetapkan untuk database. Tipe datanya `varchar`. Nilai default-nya `UTF-8`.
*database\$1territory*
Kode negara dua huruf untuk basis data. Tipe datanya `varchar`. Nilai default-nya `US`.
*database\$1collation*
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 \$126 di situs](https://www.unicode.org/reports/tr26/tr26-4.html) web Unicode Consortium.
+ `NLSCHAR`— Hanya untuk digunakan dengan halaman kode Thailand (CP874).
+ `SYSTEM`— Jika Anda menggunakan`SYSTEM`, database menggunakan urutan pemeriksaan secara otomatis untuk `database_codeset` dan`database_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](https://www.ibm.com/docs/en/db2/11.5?topic=collation-choosing-unicode-database) dalam dokumentasi. IBM Db2
*database\$1autoconfigure\$1str*
Sintaks `AUTOCONFIGURE` perintah, misalnya,`'AUTOCONFIGURE APPLY DB'`. Tipe datanya `varchar`. Defaultnya adalah string kosong atau null.
Lihat informasi yang lebih lengkap di [AUTOCONFIGURE command](https://www.ibm.com/docs/en/db2/11.5?topic=cc-autoconfigure) dalam dokumentasi IBM Db2.
*database\$1non-restrictive*
Pemberian otoritas default dan hak istimewa dalam database. Tipe datanya `varchar`. Nilai default-nya `N`.
Nilai valid:
+ `N`Database 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](https://www.ibm.com/docs/en/db2/11.5.x?topic=ownership-default-privileges-granted-creating-database) dalam IBM Db2 dokumentasi.
### Catatan penggunaan
Jika Anda berencana memodifikasi `db2_compatibility_vector` parameter, ubah parameter sebelum membuat database. Untuk informasi selengkapnya, lihat [Mengatur parameter db2\$1compatibility\$1vector](db2-known-issues-limitations.md#db2-known-issues-limitations-db2-compatibility-vector).
Pertimbangan-pertimbangan khusus:
+ Perintah`CREATE 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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-create-database#:~:text=in%20the%20database.-,RESTRICTIVE,-If%20the%20RESTRICTIVE) dalam dokumentasi IBM Db2.
Sebelum memanggil `rdsadmin.create_database`, Anda harus menghubungi basis data `rdsadmin`. Dalam contoh berikut, ganti *master\$1username* dan *master\$1password* 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.create_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Contoh berikut membuat database yang disebut `TESTJP` dengan kombinasi yang benar dari*database\$1code\$1set*,*database\$1territory*, dan *database\$1collation* parameter untuk Jepang:
```
db2 "call rdsadmin.create_database('TESTJP', 4096, 'IBM-437', 'JP', 'SYSTEM')"
```
## rdsadmin.deactivate\$1database
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\$1name*
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\$1database](#db2-sp-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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.deactivate_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Contoh berikut menonaktifkan database yang disebut. `TESTDB`
```
db2 "call rdsadmin.deactivate_database(?, 'TESTDB')"
```
## rdsadmin.activate\$1database
Mengaktifkan database.
Untuk informasi selengkapnya tentang perbedaan antara [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database) dan `rdsadmin.activate_database`, lihat [Catatan penggunaan](#db2-sp-activate-database-usage-notes).
### 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\$1name*
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\$1database](#db2-sp-deactivate-database) Untuk mengaktifkan database pada instance DB sumber replika, Anda harus memanggil prosedur [rdsadmin.reactivate\$1database](#db2-sp-reactivate-database) tersimpan.
Untuk informasi tentang memeriksa status mengaktifkan database, lihat[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.activate_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Contoh berikut mengaktifkan database yang disebut`TESTDB`.
```
db2 "call rdsadmin.activate_database(?, 'TESTDB')"
```
## rdsadmin.reactivate\$1database
Mengaktifkan kembali database.
Untuk informasi tentang perbedaan antara [rdsadmin.activate\$1database](#db2-sp-activate-database) dan`rdsadmin.reactivate_database`, lihat[Catatan penggunaan](#db2-sp-reactivate-database-usage-notes).
### 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\$1name*
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\$1database](#db2-sp-deactivate-database) tersimpan, dan kemudian mengaktifkan database dengan memanggil prosedur tersimpan. [rdsadmin.activate\$1database](#db2-sp-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 jalankan`db2 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\$1database](#db2-sp-deactivate-database) tersimpan, Anda dapat memanggil prosedur yang [rdsadmin.activate\$1database](#db2-sp-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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status)
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.reactivate_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Contoh berikut mengaktifkan kembali database yang disebut. `TESTDB`
```
db2 "call rdsadmin.reactivate_database(?, 'TESTDB')"
```
## rdsadmin.drop\$1database
Mengedrop basis data.
### Sintaks
```
db2 "call rdsadmin.drop_database('database_name')"
```
### Parameter
Parameter berikut diperlukan:
*database\$1name*
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](USER_CreateDBInstance.md#USER_CreateDBInstance.Creating).
+ Anda membuat basis data dengan memanggil prosedur tersimpan [rdsadmin.create\$1database](#db2-sp-create-database).
+ Anda memulihkan basis data dari citra offline atau cadangan dengan memanggil prosedur tersimpan [rdsadmin.restore\$1database](#db2-sp-restore-database).
Sebelum memanggil `rdsadmin.drop_database`, Anda harus menghubungi basis data `rdsadmin`. Dalam contoh berikut, ganti *master\$1username* dan *master\$1password* 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\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.drop_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Contoh berikut menjatuhkan database yang disebut`TESTDB`:
```
db2 "call rdsadmin.drop_database('TESTDB')"
```
## rdsadmin.update\$1db\$1param
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\$1name*
Nama database untuk menjalankan tugas. Tipe datanya `varchar`.
*parameter\$1to\$1modify*
Nama parameter yang akan diubah. Tipe datanya `varchar`. Untuk informasi selengkapnya, lihat [Amazon RDS untuk parameter Db2](db2-supported-parameters.md).
*changed\$1value*
Nilai untuk mengubah nilai parameter. Tipe datanya `varchar`.
Parameter berikut bersifat opsional:
*restart\$1database*
Menentukan apakah RDS restart database jika restart diperlukan. Tipe datanya `varchar`. Untuk memodifikasi `logprimary` dan`logfilsiz`, atur parameter ini ke`'YES'`.
### Catatan penggunaan
Lihat informasi tentang pemeriksaan status pembaruan parameter basis data di [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.update_db_param`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
**Contoh 1: Memperbarui parameter**
Contoh berikut memperbarui `archretrydelay` parameter `100` untuk database yang disebut`TESTDB`:
```
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\$1configuration
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`rdsadmin.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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-restore-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 database Anda. Untuk informasi selengkapnya, lihat [perintah BACKUP DATABASE](https://www.ibm.com/docs/en/db2/11.5?topic=commands-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](https://www.ibm.com/docs/en/db2/11.5.x?topic=databases-remote-storage) dalam IBM Db2 dokumentasi. |
### Contoh
**Contoh 1: Menentukan jumlah buffer untuk membuat**
Contoh berikut menetapkan `RESTORE_DATABASE_NUM_BUFFERS` konfigurasi ke`150`.
```
db2 "call rdsadmin.set_configuration(
'RESTORE_DATABASE_NUM_BUFFERS',
'150')"
```
**Contoh 2: Menentukan jumlah manipulator buffer untuk membuat**
Contoh berikut menetapkan `RESTORE_DATABASE_PARALLELISM` konfigurasi ke`8`.
```
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 ke`5`.
```
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 ke`TRUE`.
```
db2 "call rdsadmin.set_configuration(
'USE_STREAMING_RESTORE',
'TRUE')"
```
## rdsadmin.show\$1configuration
Mengembalikan pengaturan saat ini yang dapat Anda atur dengan menggunakan prosedur yang disimpan`rdsadmin.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 tersimpan`rdsadmin.set_configuration`.
### Contoh
Contoh berikut mengembalikan informasi tentang `RESTORE_DATABASE_PARALLELISM` konfigurasi saat ini.
```
db2 "call rdsadmin.show_configuration(
'RESTORE_DATABASE_PARALLELISM')"
```
## rdsadmin.backup\$1database
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\$1name*
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\$1bucket\$1name*
Nama bucket Amazon S3 tempat Anda ingin cadangan Anda berada. Tipe datanya `varchar`.
Bucket S3 harus ada sebelum memanggil`rdsadmin.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\$1prefix*
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\$1prefix* RDS untuk Db2 mengunggah semua file cadangan ke. *s3\$1prefix/dbi\$1resource\$1id/db\$1name* Jika Anda menetapkan *num\$1files* lebih tinggi dari`1`, *db\$1name* 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\$1prefix* parameter.
```
backups/daily/db-5N7FXOY4GDP7RG2NSH2ZTAI2W4/SAMPLEDB
```
*backup\$1type*
Jenis backup yang menentukan apakah database tetap tersedia selama backup. 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\$1option*
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. Menggunakan`libdb2compr.so`.
+ `ZLIB`- Kompresi Db2 yang ditingkatkan. Penggunaan`libdb2zcompr.so`, tetapi biaya penyimpanan yang lebih intensif CPU dan paling mahal.
*util\$1impact\$1priority*
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 cadangan 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](db2-supported-parameters.md).
*num\$1files*
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\$1buffers*
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_files`diatur ke lebih dari`1`), maka jumlah buffer yang lebih tinggi dapat meningkatkan kinerja. Jika Anda tidak mengatur `compression_option` ke`NONE`, maka Anda dapat meningkatkan kinerja dengan meningkatkan `num_buffers` dan`parallelism`.
### 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\$1database](#db2-sp-restore-database)
Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:
+ Anda hanya dapat membuat cadangan satu database pada satu waktu.
+ Anda tidak dapat melakukan pencadangan dan pemulihan bersama pada instans DB.
+ Enkripsi sisi server Amazon S3 dengan AWS KMS (SSE-KMS) tidak didukung. Bahkan jika bucket S3 disetel ke SSE-KMS, file yang diunggah ke bucket S3 tidak akan menggunakan enkripsi SSE-KMS.
+ Untuk melakukan streaming file cadangan ke Amazon S3, Anda harus sudah mengonfigurasi integrasi. Untuk informasi selengkapnya, lihat [Mengintegrasikan Amazon RDS untuk instans Db2 DB dengan Amazon S3](db2-s3-integration.md).
+ Agar instans RDS untuk Db2 DB dapat berinteraksi dengan Amazon S3, Anda harus memiliki VPC dan titik akhir gateway Amazon S3 agar subnet pribadi dapat digunakan. Untuk informasi selengkapnya, lihat [Langkah 1: Buat titik akhir gateway VPC untuk Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) dan [Langkah 2: Konfirmasikan bahwa titik akhir gateway VPC Anda untuk Amazon S3 ada](db2-troubleshooting.md#db2-confirming-endpoint).
Sebelum memanggil `rdsadmin.backup_database`, Anda harus menghubungi basis data `rdsadmin`. Dalam contoh berikut, ganti *master\$1username* dan *master\$1password* 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, lihat[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.backup_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Semua contoh mencadangkan database yang dipanggil `MYDB` ke bucket Amazon S3 yang dipanggil `amzn-s3-demo-bucket` dan mengatur ke*s3\$1prefix*. `backups/daily`
**Contoh \$11: 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 \$12: Menentukan database online dan tersedia dengan kompresi yang ditingkatkan, 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 \$13: 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 \$14: 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 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\$1database
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\$1name*
Nama database target untuk mengembalikan dalam RDS untuk Db2. Tipe datanya `varchar`.
Misalnya, jika nama database sumber adalah `TESTDB` dan Anda mengatur *database\$1name* ke`NEWDB`, Amazon RDS mengembalikan `NEWDB` sebagai database sumber.
*s3\$1bucket\$1name*
Nama bucket Amazon S3 tempat cadangan Anda berada. Tipe datanya `varchar`.
*s3\$1prefix*
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\$1timestamp*
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\$1type*
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](db2-near-zero-downtime-migration.md).
### 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](db2-migration-approaches.md). 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 mengaktifkan`USE_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 mengaktifkan`USE_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](db2-troubleshooting.md#restore-database-sp-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\$1prefix* `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](db2-troubleshooting.md#restore-database-sp-tablespaces-not-restored).
+ RDS untuk Db2 tidak mendukung rutinitas yang tidak berpagar. Untuk informasi selengkapnya, lihat [Non-fenced routines not allowed](db2-troubleshooting.md#restore-database-sp-non-fenced-routines).
+ 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, gunakan[rdsadmin.show\$1configuration](#db2-sp-show-configuration). Untuk mengubah konfigurasi, gunakan[rdsadmin.set\$1configuration](#db2-sp-set-configuration).
Lihat cara membawa online basis data dan menerapkan log transaksi tambahan setelah memulihkan basis data di [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database).
Lihat informasi tentang pemeriksaan status pemulihan basis data Anda di [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
Untuk pesan kesalahan yang ditampilkan saat menelepon`rdsadmin.restore_database`, lihat[Kesalahan prosedur tersimpan](db2-troubleshooting.md#db2-troubleshooting-stored-procedures).
### Contoh
Contoh berikut mengembalikan cadangan offline dengan satu file atau beberapa file yang memiliki: *s3\$1prefix* `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\$1database
Membawa online basis data dan menerapkan log transaksi tambahan setelah memulihkan basis data dengan memanggil [rdsadmin.restore\$1database](#db2-sp-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\$1name*
Nama database untuk melakukan operasi pada. Tipe datanya `varchar`.
*s3\$1bucket\$1name*
Nama bucket Amazon S3 tempat cadangan Anda berada. Tipe datanya `varchar`.
*s3\$1prefix*
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\$1to\$1option*
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\$1rollforward*
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](#db2-sp-rollforward-database-examples) 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](#db2-sp-rollforward-database-examples) untuk membawa database tanpa log transaksi online.
**Skenario 3: Memajukan 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](#db2-sp-rollforward-database-examples) 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 menelepon[rdsadmin.complete\$1rollforward](#db2-sp-complete-rollforward).
Lihat informasi tentang pemeriksaan status pengguliran maju basis data di [rdsadmin.rollforward\$1status](#db2-sp-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\$1status
Mengembalikan output dari`ROLLFORWARD 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\$1name*
Nama database untuk melakukan operasi pada. Tipe datanya `varchar`.
### Catatan penggunaan
Setelah Anda menelepon[rdsadmin.rollforward\$1database](#db2-sp-rollforward-database), Anda dapat menelepon `rdsadmin.rollforward_status` untuk memeriksa status rollforward dalam database.
Untuk informasi tentang memeriksa status prosedur tersimpan ini, lihat[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).
## rdsadmin.complete\$1rollforward
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\$1name*
Nama basis data yang ingin Anda bawa online. Tipe datanya `varchar`.
### Catatan penggunaan
Jika Anda menelepon [rdsadmin.rollforward\$1database](#db2-sp-rollforward-database) dengan `complete_rollforward` set to`FALSE`, 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\$1status](#db2-sp-rollforward-status)
### Contoh
Contoh berikut membawa TESTDB database online:
```
db2 "call rdsadmin.complete_rollforward(
?,
'TESTDB')"
```
## rdsadmin.db2pd\$1command
Mengumpulkan informasi tentang RDS untuk database Db2.
### Sintaks
```
db2 "call rdsadmin.db2pd_command('db2pd_cmd')"
```
### Parameter
Parameter input berikut diperlukan:
*db2pd\$1cmd*
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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities) 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`
`file`Subopsi 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. `db2pd`Utilitas 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](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2pd-monitor-troubleshoot-db2-engine-activities) dalam dokumentasi. IBM Db2
Output dibatasi hingga maksimum 2 GB.
Untuk informasi tentang memeriksa status pengumpulan informasi tentang database, lihat[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-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 disebut`TESTDB`:
```
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\$1application
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\$1handle*.
Pisahkan nama beberapa aplikasi dengan koma. Contoh: '*application\$1handle\$11*,*application\$1handle\$12*'.
### 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 APPLICATION`Perintah membutuhkan`SYSADM`,`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](https://www.ibm.com/docs/en/db2/11.1?topic=commands-force-application) dalam IBM Db2 dokumentasi.
Untuk informasi tentang memeriksa status memaksa aplikasi keluar dari database, lihat[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-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 aplikasi`9991`,`8891`, dan `1192` off dari RDS untuk database Db2:
```
db2 "call rdsadmin.force_application(
?,
'9991, 8891, 1192')"
```
## rdsadmin.set\$1archive\$1log\$1retention
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\$1name*
Nama database untuk mengonfigurasi penyimpanan log arsip untuk. Tipe datanya `varchar`.
*archive\$1log\$1retention\$1hours*
Jumlah jam untuk menyimpan file log arsip. Tipe datanya `smallint`. Defaultnya adalah`0`, dan maksimum adalah `840` (35 hari).
Jika nilainya`0`, 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 menelepon[rdsadmin.show\$1archive\$1log\$1retention](#db2-sp-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 disebut`TESTDB`.
```
db2 "call rdsadmin.set_archive_log_retention(
?,
'TESTDB',
'0')"
```
## rdsadmin.show\$1archive\$1log\$1retention
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\$1name*
Nama database untuk menampilkan pengaturan penyimpanan log arsip untuk. Tipe datanya `varchar`.
### Contoh
Contoh berikut menunjukkan pengaturan penyimpanan log arsip untuk database yang disebut`TESTDB`.
```
db2 "call rdsadmin.show_archive_log_retention(?,'TESTDB')"
```
## rdsadmin.list\$1archive\$1log\$1information
Mengembalikan rincian tentang file log arsip, seperti ukuran, tanggal pembuatan dan waktu, dan nama file log individu untuk database tertentu. 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\$1name*
Nama database untuk mencantumkan informasi log arsip untuk. Tipe datanya `varchar`.
### Contoh
Contoh berikut mengembalikan informasi log arsip untuk database yang disebut`TESTDB`.
```
db2 "call rdsadmin.list_archive_log_information(
?,
'TESTDB')"
```
## rdsadmin.enable\$1archive\$1log\$1copy
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\$1name*
Nama database untuk mengaktifkan salinan log arsip ke Amazon S3. Tipe datanya `varchar`.
### Contoh
Contoh berikut memungkinkan salinan log arsip untuk database yang disebut`TESTDB`.
```
db2 "call rdsadmin.enable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.disable\$1archive\$1log\$1copy
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\$1name*
Nama database untuk menonaktifkan salinan log arsip ke Amazon S3. Tipe datanya `varchar`.
### Contoh
Contoh berikut menonaktifkan salinan log arsip untuk database yang disebut`TESTDB`.
```
db2 "call rdsadmin.disable_archive_log_copy(
?,
'TESTDB')"
```
## rdsadmin.fgac\$1command
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\$1name*
Nama database tempat Anda ingin menjalankan perintah FGAC. Tipe datanya `varchar`.
*fgac\$1cmd*
Perintah kontrol akses berbutir halus yang ingin Anda jalankan. Tipe datanya `varchar`.
Perintah berikut ini 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 (\$1). 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'')')"
```
## rdsadmin.db2support\$1command
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\$1name*
Nama database untuk mengumpulkan informasi diagnostik untuk. Tipe datanya `varchar`.
*s3\$1bucket\$1name*
Nama bucket Amazon S3 tempat Anda ingin mengunggah informasi diagnostik. Tipe datanya `varchar`.
*s3\$1prefix*
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 ke bucket Amazon S3.
Prosedur yang disimpan menggunakan IBM `db2support` utilitas untuk mengumpulkan data diagnostik. Untuk informasi selengkapnya tentang utilitas, lihat [db2support - Analisis masalah dan perintah alat pengumpulan lingkungan dalam dokumentasi](https://www.ibm.com/docs/en/db2/11.5?topic=commands-db2support-problem-analysis-environment-collection-tool). IBM Db2
Sebelum memanggil prosedur yang disimpan, tinjau pertimbangan berikut:
+ Untuk mengunggah file diagnostik ke Amazon S3, Anda harus sudah mengonfigurasi integrasi. Untuk informasi selengkapnya, lihat [Mengintegrasikan Amazon RDS untuk instans Db2 DB dengan Amazon S3](db2-s3-integration.md).
+ Agar instans RDS untuk Db2 DB dapat berinteraksi dengan Amazon S3, Anda harus memiliki VPC dan titik akhir gateway Amazon S3 agar subnet pribadi dapat digunakan. Untuk informasi selengkapnya, lihat [Langkah 1: Buat titik akhir gateway VPC untuk Amazon S3](db2-troubleshooting.md#db2-creating-endpoint) dan [Langkah 2: Konfirmasikan bahwa titik akhir gateway VPC Anda untuk Amazon S3 ada](db2-troubleshooting.md#db2-confirming-endpoint).
Sebelum memanggil `rdsadmin.db2support_command`, Anda harus menghubungi basis data `rdsadmin`. Dalam contoh berikut, ganti *master\$1username* dan *master\$1password* dengan RDS Anda untuk informasi instans Db2 DB:
```
db2 connect to rdsadmin user master_username using master_password
```
Untuk informasi tentang memeriksa status pengumpulan informasi diagnostik, lihat[rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-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 `amzn-s3-demo-bucket` dipanggil 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 `amzn-s3-demo-bucket` dipanggil dengan awalan berbasis tanggal:
```
db2 "call rdsadmin.db2support_command(
?,
'MYDB',
'amzn-s3-demo-bucket',
'support/2024/01/15')"
```