

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**
+ [Migrasi cluster DocumentDB yang ada ke tanpa server](#w2aac41c19b5)
+ [Migrasi dari MongoDB ke DocumentDB tanpa server](#w2aac41c19b7)

## Migrasi cluster DocumentDB yang ada ke tanpa server
<a name="w2aac41c19b5"></a>

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

Jika klaster yang disediakan menjalankan versi engine yang lebih rendah yang tidak mendukung DocumentDB tanpa server, Anda harus terlebih dahulu memutakhirkan klaster ke versi engine yang didukung. Untuk informasi selengkapnya, lihat [Peningkatan 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 mengganti klaster yang disediakan agar 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 klaster yang disediakan menjalankan versi engine yang tidak tersedia untuk DocumentDB tanpa server, tingkatkan versi mesin cluster. Lihat [Peningkatan 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 memodifikasi konfigurasi penskalaan klaster, lihat[Melihat dan memodifikasi konfigurasi rentang kapasitas penskalaan klaster](docdb-serverless-managing.md#docdb-serverless-range-config).

1. Konfigurasikan properti cluster lainnya untuk memperhitungkan persyaratan dan batasan tanpa server DocumentDB. [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 instance 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) Konversi instans Amazon DocumentDB yang tersisa yang disediakan ke instance [Mengubah kelas instance](db-instance-classes.md#db-instance-class-changing) tanpa server DocumentDB (lihat) atau hapus 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 kluster yang disediakan Amazon DocumentDB yang menjalankan Amazon DocumentDB 5.0.0, yang tidak memerlukan upgrade versi engine 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 digantikan oleh 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 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-menu-icon.png)) di pojok kiri atas halaman.

   Tabel **Clusters** muncul.

1. Dalam tabel **Clusters**, pilih kotak centang cluster yang ingin Anda tambahkan instance tanpa server.

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

1. Dalam kotak dialog **Add instance**, pilih **Tanpa Server** di bagian **kelas instans DB untuk setiap instance** 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 contoh 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](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).

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

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

Selama penghapusan, failover secara otomatis dilakukan untuk mempromosikan salah satu contoh yang tersisa untuk 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 kluster yang disediakan Amazon DocumentDB yang menjalankan Amazon DocumentDB 5.0.0, yang tidak memerlukan upgrade versi engine 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 digantikan oleh 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 output hasil 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, instance tanpa server baru bernama `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 menjadikan `sample-serverless-instance-1` instance baru sebagai penulis cluster:

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

Failover membutuhkan beberapa detik untuk menyelesaikannya, setelah itu sample-serverless-instance -1 menjadi penulis cluster. Verifikasi ini dengan masukan 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 instance 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="w2aac41c19b7"></a>

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