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

# Mengonversi konfigurasi satu penghuni menjadi multi-penghuni
<a name="oracle-single-tenant-converting"></a>

Anda dapat memodifikasi arsitektur CDB RDS for Oracle dari konfigurasi satu penghuni menjadi multi-penghuni. Sebelum dan sesudah konversi, CDB Anda berisi basis data satu penghuni (PDB). Tag untuk instans DB menyebar ke database penyewa awal yang dibuat selama konversi.

Sebelum memulai, pastikan bahwa kebijakan IAM Anda memiliki izin untuk membuat database penyewa. Selama konversi, RDS for Oracle memigrasikan metadata berikut ke basis data penghuni baru:
+ Nama pengguna utama
+ Kata sandi master terkelola (jika sumber CDB terintegrasi dengan Secrets Manager)
+ Nama basis data
+ Set karakter
+ Set karakter nasional

Sebelum konversi, Anda melihat informasi sebelumnya dengan menggunakan perintah. `describe-db-instances` Setelah konversi, Anda melihat informasi menggunakan perintah `describe-tenant-database`.

Konversi dari penyewa tunggal ke multi-tenant memiliki keterbatasan sebagai berikut:
+ Anda nantinya tidak dapat mengonversi kembali ke konfigurasi penyewa tunggal setelah Anda mengonversi ke konfigurasi multi-penyewa. Konversi tidak dapat diubah.
+ Basis data primer atau replika yang mengaktifkan Oracle Data Guard tidak dapat dikonversi.
+ Anda tidak dapat meningkatkan versi mesin DB dan melakukan konversi ke konfigurasi multi-penghuni dalam operasi yang sama.
+ Anda tidak dapat mengaktifkan atau menonaktifkan kata sandi pengguna master terkelola selama konversi.

## Konsol
<a name="oracle-cdb.configuring.converting.console"></a>

**Untuk mengonversi CDB yang menggunakan konfigurasi satu penghuni ke multi-penghuni**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di sudut kanan atas konsol Amazon RDS, pilih Wilayah AWS tempat instans DB Anda berada.

1. Di panel navigasi, pilih **Basis data**, lalu pilih instans non-CDB yang ingin Anda konversi menjadi instans CDB. 

1. Pilih **Ubah**.

1. Untuk **Pengaturan arsitektur**, pilih **Arsitektur multi-penghuni Oracle**.

1. Untuk **konfigurasi Arsitektur**, pilih **Multi-tenant konfigurasi**.

1. (Opsional) Untuk **Grup parameter DB**, pilih grup parameter baru untuk instans CDB Anda. Pertimbangan grup parameter yang berlaku saat mengonversi instans DB sama seperti saat meningkatkan instans DB.

1. (Opsional) Untuk **Grup opsi**, pilih grup opsi baru untuk instans CDB Anda. Pertimbangan grup opsi yang berlaku saat mengonversi instans DB sama seperti saat meningkatkan instans DB.

1. Jika semua perubahan sudah sesuai dengan keinginan Anda, pilih **Lanjutkan** dan periksa ringkasan modifikasi. 

1. Pilih **Terapkan langsung**. Opsi ini diperlukan saat Anda beralih ke konfigurasi multi-penghuni. Perlu diketahui bahwa opsi ini dapat menyebabkan waktu henti dalam beberapa kasus.

1. Di halaman konfirmasi, tinjau perubahan Anda. Jika sudah benar, pilih **Modifikasi instans DB**.

   Atau pilih **Kembali** untuk mengedit perubahan atau **Batal** untuk membatalkan perubahan.

## AWS CLI
<a name="oracle-cdb.configuring.converting.cli"></a>

[Untuk mengonversi CDB menggunakan konfigurasi penyewa tunggal ke konfigurasi multi-tenant, tentukan `--multi-tenant` dalam perintah modify-db-instance. AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)

Contoh berikut mengonversi instans DB bernama `my-st-cdb` dari konfigurasi satu penghuni ke multi-penghuni. Opsi `--apply-immediately` diperlukan.

**Example**  
Untuk Linux, macOS, atau Unix:  

```
aws rds modify-db-instance --region {{us-east-1}}\
    --db-instance-identifier {{my-st-cdb}} \
    --multi-tenant \
    --apply-immediately
```
Untuk Windows:  

```
aws rds modify-db-instance --region {{us-east-1}} ^
    --db-instance-identifier {{my-st-cdb}} ^
    --multi-tenant ^
    --apply-immediately
```
Output-nya akan terlihat seperti berikut.  

```
{
    "DBInstance": {
        "DBInstanceIdentifier": "my-st-cdb",
        "DBInstanceClass": "db.r5.large",
        "MultiTenant": false,
        "Engine": "oracle-ee-cdb",
        "DBResourceId": "db-AB1CDE2FGHIJK34LMNOPRLXTXU",
        "DBInstanceStatus": "modifying",
        "MasterUsername": "admin",
        "DBName": "ORCL",
        ...
        "EngineVersion": "19.0.0.0.ru-2022-01.rur-2022-01.r1",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "bring-your-own-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:oracle-ee-cdb-19",
                "Status": "in-sync"
            }
        ],
        ...
        "PendingModifiedValues": {
            "MultiTenant": "true"
        }
    }
}
```