

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

# Bermigrasi ke Amazon DocumentDB tanpa server
<a name="docdb-serverless-migrating"></a>

**Topics**
+ [Memigrasikan cluster DocumentDB yang ada ke tanpa server](#w2aac51c19b5)
+ [Migrasi dari MongoDB ke DocumentDB tanpa server](#w2aac51c19b7)

## Memigrasikan cluster DocumentDB yang ada ke tanpa server
<a name="w2aac51c19b5"></a>

### Memutakhirkan versi mesin cluster
<a name="w2aac51c19b5b3"></a>

Jika cluster yang disediakan menjalankan versi engine yang lebih rendah yang tidak mendukung DocumentDB tanpa server, Anda harus terlebih dahulu memutakhirkan cluster ke versi engine yang didukung. Untuk informasi selengkapnya, lihat [Pembaruan versi utama Amazon DocumentDB di tempat](docdb-mvu.md).

### Migrasi cluster yang disediakan ke DocumentDB tanpa server
<a name="docdb-serverless-migrate-cluster"></a>

Untuk mengalihkan cluster yang disediakan untuk menggunakan DocumentDB tanpa server, ikuti langkah-langkah berikut:

1. Periksa apakah versi engine cluster yang disediakan perlu ditingkatkan untuk digunakan dengan DocumentDB tanpa server. Lihat [Persyaratan dan batasan untuk DocumentDB tanpa server](docdb-serverless-limitations.md).
**catatan**  
Jika cluster yang disediakan menjalankan versi mesin yang tidak tersedia untuk DocumentDB tanpa server, tingkatkan versi engine cluster. Lihat [Pembaruan versi utama Amazon DocumentDB di tempat](docdb-mvu.md).

1. Konfigurasikan konfigurasi penskalaan untuk klaster. Untuk detail tentang memilih konfigurasi penskalaan, lihat[Memilih rentang kapasitas penskalaan untuk cluster tanpa server DocumentDB](docdb-serverless-scaling-config.md#docdb-serverless-scaling-capacity-choosing). Untuk mengubah konfigurasi penskalaan untuk cluster, lihat[Melihat dan memodifikasi konfigurasi rentang kapasitas penskalaan cluster](docdb-serverless-managing.md#docdb-serverless-range-config).

1. Konfigurasikan properti cluster lainnya untuk memperhitungkan persyaratan dan batasan tanpa server DocumentDB dari. [Persyaratan dan batasan untuk DocumentDB tanpa server](docdb-serverless-limitations.md)

1. Tambahkan satu atau beberapa instance tanpa server DocumentDB ke cluster. Ikuti prosedur di [Menambahkan instans tanpa server Amazon DocumentDB](docdb-serverless-create-cluster.md#docdb-serverless-adding-instance).
**catatan**  
Dalam beberapa kasus, Anda mungkin sudah memiliki satu atau lebih instance pembaca yang disediakan di cluster. Jika demikian, Anda dapat memilih untuk mengonversi salah satu pembaca ke instance tanpa server DocumentDB alih-alih membuat instance baru. Untuk melakukannya, ikuti prosedurnya di [Mengubah kelas instance](db-instance-classes.md#db-instance-class-changing).

1. (Opsional) Lakukan operasi failover untuk menjadikan instance tanpa server DocumentDB sebagai penulis cluster. Lihat [Failover Amazon DocumentDB](failover.md).

1. (Opsional) Mengonversi instans Amazon DocumentDB yang tersisa yang disediakan menjadi instans tanpa server DocumentDB (lihat[Mengubah kelas instance](db-instance-classes.md#db-instance-class-changing)) atau hapus instans tersebut dari cluster (lihat). [Menghapus instans Amazon DocumentDB](db-instance-delete.md)

------
#### [ Using the Konsol Manajemen AWS ]

Contoh Konsol Manajemen AWS konfigurasi berikut menunjukkan proses migrasi menggunakan cluster yang disediakan Amazon DocumentDB yang menjalankan Amazon DocumentDB 5.0.0, yang tidak memerlukan peningkatan versi mesin untuk mulai menggunakan DocumentDB tanpa server. Cluster diberi nama`sample`, dan dimulai dengan tiga instance yang disediakan bernama`sample`,`sample2`, dan`sample3`. Dalam contoh ini, ketiga instance ini akan diganti dengan tiga instance tanpa server.

1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) dan buka konsol Amazon DocumentDB.

1. Di panel navigasi, pilih **Klaster**.
**Tip**  
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu (![Menu button.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.

   **Tabel ** Cluster muncul.

1. Dalam ** tabel ** Cluster, pilih kotak centang cluster tempat Anda ingin menambahkan instance tanpa server.

1. Pilih **Tindakan**, dan kemudian pilih **Tambahkan instans**.

1. Di kotak ** dialog Tam ** bah instans, pilih ** Tanpa server ** di ** bagian kelas instance ** DB untuk setiap instans tanpa server baru yang ingin Anda buat.

1. Untuk pengaturan kapasitas ** tanpa server**, atur konfigurasi penskalaan berdasarkan deskripsi kapasitas di kotak dialog.

1. (Opsional) Untuk menambahkan instance lain, pilih ** Tambahkan instance**. Lanjutkan menambahkan instance hingga Anda mencapai jumlah instans baru yang diinginkan.

   Dalam contoh ini, tiga instance tanpa server baru dibuat.

1. Pilih **Buat**.

   Dibutuhkan beberapa menit untuk membuat sebuah instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat [Memantau status cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).

1. Kembali ke ** tabel ** Cluster, pilih kotak centang dari ketiga instance asli yang disediakan.

1. Pilih **Tindakan**, lalu pilih **Hapus**.

Selama penghapusan, failover dilakukan secara otomatis untuk mempromosikan salah satu instance yang tersisa menjadi penulis. Setelah beberapa menit, proses penghapusan selesai. Cluster yang ada sekarang berisi tiga instance tanpa server DocumentDB (seperti yang didefinisikan dalam ** kolom ** Ukuran).

------
#### [ Using the AWS CLI ]

Contoh AWS CLI konfigurasi berikut menunjukkan proses migrasi menggunakan cluster yang disediakan Amazon DocumentDB yang menjalankan Amazon DocumentDB 5.0.0, yang tidak memerlukan peningkatan versi mesin untuk mulai menggunakan DocumentDB tanpa server. Cluster diberi nama`sample`, dan dimulai dengan tiga instance yang disediakan bernama`sample`,`sample2`, dan`sample3`. Dalam contoh ini, ketiga instance ini akan diganti dengan tiga instance tanpa server. Cluster diberi nama`sample-cluster`, dan dimulai dengan dua instance yang disediakan bernama `sample-provisioned-instance-1` dan`sample-provisioned-instance-2`, instance penulis dan instance pembaca.

Dalam contoh berikut, ganti masing-masing {{user input placeholder}} dengan informasi atau parameter konfigurasi Anda sendiri.

Gunakan `aws docdb describe-db-clusters` operasi untuk menentukan status cluster. Kode berikut menemukan status cluster `sample-cluster` dan mengeluarkan hasilnya dalam tabel:

```
aws docdb describe-db-clusters \
    --db-cluster-identifier {{sample-cluster}} \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table
```

```
--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+
```

Tambahkan konfigurasi penskalaan untuk cluster:

```
aws docdb modify-db-cluster \
    --db-cluster-identifier {{sample-cluster}} \
    --serverless-v2-scaling-configuration MinCapacity={{0.5}},MaxCapacity={{16}}
```

Tambahkan instance tanpa server. Dalam contoh ini, instans tanpa server baru diberi nama `sample-serverless-instance-1` dan `sample-serverless-instance-2` ditambahkan:

```
aws docdb create-db-instance \
    --db-cluster-identifier {{sample-cluster}} \
    --db-instance-identifier {{sample-serverless-instance-1}} \
    --db-instance-class db.serverless \
    --engine docdb

aws docdb create-db-instance \
    --db-cluster-identifier {{sample-cluster}} \
    --db-instance-identifier {{sample-serverless-instance-2}} \
    --db-instance-class db.serverless \
    --engine docdb
```

Masukkan yang berikut ini untuk menunggu instans tanpa server tersedia sebelum melanjutkan:

```
aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-1

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-2
```

Lakukan failover untuk membuat `sample-serverless-instance-1` instance baru penulis cluster:

```
aws docdb failover-db-cluster \
    --db-cluster-identifier {{sample-cluster}} \
    --target-db-instance-identifier {{sample-serverless-instance-1}}
```

Failover membutuhkan waktu beberapa detik untuk diselesaikan, setelah itu sample-serverless-instance-1 menjadi penulis cluster. Verifikasi ini dengan input berikut:

```
aws docdb describe-db-clusters \
    --db-cluster-identifier {{sample-cluster}} \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table
```

```
--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+
```

Terakhir, hapus instans asli yang disediakan:

```
aws docdb delete-db-instance \
    --db-instance-identifier {{sample-provisioned-instance-1}}

aws docdb delete-db-instance \
    --db-instance-identifier {{sample-provisioned-instance-2}}
```

------

## Migrasi dari MongoDB ke DocumentDB tanpa server
<a name="w2aac51c19b7"></a>

Anda dapat memigrasikan database MongoDB Anda ke DocumentDB tanpa server, seperti halnya dengan Amazon DocumentDB yang disediakan. Untuk informasi selengkapnya, lihat [Migrasi dan upgrade Amazon DocumentDB](docdb-migration.md).