Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Mengelola sumber daya Amazon DocumentDB Bagian ini mencakup berbagai komponen dan tugas terkaitnya untuk mengelola implementasi Amazon DocumentDB (dengan kompatibilitas MongoDB) Anda. **Topics** + [Ikhtisar tugas operasional](operational_tasks.md) + [Klaster Global](global-clusters.md) + [Mengelola klaster](db-clusters.md) + [Mengelola contoh](db-instances.md) + [Mengelola grup subnet](document-db-subnet-groups.md) + [Ketersediaan dan replikasi tinggi](replication.md) + [Mengelola indeks](managing-indexes.md) + [Mengelola kompresi dokumen](doc-compression.md) + [Mengelola kompresi berbasis kamus](dict-compression.md) + [Mengelola acara](managing-events.md) + [Memilih wilayah dan zona ketersediaan](regions-and-azs.md) + [Mengelola kelompok parameter cluster](cluster_parameter_groups.md) + [Memahami titik akhir](endpoints.md) + [Memahami Amazon DocumentDB ARNs](documentdb-arns.md) + [Pemberian tag pada sumber daya](tagging.md) + [Memelihara Amazon DocumentDB](db-instance-maintain.md) + [Memahami peran terkait layanan](service-linked-roles.md) + [Menggunakan aliran perubahan](change_streams.md) + [Menggunakan Collation](collation.md) + [Menggunakan Tampilan](views.md) + [Menggunakan AWS Lambda dengan aliran perubahan](using-lambda.md) # Ikhtisar tugas operasional Amazon DocumentDB Bagian ini mencakup tugas operasional untuk klaster Amazon DocumentDB Anda, dan cara menyelesaikan tugas ini menggunakan. AWS CLI **Topics** + [Menambahkan replika ke cluster Amazon DocumentDB](#operational_tasks-add_replica) + [Menjelaskan cluster dan instance](#operational_tasks-list_clusters_and_instances) + [Membuat snapshot cluster](#operational_tasks-creating_snapshot) + [Memulihkan dari snapshot](#operational_tasks-restore_from_snapshot) + [Menghapus instance dari cluster](#operational_tasks-remove_instance_from_cluster) + [Menghapus klaster](#operational_tasks-delete_cluster) ## Menambahkan replika ke cluster Amazon DocumentDB Setelah Anda membuat instans primer untuk klaster Amazon DocumentDB, Anda dapat menambahkan satu atau beberapa *replika*. Replika adalah instans baca-saja yang melayani dua tujuan: + **Skalabilitas** — Jika Anda memiliki banyak klien yang memerlukan akses bersamaan, Anda dapat menambahkan lebih banyak replika untuk penskalaan baca. + **Ketersediaan tinggi** — Jika instans primer gagal, Amazon DocumentDB secara otomatis gagal ke instans replika dan menetapkannya sebagai primer baru. Jika replika gagal, instans lain di klaster masih dapat melayani permintaan hingga node yang gagal dapat dipulihkan. Setiap klaster Amazon DocumentDB dapat mendukung hingga 15 replika. **catatan** Untuk toleransi kesalahan maksimum, Anda harus menerapkan replika di Availability Zone yang terpisah. Ini membantu memastikan bahwa klaster Amazon DocumentDB Anda dapat terus berfungsi, bahkan jika seluruh Availability Zone menjadi tidak tersedia. AWS CLI Contoh berikut menunjukkan cara menambahkan replika baru. Parameter `--availability-zone` menempatkan replika di Availability Zone yang ditentukan. ``` aws docdb create-db-instance \ --db-instance-identifier sample-instance \ --db-cluster-identifier sample-cluster \ --engine docdb \ --db-instance-class db.r5.large \ --availability-zone us-east-1a ``` ## Menjelaskan cluster dan instance AWS CLI Contoh berikut mencantumkan semua cluster Amazon DocumentDB di Wilayah. Untuk fitur pengelolaan tertentu seperti pengelolaan siklus hidup klaster dan instans, Amazon DocumentDB memanfaatkan teknologi operasi yang dibagikan dengan Amazon RDS. Parameter filter `filterName=engine,Values=docdb` hanya mengembalikan klaster Amazon DocumentDB. Untuk informasi lebih lanjut tentang mendeskripsikan dan memodifikasi klaster, lihat [Siklus hidup klaster Amazon DocumentDB](db-cluster-life-cycle.md). ``` aws docdb describe-db-clusters --filter Name=engine,Values=docdb ``` Output dari operasi ini terlihat seperti berikut ini. ``` { "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] } ``` AWS CLI Contoh berikut mencantumkan instance dalam cluster Amazon DocumentDB. Untuk informasi lebih lanjut tentang mendeskripsikan dan memodifikasi cluster, lihat [Siklus hidup instance Amazon DocumentDB](db-instance-life-cycle.md). ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` Output terlihat seperti di bawah ini. Dalam output ini, ada dua instans. Instans primer adalah `sample-instance-1` (`"IsClusterWriter": true`). Ada juga instans replika, `sample-instance2` (`"IsClusterWriter: false"`). ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-cluster-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ## Membuat snapshot cluster *Snapshot klaster* adalah cadangan lengkap data di klaster Amazon DocumentDB Anda. Saat snapshot sedang dibuat, Amazon DocumentDB membaca data Anda langsung dari volume klaster. Karena ini, Anda dapat membuat snapshot meskipun klaster Anda tidak memiliki instans yang berjalan pada saat itu. Jumlah waktu yang diperlukan untuk membuat snapshot bergantung pada ukuran volume klaster Anda. Amazon DocumentDB mendukung pencadangan otomatis, yang terjadi setiap hari selama jendela pencadangan pilihan — periode waktu 30 menit pada siang hari. AWS CLI Contoh berikut menunjukkan cara melihat jendela cadangan untuk cluster Anda: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].PreferredBackupWindow' ``` Output menunjukkan jendela cadangan (dalam UTC): ``` [ "00:18-00:48" ] ``` Anda dapat menentukan jendela pencadangan saat membuat klaster Amazon DocumentDB Anda. Anda juga dapat mengubah jendela pencadangan, seperti yang ditunjukkan pada contoh berikut. Jika Anda tidak menentukan jendela pencadangan, Amazon DocumentDB secara otomatis menugaskan satu ke klaster Anda. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --preferred-backup-window "02:00-02:30" ``` Selain pencadangan otomatis, Anda dapat membuat snapshot klaster secara manual kapan saja. Saat melakukannya, Anda menentukan klaster mana yang ingin Anda cadangkan, dan nama unik untuk snapshot Anda sehingga Anda dapat memulihkannya nanti. AWS CLI Contoh berikut menunjukkan cara membuat snapshot data Anda. ``` aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` ## Memulihkan dari snapshot Anda dapat memulihkan snapshot klaster ke klaster Amazon DocumentDB baru. Untuk melakukannya, Anda memberikan nama snapshot dan nama klaster baru. Anda tidak dapat memulihkan dari snapshot ke klaster yang ada; sebagai gantinya, Amazon DocumentDB membuat klaster baru saat Anda memulihkan dan kemudian mengisinya dengan data snapshot Anda. Contoh berikut menunjukkan semua snapshot untuk klaster `sample-cluster`. ``` aws docdb describe-db-cluster-snapshots \ --db-cluster-identifier sample-cluster \ --query 'DBClusterSnapshots[*].[DBClusterSnapshotIdentifier,SnapshotType,Status]' ``` Outputnya terlihat seperti berikut ini. Snapshot manual adalah snapshot yang Anda buat secara manual, sedangkan snapshot otomatis dibuat oleh Amazon DocumentDB dalam jendela pencadangan klaster. ``` [ "sample-cluster-snapshot", "manual", "available" ], [ "rds:sample-cluster", "automated", "available" ] ] ``` Contoh berikut menunjukkan cara memulihkan klaster Amazon DocumentDB dari snapshot. ``` aws docdb restore-db-cluster-from-snapshot \ --engine docdb \ --db-cluster-identifier new-sample-cluster \ --snapshot-identifier sample-cluster-snapshot ``` Klaster baru tidak memiliki instans yang terkait dengannya; jadi jika Anda ingin berinteraksi dengan klaster, Anda harus menambahkan instans ke dalamnya. ``` aws docdb create-db-instance \ --db-instance-identifier new-sample-instance \ --db-instance-class db.r5.large \ --engine docdb \ --db-cluster-identifier new-sample-cluster ``` Anda dapat menggunakan AWS CLI operasi berikut untuk memantau kemajuan pembuatan cluster dan instance. Saat status klaster dan instans tersedia, Anda dapat terhubung ke titik akhir klaster baru dan mengakses data Anda. ``` aws docdb describe-db-clusters \ --db-cluster-identifier new-sample-cluster \ --query 'DBClusters[*].[Status,Endpoint]' ``` ``` aws docdb describe-db-instances \ --db-instance-identifier new-sample-instance \ --query 'DBInstances[*].[DBInstanceStatus]' ``` ## Menghapus instance dari cluster Amazon DocumentDB menyimpan semua data Anda dalam volume klaster. Data tetap ada dalam volume klaster tersebut, meskipun Anda menghapus semua instans dari klaster Anda. Jika Anda perlu mengakses data lagi, Anda dapat menambahkan instans ke klaster kapan saja, dan melanjutkan dari bagian terakhir yang Anda tinggalkan. Contoh berikut menunjukkan cara menghapus instans dari klaster Amazon DocumentDB Anda. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance ``` ## Menghapus klaster Sebelum Anda dapat menghapus klaster Amazon DocumentDB, Anda harus menghapus semua instansnya terlebih dahulu. AWS CLI Contoh berikut mengembalikan informasi tentang contoh dalam cluster. Jika operasi ini mengembalikan pengidentifikasi instans apa pun, Anda harus menghapus setiap instans. Untuk informasi selengkapnya, lihat [Menghapus instance dari cluster](#operational_tasks-remove_instance_from_cluster). ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers[*].DBInstanceIdentifier' ``` Jika tidak ada lagi instans yang tersisa, Anda dapat menghapus klaster. Pada saat itu, Anda harus memilih salah satu dari opsi berikut: + **Buat snapshot akhir** — Tangkap semua data klaster dalam snapshot sehingga Anda dapat membuat ulang instans baru dengan data tersebut nanti. Contoh berikut menunjukkan cara melakukannya: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-snapshot ``` + **Lewati snapshot terakhir** — Buang semua data klaster secara permanen. Ini tidak bisa dibalik. Contoh berikut menunjukkan cara melakukannya: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` # Ikhtisar cluster global Amazon DocumentDB ## Apa itu klaster global? Cluster global terdiri dari satu wilayah primer dan hingga 10 wilayah sekunder hanya-baca. Anda menerbitkan operasi tulis langsung ke klaster primer di wilayah primer dan Amazon DocumentDB secara otomatis mereplikasi data ke wilayah sekunder menggunakan infrastruktur khusus. Latensi biasanya di bawah satu detik. ## Bagaimana klaster global berguna? + **Pemulihan dari pemadaman di seluruh wilayah** — Jika terjadi pemadaman di seluruh wilayah, Anda dapat mempromosikan salah satu cluster sekunder ke cluster utama dalam beberapa menit, dengan Tujuan Waktu Pemulihan (RTO) khas kurang dari satu menit. Recovery Point Objective (RPO) biasanya diukur dalam hitungan detik, tetapi ini tergantung pada lag di seluruh jaringan pada saat kegagalan. + **Pembacaan global dengan latensi lokal ** — Jika Anda memiliki kantor di seluruh dunia, Anda dapat menggunakan klaster global untuk terus memperbarui sumber informasi utama Anda di wilayah primer. Kantor di wilayah Anda yang lain dapat mengakses informasi di wilayah mereka sendiri, dengan latensi lokal. + **Klaster sekunder yang dapat diskalakan **— Anda dapat menskalakan klaster sekunder dengan menambahkan lebih banyak instans baca-saja ke wilayah sekunder. Klaster sekunder bersifat baca-saja, sehingga dapat mendukung hingga 16 instans replika hanya-baca daripada batas biasa 15 untuk satu klaster. + **Replikasi cepat dari klaster primer ke sekunder** — Replikasi yang dilakukan oleh klaster global memiliki dampak performa yang kecil pada klaster basis data primer. Sumber daya instans DB sepenuhnya dikhususkan untuk melayani beban kerja baca dan tulis aplikasi. ## Apa keterbatasan terkini klaster global? + Klaster global tidak didukung di Amazon DocumentDB v3.6. + Cluster global didukung pada semua jenis instans kecuali db.t3, db.t4g, dan db.r4. + Cluster global tidak tersedia di Wilayah berikut: Amerika Selatan (São Paulo), Eropa (Milan), Tiongkok (Beijing), dan Tiongkok (Ningxia). + Switchover dan failover global tidak didukung ketika wilayah menggunakan versi mesin yang berbeda. Failover manual didukung ketika ada ketidakcocokan versi mesin. + Hanya klaster primer yang melakukan operasi penulisan. Klien yang melakukan operasi tulis terhubung ke titik akhir klaster dari klaster primer. + Anda dapat memiliki maksimal 10 wilayah sekunder dan satu wilayah utama untuk cluster Anda. + Klaster sekunder tidak dapat dihentikan. Sebuah klaster primer tidak dapat dihentikan jika ia memiliki klaster sekunder yang terkait dengannya. Hanya klaster wilayah yang tidak memiliki klaster sekunder yang dapat dihentikan. + Replika yang dilampirkan ke klaster sekunder dapat dimulai ulang dalam keadaan tertentu. Jika instans wilayah primer dimulai ulang atau gagal, replika di region sekunder juga dimulai ulang. Klaster kemudian tidak tersedia sampai semua replika kembali disinkronkan dengan instans penulis klaster basis data primer. Perilaku ini yang diharapkan. Pastikan Anda memahami dampak terhadap klaster global Anda sebelum membuat perubahan pada klaster primer Anda. + Anda tidak dapat menggunakan perubahan aliran pada klaster sekunder. **Topics** + [Apa itu klaster global?](#w2aac33b9b3) + [Bagaimana klaster global berguna?](#w2aac33b9b5) + [Apa keterbatasan terkini klaster global?](#w2aac33b9b7) + [Panduan memulai cepat](global-clusters.get-started.md) + [Mengelola klaster global](global-clusters.manage.md) + [Menghubungkan cluster global](global-clusters-connect.md) + [Memantau klaster global](global-clusters-monitor.md) + [Pemulihan bencana](global-clusters-disaster-recovery.md) # Panduan memulai cepat: cluster global **Topics** + [Konfigurasi](#global-clusters.config) + [Membuat klaster global](#global-clusters-create) + [Menambahkan Region ke klaster global](#global-clusters.add-region) + [Menggunakan snapshot](#global-clusters.snapshot) ## Konfigurasi Cluster global Amazon DocumentDB mencakup setidaknya dua. Wilayah AWS Wilayah primer mendukung klaster yang memiliki satu instance (penulis) primer dan hingga 15 instance replika, sedangkan Region sekunder menjalankan cluster hanya-baca yang seluruhnya terdiri dari hingga 16 instance replika. Sebuah cluster global dapat memiliki hingga lima Wilayah sekunder. Tabel mencantumkan klaster, instans, dan replika maksimum yang diizinkan dalam klaster global. | Deskripsi | Primer Wilayah AWS | Sekunder Wilayah AWS | | --- | --- | --- | | klaster | 1 | 5 (maksimum) | | Instans penulis | 1 | 0 | | Instans baca saja (replika Amazon DocumentDB), per klaster | 15 (maks) | 16 (total) | | Instans hanya-baca (maks. yang diperbolehkan, dengan jumlah aktual dari Wilayah sekunder) | 15 - s | s = jumlah total sekunder Wilayah AWS | Klaster memiliki persyaratan khusus berikut: + **Persyaratan kelas instance database** - Anda hanya dapat menggunakan kelas `db.r5` dan `db.r6g` instance. + **Wilayah AWS persyaratan** — Cluster primer harus berada dalam satu Wilayah, dan setidaknya satu cluster sekunder harus berada di Wilayah yang berbeda dari akun yang sama. Anda dapat membuat hingga lima cluster sekunder (hanya-baca), dan masing-masing harus berada di Wilayah yang berbeda. Dengan kata lain, tidak ada dua cluster yang bisa berada di Wilayah yang sama. + **Persyaratan penamaan** — Nama yang Anda pilih untuk setiap cluster Anda harus unik, di semua Wilayah. Anda tidak dapat menggunakan nama yang sama untuk cluster yang berbeda meskipun mereka berada di Wilayah yang berbeda. ## Membuat klaster global Amazon DocumentDB Apakah Anda siap untuk membangun klaster global pertama Anda? Pada bagian ini kami akan menjelaskan cara membuat klaster global baru dengan cluster dan contoh database baru, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut. ### Menggunakan Konsol Manajemen AWS 1. Di Konsol Manajemen AWS, navigasikan ke **Amazon DocumentDB**. 1. Ketika Anda sampai ke konsol Amazon DocumentDB, pilih **Klaster**. ![\[Halaman Clusters di konsol Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png) 1. Pilih **Buat**. ![\[Tombol Create ditampilkan di sudut kanan atas tabel Clusters.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png) 1. Mengisi bagian **Konfigurasi** dari formulir **Buat Klaster Amazon DocumentDB** dengan sesuai: + **Pengidentifikasi klaster**: Anda dapat memasukkan pengidentifikasi unik untuk instans ini atau mengizinkan Amazon DocumentDB menyediakan pengidentifikasi instans berdasarkan pengidentifikasi klaster. + Versi mesin: Pilih **4.0.0** + Kelas instans: Pilih **db.r5.large** + Jumlah instans: Pilih **3**. ![\[Formulir opsi konfigurasi untuk membuat cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png) 1. Di **Autentikasi**, isi nama pengguna utama dan kata sandi utama. ![\[Formulir otentikasi untuk menentukan nama pengguna dan kata sandi utama untuk cluster Amazon DocumentDB baru.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png) 1. Pilih **Tampilkan pengaturan lanjutan**. ![\[Tampilkan tombol sakelar pengaturan lanjutan di samping tombol Batalkan dan Buat klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png) 1. Di bagian **Pengaturan jaringan**: + **Simpan opsi default untuk grup **Virtual Private Cloud (VPC)** dan Subnet.** ![\[Formulir pengaturan jaringan yang menampilkan opsi grup keamanan VPC, subnet group, dan VPC. Bidang grup VPC dan Subnet memiliki opsi default yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png) + Untuk **grup keamanan VPC**, **default (VPC)** seharusnya sudah ditambahkan. ![\[Formulir pengaturan jaringan yang menunjukkan VPC default sudah ditambahkan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png) + Ketik `DocDB` ke dalam bidang **grup keamanan VPC** dan pilih **DocDB-inbound** (VFC). ![\[DocDB-Inbound VFC dipilih dalam menu dropdown grup keamanan VPC.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png) 1. Untuk **opsi Cluster** dan **E ncryption-at-rest**, biarkan pada pilihan default. ![\[Opsi cluster dan Encryption-at-rest formulir dengan opsi default dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png) 1. Untuk **ekspor **Backup** dan Log**, biarkan pada pilihan default. ![\[Formulir ekspor Backup dan Log dengan opsi default yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png) 1. Untuk **perlindungan **Pemeliharaan**, **Tag**, dan Penghapusan**, tinggalkan pilihan default. ![\[Formulir perlindungan Pemeliharaan, Tag, dan Penghapusan dengan opsi default yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png) 1. Sekarang klik tombol yang mengatakan **Create cluster**. ![\[Tombol Create cluster ditampilkan di akhir proses pembuatan cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png) ### Menggunakan AWS CLI Untuk membuat cluster Regional Amazon DocumentDB, hubungi file. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) AWS CLI Perintah berikut membuat cluster Amazon DocumentDB bernama. `global-cluster-id` Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). Juga, `--engine-version` adalah parameter opsional yang default ke versi mesin utama terbaru. Versi mesin default saat ini adalah `5.0.0` (catatan: Amazon DocumentDB 8.0 tersedia tetapi harus ditentukan secara eksplisit sebagai). `8.0.0` Ketika versi mesin utama baru dirilis, versi mesin default untuk `--engine-version` akan diperbarui untuk mencerminkan versi mesin utama terakhir. Akibatnya, untuk beban kerja produksi, dan terutama yang bergantung pada skrip, otomatisasi, atau CloudFormation templat, kami menyarankan Anda secara eksplisit menentukan `--engine-version` ke versi utama yang dimaksud. Jika `vpc-security-group-id` ditentukan `db-subnet-group-name` atau tidak, Amazon DocumentDB akan menggunakan grup subnet default dan grup keamanan Amazon VPC untuk Wilayah tertentu. Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri. Untuk Linux, macOS, atau Unix: ``` aws docdb create-db-cluster \ --global-cluster-identifier global-cluster-id \ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id ``` Untuk Windows: ``` aws docdb create-db-cluster ^ --global-cluster-identifier global-cluster-id ^ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBCluster": { "StorageEncrypted": false, "DBClusterMembers": [], "Engine": "docdb", "DeletionProtection" : "enabled", "ClusterCreateTime": "2018-11-26T17:15:19.885Z", "DBSubnetGroup": "default", "EngineVersion": "4.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id", "DBClusterIdentifier": "cluster-id", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb4.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com", "AssociatedRoles": [], "HostedZoneId": "ZNKXTT8WH85VW", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1e" ], "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com" } } ``` Dibutuhkan beberapa menit untuk membuat klaster. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk memantau status cluster Anda. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md). **penting** Saat Anda menggunakan AWS CLI untuk membuat klaster Regional Amazon DocumentDB, tidak ada instance yang dibuat. Akibatnya, Anda harus secara eksplisit membuat instans primer dan semua instans replika yang Anda butuhkan. Anda dapat menggunakan konsol atau AWS CLI untuk membuat instance. Untuk informasi selengkapnya, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) dan [CreateDBCluster](API_CreateDBCluster.md) di Referensi API Amazon DocumentDB. Setelah kluster Regional Anda tersedia, Anda dapat menambahkan klaster sekunder di Wilayah lain dengan petunjuk berikut: [Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB](#global-clusters.add-region) Saat Anda menambahkan Region, kluster Regional Anda menjadi klaster utama Anda, dan Anda memiliki klaster sekunder baru di Wilayah yang Anda pilih. ## Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB Sebuah cluster global membutuhkan setidaknya satu cluster sekunder di Region yang berbeda dari cluster primer, dan Anda dapat menambahkan hingga lima cluster sekunder. Perhatikan bahwa untuk setiap klaster sekunder yang Anda tambahkan, Anda harus mengurangi jumlah replika yang diizinkan di klaster primer sebanyak satu. Misalnya, jika klaster global Anda memiliki lima Wilayah sekunder, klaster utama Anda hanya dapat memiliki 10 (bukan 15) replika. Untuk informasi selengkapnya, lihat [Persyaratan konfigurasi klaster global Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config). ### Menggunakan Konsol Manajemen AWS 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon DocumentDB. 1. Pada panel navigasi, silakan pilih **Klaster**. ![\[Halaman Clusters di konsol Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png) 1. Pilih klaster yang ingin Anda tambahkan klaster sekundernya. Pastikan bahwa klaster adalah `Available`. ![\[Daftar cluster regional dan global yang menunjukkan status yang tersedia, dengan mydocdbglobalcluster disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png) 1. Pilih daftar dropdown untuk **Actions** dan kemudian pilih **Add** Region. ![\[Dropdown Tindakan pada antarmuka Clusters menunjukkan opsi Tambah Wilayah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png) 1. Pada Wilayah AWS halaman **Add an**, pilih Region sekunder. Perhatikan bahwa Anda tidak dapat memilih Region yang sudah memiliki klaster sekunder untuk cluster global yang sama. Juga, itu tidak bisa menjadi Wilayah yang sama dengan cluster utama. Jika ini adalah Wilayah pertama yang Anda tambahkan, Anda juga harus menentukan pengidentifikasi cluster global pilihan Anda. ![\[Pilih wilayah sekunder menggunakan menu tarik-turun pada Tambahkan formulir. Wilayah AWS\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png) 1. Lengkapi bidang yang tersisa untuk cluster sekunder di Wilayah baru, lalu pilih **Buat cluster**. Setelah Anda selesai menambahkan Wilayah, Anda dapat melihatnya di daftar **Cluster** di Konsol Manajemen AWS. ![\[Langkah terakhir untuk menambahkan wilayah ke klaster, menampilkan formulir Konfigurasi, perkiraan biaya per jam, dan tombol Buat klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png) ### Menggunakan AWS CLI + Gunakan perintah CLI `create-db-cluster` dengan nama `(--global-cluster-identifier)` dari klaster global Anda. Untuk Parameter lainnya, lakukan hal berikut: + Untuk`--region`, pilih yang berbeda Wilayah AWS dari Wilayah utama Anda. + Pilih nilai spesifik untuk parameter `--engine` dan `--engine-version`. + Untuk klaster terenkripsi, tentukan primer Anda Wilayah AWS sebagai enkripsi `--source-region` untuk. Contoh berikut membuat klaster Amazon DocumentDB baru dan melampirkannya ke klaster global sebagai klaster sekunder baca-saja. Pada langkah terakhir, instans ditambahkan ke klaster baru. Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri. Untuk Linux, macOS, atau Unix: ``` aws docdb --region secondary-region-id \ create-db-cluster \ --db-cluster-identifier cluster-id \ --global-cluster-identifier global-cluster-id \ --engine-version version \ --engine docdb aws docdb --region secondary-region-id \ create-db-instance \ --db-cluster-identifier cluster-id \ --global-cluster-identifier global-cluster-id \ --engine-version version \ --engine docdb ``` Untuk Windows: ``` aws docdb --region secondary-region-id ^ create-db-cluster ^ --db-cluster-identifier cluster-id ^ --global-cluster-identifier global-cluster-id ^ --engine-version version ^ --engine docdb aws docdb --region secondary-region-id ^ create-db-instance ^ --db-cluster-identifier cluster-id ^ --global-cluster-identifier global-cluster-id ^ --engine-version version ^ --engine docdb ``` ## Menggunakan snapshot untuk klaster global Amazon DocumentDB Anda Anda dapat memulihkan snapshot klaster Amazon DocumentDB untuk digunakan sebagai titik awal klaster global Anda. Untuk melakukan ini, Anda harus memulihkan snapshot dan membuat klaster baru. Ini akan berfungsi sebagai klaster primer klaster global Anda. Anda kemudian dapat menambahkan Wilayah lain ke cluster yang dipulihkan, sehingga mengubahnya menjadi cluster global. # Mengelola klaster global Amazon DocumentDB Anda melakukan sebagian besar operasi manajemen pada klaster individu yang membentuk klaster global. Saat Anda memilih **Sumber daya terkait grup** pada halaman **Klaster** di konsol tersebut, Anda melihat klaster primer dan klaster sekunder dikelompokkan di bawah klaster global terkait. Tab **Konfigurasi** untuk klaster global menunjukkan Wilayah AWS tempat cluster berjalan, versi, dan pengidentifikasi klaster global. **Topics** + [Memodifikasi cluster global](#global-clusters.modify) + [Mengubah parameter](#global-clusters.modify-parameters) + [Menghapus cluster global](#global-clusters.remove) + [Menghapus cluster global](#global-clusters.delete) + [Cluster tanpa kepala](#global-clusters.headless) ## Memodifikasi klaster global Amazon DocumentDB Halaman **Cluster** dalam Konsol Manajemen AWS daftar semua cluster global Anda, menampilkan cluster primer dan cluster sekunder untuk masing-masing cluster. Klaster global memiliki penganturan konfigurasi sendiri. Secara khusus, ia memiliki wilayah yang terkait dengan cluster primer dan sekundernya. Saat Anda membuat perubahan pada klaster global, Anda memiliki kesempatan untuk membatalkan perubahan. Saat Anda memilih Lanjutkan, Anda mengonfirmasi perubahan. ## Memodifikasi parameter klaster global Amazon DocumentDB Anda dapat mengonfigurasi grup parameter klaster secara independen untuk setiap klaster dalam klaster global. Sebagian besar parameter berfungsi sama seperti untuk jenis klaster Amazon DocumentDB lainnya. Kami menyarankan Anda menjaga pengaturan yang konsisten di antara semua klaster dalam basis data global. Tindakan tersebut membantu mencegah perubahan perilaku yang tidak terduga jika Anda menaikkan klaster sekunder menjadi klaster primer. Misalnya, gunakan pengaturan zona waktu dan rangkaian karakter yang sama untuk mencegah perilaku yang tidak konsisten jika klaster yang berbeda mengambil alih peran sebagai klaster primer. ## Menghapus klaster dari klaster global Amazon DocumentDB Ada beberapa situasi ketika Anda mungkin ingin menghapus klaster dari klaster global Anda. Misalnya, Anda mungkin ingin menghapus klaster dari klaster global jika klaster primer menjadi terdegradasi atau terisolasi. Ini kemudian menjadi klaster yang disediakan mandiri yang dapat digunakan untuk membuat klaster global baru. Untuk mempelajari selengkapnya, lihat [Melakukan failover manual untuk klaster global Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover). Anda juga mungkin ingin menghapus klaster karena Anda ingin menghapus klaster global yang tidak lagi Anda perlukan. Anda tidak dapat menghapus klaster global sampai setelah Anda melepaskan semua kluster terkait, meninggalkan yang primer untuk terakhir. Untuk informasi selengkapnya, lihat [Menghapus klaster dari klaster global Amazon DocumentDB](#global-clusters.delete). **catatan** Ketika sebuah cluster terlepas dari cluster global, itu tidak lagi disinkronkan dengan yang utama. Ini menjadi cluster yang disediakan mandiri dengan kemampuan penuh. read/write Selain itu, tidak lagi terlihat di konsol Amazon DocumentDB. Itu hanya terlihat ketika Anda memilih wilayah di konsol tempat cluster berada. Anda dapat menghapus cluster dari cluster global Anda menggunakan Konsol Manajemen AWS, the AWS CLI, atau RDS API. ------ #### [ Using the Konsol Manajemen AWS ] 1. Masuk ke Konsol Manajemen AWS dan navigasikan ke konsol Amazon DocumentDB. 1. Pilih **Klaster** di navigasi sisi kiri. ![\[Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png) 1. Perluas klaster global sehingga Anda dapat melihat semua klaster sekunder. Pilih klaster sekunder yang ingin Anda hapus. Pilih **Tindakan**, dan di menu yang turun, pilih **Hapus dari Global**. ![\[Gambar: kotak navigasi Cluster yang menunjukkan pemilihan cluster sekunder yang ada dan menyoroti tindakan “Hapus dari global”.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/remove-global.png) 1. Prompt akan muncul, meminta Anda untuk mengonfirmasi bahwa Anda ingin melepaskan sekunder dari klaster global. Pilih **Hapus dan promosikan** untuk menghapus klaster dari klaster global. ![\[Gambar: prompt Hapus dan promosikan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/remove-promote.png) Sekarang klaster itu tidak lagi berfungsi sebagai sekunder dan tidak lagi disinkronkan dengan klaster primer. Ini adalah cluster mandiri dengan read/write kemampuan penuh. Setelah Anda menghapus atau menghapus semua klaster sekunder, maka Anda dapat menghapus klaster primer dengan cara yang sama. Anda tidak dapat melepaskan atau menghapus klaster primer dari klaster global sampai setelah Anda menghapus semua klaster sekunder. Cluster global mungkin tetap berada dalam daftar Cluster, dengan nol wilayah dan AZs. Anda dapat menghapus jika tidak ingin lagi menggunakan klaster global ini. ------ #### [ Using the AWS CLI ] Untuk menghapus klaster dari klaster global, jalankan perintah `remove-from-global-cluster` CLI dengan parameter berikut: + `--global-cluster-identifier` — Nama (pengenal) klaster global Anda. + `--db-cluster-identifier` — Nama setiap klaster untuk menghapus dari klaster global. Contoh berikut pertama-tama menghapus klaster sekunder dan kemudian klaster primer dari klaster global. Untuk Linux, macOS, atau Unix: ``` aws docdb --region secondary_region \ remove-from-global-cluster \ --db-cluster-identifier secondary_cluster_ARN \ --global-cluster-identifier global_cluster_id aws docdb --region primary_region \ remove-from-global-cluster \ --db-cluster-identifier primary_cluster_ARN \ --global-cluster-identifier global_cluster_id ``` Ulangi perintah `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` untuk setiap wilayah sekunder di klaster global Anda. Untuk Windows: ``` aws docdb --region secondary_region ^ remove-from-global-cluster ^ --db-cluster-identifier secondary_cluster_ARN ^ --global-cluster-identifier global_cluster_id aws docdb --region primary_region ^ remove-from-global-cluster ^ --db-cluster-identifier primary_cluster_ARN ^ --global-cluster-identifier global_cluster_id ``` Ulangi perintah `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` untuk setiap wilayah sekunder di klaster global Anda. ------ ## Menghapus klaster dari klaster global Amazon DocumentDB Untuk menghapus cluster global, lakukan hal berikut: + Hapus semua klaster sekunder dari klaster global. Setiap klaster menjadi klaster yang berdiri sendiri. Lihat bagian sebelumnya,[Menghapus klaster dari klaster global Amazon DocumentDB](#global-clusters.remove). + Dari setiap klaster mandiri, hapus semua replika. + Hapus klaster primer dari klaster global. Ini menjadi klaster yang berdiri sendiri. + Dari klaster primer, hapus semua replika terlebih dahulu, lalu hapus instans primer. Menghapus instans primer dari klaster mandiri yang baru juga biasanya menghapus klaster dan klaster global. ------ #### [ Using the Konsol Manajemen AWS ] 1. Masuk ke Konsol Manajemen AWS dan navigasikan ke konsol Amazon DocumentDB. 1. Pilih **Klaster** dan temukan klaster global yang ingin Anda hapus. ![\[Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png) 1. Dengan klaster global Anda dipilih, pilih **Hapus** dari menu **Tindakan**. ![\[Gambar: kotak navigasi Cluster yang menunjukkan pemilihan cluster global dan menyoroti tindakan “Hapus”.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png) Konfirmasikan bahwa semua klaster dihapus dari klaster global. Cluster global harus menunjukkan wilayah nol AZs dan dan ukuran cluster nol. Jika klaster global berisi klaster apa pun, Anda belum dapat menghapusnya. Pertama-tama Anda harus mengikuti instruksi pada langkah sebelumnya **[Menghapus klaster dari klaster global Amazon DocumentDB](#global-clusters.remove)**. ------ #### [ Using the AWS CLI ] Untuk menghapus cluster global, jalankan perintah `delete-global-cluster` CLI dengan nama Wilayah AWS dan pengidentifikasi cluster global, seperti yang ditunjukkan pada contoh berikut. Untuk Linux, macOS, atau Unix: ``` aws docdb --region primary_region delete-global-cluster \ --global-cluster-identifier global_cluster_id ``` Untuk Windows: ``` aws docdb --region primary_region delete-global-cluster ^ --global-cluster-identifier global_cluster_id ``` ------ ## Membuat klaster Amazon DocumentDB tanpa kepala di wilayah sekunder Meskipun klaster global Amazon DocumentDB memerlukan setidaknya satu klaster sekunder yang Wilayah AWS berbeda dari yang utama, Anda dapat menggunakan konfigurasi tanpa kepala untuk klaster sekunder. Cluster Amazon DocumentDB sekunder tanpa kepala adalah cluster tanpa instance. Jenis konfigurasi ini dapat menurunkan biaya untuk cluster global. Dalam cluster Amazon DocumentDB, komputasi dan penyimpanan dipisahkan. Tanpa instance, Anda tidak dikenakan biaya untuk komputasi, hanya untuk penyimpanan. Jika diatur dengan benar, volume penyimpanan sekunder tanpa kepala tetap sinkron dengan cluster utama. Anda menambahkan klaster sekunder seperti biasa saat membuat klaster global Amazon DocumentDB. Namun, setelah cluster primer memulai replikasi ke sekunder, Anda menghapus instance hanya-baca dari cluster sekunder. Cluster sekunder ini sekarang dianggap “tanpa kepala” karena tidak lagi memiliki Instance. Namun, volume penyimpanan tetap sinkron dengan cluster Amazon DocumentDB utama. **penting** Kami hanya merekomendasikan klaster tanpa kepala untuk pelanggan yang dapat mentolerir kegagalan di seluruh wilayah selama 15\$1 menit. Ini karena pemulihan dari kegagalan di seluruh wilayah dengan cluster sekunder tanpa kepala akan mengharuskan pengguna untuk membuat instance baru setelah gagal. Sebuah instance baru dapat memakan waktu \$1 10-15 menit untuk tersedia. ### Cara Menambahkan Cluster Sekunder Tanpa Kepala ke Cluster Global Anda 1. Masuk ke Konsol Manajemen AWS dan buka konsol [Amazon DocumentDB](https://console.aws.amazon.com/rds/). 1. Pilih **Klaster** di navigasi sisi kiri. 1. Pilih cluster global yang membutuhkan cluster sekunder. Pastikan bahwa cluster utama adalah`Available`. 1. Untuk **Tindakan**, pilih **Tambahkan region**. 1. Pada halaman **Tambah wilayah**, pilih wilayah sekunder. **catatan** Anda tidak dapat memilih wilayah yang sudah memiliki cluster sekunder untuk cluster global yang sama. Selain itu, wilayah tersebut tidak boleh sama dengan klaster primer. 1. Lengkapi bidang yang tersisa untuk cluster sekunder di wilayah baru. Ini adalah opsi konfigurasi yang sama seperti untuk instance cluster apa pun. 1. Tambahkan wilayah. Setelah Anda selesai menambahkan wilayah ke cluster global Anda, Anda akan melihatnya dalam daftar `Clusters` di Konsol Manajemen AWS. 1. Periksa status cluster sekunder dan instance pembacanya sebelum melanjutkan, dengan menggunakan Konsol Manajemen AWS atau AWS CLI. Berikut adalah contoh perintah jika Anda menggunakan AWS CLI: ``` $ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text ``` Diperlukan beberapa menit agar status cluster sekunder yang baru ditambahkan berubah dari pembuatan menjadi tersedia. Ketika cluster tersedia, Anda dapat menghapus instance pembaca. 1. Pilih instance pembaca di cluster sekunder, lalu pilih **Hapus**. 1. Setelah menghapus instance pembaca, cluster sekunder tetap menjadi bagian dari cluster global. Seharusnya tidak ada contoh yang terkait dengannya. **catatan** Anda dapat menggunakan klaster Amazon DocumentDB sekunder tanpa kepala ini untuk memulihkan klaster global Amazon DocumentDB Anda secara manual dari pemadaman yang tidak direncanakan di wilayah utama jika terjadi pemadaman seperti itu. # Connect ke cluster global Amazon DocumentDB Cara Anda terhubung ke klaster global bergantung pada apakah Anda perlu menulis ke klaster atau membaca dari klaster: + Untuk permintaan atau kueri baca-saja, Anda menyambungkan ke reader endpoint untuk klaster di Wilayah AWS. + Untuk menjalankan pernyataan bahasa manipulasi data (DML) atau bahasa definisi data (DDL), Anda terhubung ke titik akhir klaster untuk klaster primer. Endpoint ini mungkin berbeda Wilayah AWS dari aplikasi Anda. Saat Anda melihat klaster global di konsol, Anda dapat melihat semua titik akhir tujuan umum yang terkait dengan semua klasternya. Bagaimana Anda terhubung ke klaster global bergantung pada apakah Anda perlu menulis ke basis data atau membaca dari basis data. Untuk DDL, DML, dan operasi baca yang ingin Anda layani dari wilayah primer, Anda harus terhubung ke klaster primer Anda. Kami menyarankan Anda menyambungkan ke klaster primer menggunakan titik akhir klaster dalam mode set replika, dengan preferensi baca `secondaryPreferred=true`. Ini akan merutekan lalu lintas tulis ke instans penulis klaster primer Anda dan lalu lintas baca ke instans replika klaster primer Anda. Untuk lintas wilayah, baca saja lalu lintas, Anda harus terhubung ke salah satu cluster sekunder Anda. Kami menyarankan Anda terhubung ke cluster sekunder Anda menggunakan titik akhir cluster dalam mode set replika. Karena semua instans adalah instans replika baca-saja, Anda tidak perlu menentukan preferensi baca. Untuk meminimalkan latensi, pilih reader endpoint mana saja yang ada di wilayah Anda atau wilayah terdekat dengan Anda. # Memantau klaster global Amazon DocumentDB Amazon DocumentDB (dengan kompatibilitas MongoDB) terintegrasi CloudWatch dengan sehingga Anda dapat mengumpulkan dan menganalisis metrik operasional untuk cluster Anda. Anda dapat memantau metrik ini menggunakan CloudWatch konsol, konsol Amazon DocumentDB, () AWS Command Line Interface ,AWS CLI atau API. CloudWatch Untuk memantau klaster global, gunakan CloudWatch metrik berikut. | Metrik | Deskripsi | | --- | --- | | GlobalClusterReplicatedWriteIO | Jumlah rata-rata I/O operasi penulisan yang ditagih direplikasi dari volume cluster di volume primer Wilayah AWS ke volume cluster di sekunder Wilayah AWS, dilaporkan pada interval 5 menit. Banyaknya ReplicatedWriteIOs yang direplikasi untuk setiap wilayah sekunder sama dengan jumlah VolumeWriteIOPs dalam wilayah yang dilakukan oleh wilayah primer. | | GlobalClusterDataTransferBytes | Jumlah data yang ditransfer dari cluster primer Wilayah AWS ke cluster sekunder Wilayah AWS, diukur dalam byte. | | GlobalClusterReplicationLag | Jumlah lag, dalam milidetik, saat mereplikasi peristiwa perubahan dari cluster primer Wilayah AWS ke cluster sekunder Wilayah AWS | Untuk informasi selengkapnya tentang cara melihat metrik ini, silakan lihat [Melihat CloudWatch data](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data). # Pemulihan bencana dan klaster global Amazon DocumentDB **Topics** + [Melakukan failover terkelola untuk klaster global Amazon DocumentDB](#managed-failover) + [Melakukan failover manual untuk klaster global Amazon DocumentDB](#manual-failover) + [Melakukan peralihan untuk klaster global Amazon DocumentDB](#global-cluster-switchover) + [Membuka blokir peralihan atau failover klaster global](#unblocking-gc-so-fo) Dengan menggunakan klaster global, Anda dapat pulih dari bencana seperti kegagalan wilayah dengan cepat. Pemulihan dari bencana biasanya diukur dengan menggunakan nilai untuk RTO dan RPO. + **Tujuan waktu pemulihan (RTO)** — Waktu yang dibutuhkan sistem untuk kembali ke kondisi kerja setelah bencana. Dengan kata lain, RTO mengukur waktu henti. Untuk cluster global, RTO dalam hitungan menit. + **Tujuan titik pemulihan (RPO)** — Jumlah data yang dapat hilang (diukur dalam waktu). Untuk klaster global, RPO biasanya diukur dalam hitungan detik. + Untuk memulihkan dari pemadaman yang tidak direncanakan, Anda dapat melakukan failover lintas wilayah ke salah satu sekunder di klaster global Anda. Jika klaster global Anda memiliki beberapa wilayah sekunder, pastikan Anda melepaskan semua wilayah sekunder yang ingin Anda promosikan sebagai primer. Kemudian, Anda mempromosikan salah satu wilayah sekunder tersebut menjadi Wilayah AWS primer yang baru. Terakhir, Anda membuat klaster baru di setiap wilayah sekunder lainnya dan melampirkan klaster tersebut ke klaster global Anda. ## Melakukan failover terkelola untuk klaster global Amazon DocumentDB Pendekatan ini ditujukan untuk kelangsungan bisnis saat terjadi bencana alam Regional yang riil atau pemadaman tingkat layanan secara menyeluruh. Selama failover terkelola, klaster utama Anda gagal ke Region sekunder pilihan Anda sementara topologi replikasi klaster global Amazon DocumentDB yang ada dipertahankan. Klaster sekunder yang dipilih mempromosikan salah satu simpul hanya-bacanya ke status penulis penuh. Langkah ini memungkinkan klaster untuk mengambil peran sebagai klaster primer. Basis data Anda tidak akan tersedia untuk sementara saat klaster ini mengambil peran barunya. Data yang tidak direplikasi dari primer lama ke cluster sekunder yang dipilih mungkin hilang saat sekunder ini menjadi primer baru. Volume primer lama membuat upaya terbaik untuk mengambil snapshot sebelum menyinkronkan dengan primer baru sehingga data yang tidak direplikasi dipertahankan pada snapshot. **catatan** Anda hanya dapat melakukan failover klaster lintas wilayah terkelola di klaster global Amazon DocumentDB jika klaster primer dan semua klaster sekunder memiliki versi engine yang sama. Jika versi mesin Anda tidak kompatibel, Anda dapat melakukan failover secara manual dengan mengikuti langkah-langkah dalam [Melakukan failover manual untuk klaster global Amazon DocumentDB](#manual-failover). Jika versi mesin wilayah tidak cocok, failover akan diblokir. Silakan periksa peningkatan yang tertunda dan terapkan untuk memastikan semua versi mesin wilayah cocok dan failover cluster global tidak diblokir. Untuk informasi selengkapnya, lihat [Membuka blokir peralihan atau failover klaster global](#unblocking-gc-so-fo). Untuk meminimalkan kehilangan data, sebaiknya lakukan hal berikut sebelum menggunakan fitur ini: + Bawa aplikasi offline untuk mencegah penulisan dikirim ke cluster utama klaster global Amazon DocumentDB. + Periksa waktu jeda untuk semua cluster sekunder Amazon DocumentDB. Memilih Wilayah sekunder dengan keterlambatan replikasi minimum dapat meminimalkan kehilangan data dari Wilayah primer yang mengalami kegagalan. Periksa waktu jeda untuk semua cluster sekunder Amazon DocumentDB di cluster global dengan melihat metrik di `GlobalClusterReplicationLag` Amazon. CloudWatch Metrik ini menunjukkan seberapa jauh di belakang (dalam milidetik) replikasi ke cluster sekunder ke cluster utama. Untuk informasi selengkapnya tentang CloudWatch metrik untuk Amazon [Metrik Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list) DocumentDB, lihat. Selama failover terkelola, cluster sekunder yang dipilih dipromosikan ke peran barunya sebagai primer. Namun, itu tidak mewarisi berbagai opsi konfigurasi cluster utama. Ketidakcocokan dalam konfigurasi dapat menyebabkan masalah performa, inkompatibilitas beban kerja, dan perilaku anomali lainnya. Untuk menghindari masalah seperti itu, kami sarankan Anda menyelesaikan perbedaan antara kluster global Amazon DocumentDB Anda untuk hal-hal berikut: + **Konfigurasikan grup parameter klaster Amazon DocumentDB untuk primer baru, jika perlu — Anda dapat mengonfigurasi grup parameter klaster** Amazon DocumentDB secara independen untuk setiap cluster di cluster global Amazon DocumentDB Anda. Oleh karena itu, ketika Anda mempromosikan klaster sekunder untuk mengambil alih peran utama, grup parameter dari sekunder mungkin dikonfigurasi secara berbeda dari yang utama. Jika demikian, ubah grup parameter klaster sekunder yang dipromosikan agar sesuai dengan pengaturan klaster utama Anda. Untuk mempelajari caranya, lihat [Memodifikasi grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-modify.md). + **Konfigurasikan alat dan opsi pemantauan, seperti CloudWatch peristiwa dan alarm Amazon** — Konfigurasikan klaster yang dipromosikan dengan kemampuan logging, alarm, dan sebagainya yang sama sesuai kebutuhan untuk klaster global. Seperti grup parameter, konfigurasi untuk fitur ini tidak diwariskan dari klaster primer selama proses failover berlangsung. Beberapa CloudWatch metrik, seperti replikasi lag, hanya tersedia untuk Wilayah sekunder. Karena itu, failover akan mengubah cara Anda melihat metrik tersebut dan mengatur alarmnya, serta mengharuskan adanya perubahan pada dasbor yang ditentukan sebelumnya. Untuk informasi selengkapnya tentang klaster dan pemantauan Amazon DocumentDB, lihat. [Memantau Amazon DocumentDB](monitoring_docdb.md) Biasanya, cluster sekunder yang dipilih mengasumsikan peran utama dalam satu menit. Segera setelah simpul penulis Wilayah primer baru tersedia, Anda dapat menghubungkan aplikasi Anda ke simpul tersebut dan melanjutkan beban kerja Anda. Setelah Amazon DocumentDB mempromosikan cluster primer baru, secara otomatis membangun kembali semua klaster Region sekunder tambahan. Karena klaster global Amazon DocumentDB menggunakan replikasi asinkron, kelambatan replikasi di setiap Wilayah sekunder dapat bervariasi. Amazon DocumentDB membangun kembali Wilayah sekunder ini untuk memiliki data yang point-in-time sama persis dengan cluster Wilayah utama yang baru. Durasi penyelesaian tugas pembangunan ulang dapat memerlukan waktu beberapa menit hingga beberapa jam, bergantung pada ukuran volume penyimpanan dan jarak di antara Wilayah. Saat klaster Wilayah sekunder selesai dibuat ulang dari Wilayah primer yang baru, klaster ini menjadi tersedia untuk akses baca. Segera setelah penulis utama baru dipromosikan dan tersedia, cluster Region primer yang baru dapat menangani operasi baca dan tulis untuk cluster global Amazon DocumentDB. Untuk mengembalikan topologi asli cluster global, Amazon DocumentDB memantau ketersediaan Wilayah primer lama. Segera setelah Wilayah itu sehat dan tersedia kembali, Amazon DocumentDB secara otomatis menambahkannya kembali ke cluster global sebagai Wilayah sekunder. Sebelum membuat volume penyimpanan baru di Wilayah primer lama, Amazon DocumentDB mencoba mengambil snapshot dari volume penyimpanan lama pada titik kegagalan. Hal ini dilakukan agar Anda dapat menggunakannya untuk memulihkan setiap data yang hilang. Jika operasi ini berhasil, Amazon DocumentDB menempatkan snapshot ini bernama “rdsdocdb-unplanned-global-failover: name-of-old-primary - -DB-Cluster-Timestamp” di bagian snapshot. Konsol Manajemen AWS Anda juga dapat melihat snapshot ini tercantum dalam informasi yang dikembalikan oleh operasi `DescribeDBClusterSnapshots` API. **catatan** Snapshot dari volume penyimpanan lama adalah snapshot sistem yang tunduk pada periode retensi pencadangan yang dikonfigurasi pada klaster primer yang lama. Untuk mempertahankan snapshot ini di luar periode retensi, Anda dapat menyalin snapshot untuk disimpan sebagai snapshot manual. Untuk mempelajari selengkapnya tentang cara menyalin snapshot, termasuk harga, lihat [Menyalin snapshot cluster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot). Setelah topologi asli dipulihkan, Anda dapat gagal mengembalikan klaster global Anda ke Wilayah utama asli dengan melakukan operasi peralihan ketika itu paling masuk akal untuk bisnis dan beban kerja Anda. Untuk melakukannya, ikuti langkah yang ada di [Melakukan peralihan untuk klaster global Amazon DocumentDB](#global-cluster-switchover). Anda dapat gagal melalui kluster global Amazon DocumentDB menggunakan Konsol Manajemen AWS API Amazon DocumentDB, AWS CLI atau Amazon DocumentDB. ------ #### [ Using the Konsol Manajemen AWS ] **Lakukan failover terkelola di klaster global Amazon DocumentDB** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Temukan dan pilih klaster global Amazon DocumentDB yang ingin Anda gagal. ![\[Gambar: Tabel cluster dengan cluster global dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/failover-cluster-table.png) 1. **Pilih **Switchover atau Failover** dari menu Tindakan.** 1. Pada kotak dialog yang muncul, pilih **Failover**, lalu pilih cluster sekunder dari Daftar drop-down bidang **cluster primer baru**. ![\[Gambar: Kotak dialog switchover atau failover cluster global.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/switch-fail-confirm.png) 1. Ketik “konfirmasi” di bidang terakhir. Kemudian pilih **Konfirmasi**. Status klaster utama berubah menjadi "**Failing-over**”. Kondisi ini akan memakan waktu sekitar satu menit. Selama waktu ini, status cluster primer baru menunjukkan "**Memodifikasi**... “. Setelah primer baru dipromosikan, itu akan menampilkan "**Tersedia**" dan akan dapat melayani transaksi baca dan tulis. Wilayah sekunder termasuk primer lama akan menampilkan "**Menyinkronkan ulang**... “sementara itu menyinkronkan ulang ke primer baru. Mirip dengan primer baru, itu hanya akan dapat melayani transaksi setelah status berubah menjadi "**Tersedia**”. 1. Ketika selesai, cluster primer asli menjadi cluster sekunder. Cluster sekunder yang dipilih menjadi cluster utama. ![\[Gambar: Tabel cluster menunjukkan cluster primer baru.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/failover-complete.png) ------ #### [ Using the AWS CLI ] **Lakukan failover terkelola di klaster global Amazon DocumentDB** Jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html)CLI agar gagal melalui cluster global Amazon DocumentDB Anda. Dengan perintah, berikan nilai untuk opsi berikut: + `--region` + `--global-cluster-identifier` + `--target-db-cluster-identifier` + `--allow-data-loss` Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda. Untuk Linux, macOS, atau Unix: ``` aws docdb failover-global-cluster \ --region region_of_selected_secondary \ --global-cluster-identifier global_cluster_id \ --target-db-cluster-identifier arn_of_secondary_to_promote \ --allow-data-loss ``` Untuk Windows: ``` aws docdb failover-global-cluster ^ --region region_of_selected_secondary ^ --global-cluster-identifier global_cluster_id ^ --target-db-cluster-identifier arn_of_secondary_to_promote ^ --allow-data-loss ``` ------ ## Melakukan failover manual untuk klaster global Amazon DocumentDB Jika seluruh cluster dalam satu Wilayah AWS menjadi tidak tersedia, Anda dapat mempromosikan klaster lain di cluster global untuk memiliki read/write kemampuan. Anda dapat mengaktifkan mekanisme failover cluster global secara manual jika cluster di cluster yang berbeda Wilayah AWS adalah pilihan yang lebih baik untuk menjadi cluster utama. Misalnya, Anda dapat meningkatkan kapasitas salah satu klaster sekunder dan kemudian mempromosikannya menjadi klaster primer. Atau keseimbangan aktivitas di antara Wilayah AWS mungkin berubah, sehingga mengalihkan cluster utama ke cluster lain Wilayah AWS mungkin memberikan latensi yang lebih rendah untuk operasi penulisan. Prosedur berikut menguraikan apa yang harus dilakukan untuk mempromosikan salah satu cluster sekunder di cluster global Amazon DocumentDB. Untuk mempromosikan cluster sekunder: 1. Berhenti mengeluarkan pernyataan DHTML dan operasi penulisan lainnya ke cluster utama di Wilayah AWS with the outage. 1. Identifikasi cluster dari sekunder Wilayah AWS untuk digunakan sebagai cluster primer baru. Jika Anda memiliki dua (atau lebih) sekunder Wilayah AWS di cluster global Anda, pilih cluster sekunder yang memiliki waktu jeda paling sedikit. 1. Lepaskan klaster sekunder yang Anda pilih dari klaster global. Menghapus cluster sekunder dari cluster global segera menghentikan replikasi dari primer ke sekunder ini dan mempromosikannya ke cluster yang disediakan mandiri dengan kemampuan penuh. read/write Klaster sekunder lainnya yang terkait dengan klaster primer di wilayah dengan pemadaman masih tersedia dan dapat menerima panggilan dari aplikasi Anda. Klaster tersebut juga mengonsumsi sumber daya. Karena Anda membuat ulang klaster global, untuk menghindari otak-terbelah dan masalah lainnya, hapus klaster sekunder lainnya sebelum membuat klaster global baru dalam langkah-langkah berikut. Untuk langkah-langkah rinci untuk melepaskan, lihat [Menghapus klaster dari klaster global Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove). 1. Klaster ini menjadi klaster primer dari klaster global baru saat Anda mulai menambahkan Wilayah ke dalamnya, pada langkah berikutnya. 1. Tambahkan Wilayah AWS ke cluster. Saat Anda melakukannya, proses replikasi dari klaster primer ke klaster sekunder akan dimulai. 1. Tambahkan lebih banyak Wilayah AWS sesuai kebutuhan untuk membuat ulang topologi yang diperlukan untuk mendukung aplikasi Anda. Pastikan bahwa penulisan aplikasi dikirim ke klaster yang benar sebelum, selama, dan setelah membuat perubahan seperti ini, untuk menghindari inkonsistensi data di antara klaster dalam klaster global (masalah split-brain). 1. Saat pemadaman teratasi dan Anda siap menugaskan Wilayah AWS asli sebagai klaster primer lagi, lakukan langkah yang sama secara terbalik. 1. Hapus salah satu klaster sekunder dari klaster global. Ini akan memungkinkannya untuk melayani read/write lalu lintas. 1. Alihkan ulang semua lalu lintas tulis ke klaster primer di Wilayah AWS asli. 1. Tambahkan Wilayah AWS untuk mengatur satu atau lebih cluster sekunder yang sama Wilayah AWS seperti sebelumnya. Cluster global Amazon DocumentDB dapat dikelola AWS SDKs menggunakan, memungkinkan Anda membuat solusi untuk mengotomatiskan proses failover klaster global untuk kasus penggunaan Disaster Recovery dan Business Continuity Planning. [Salah satu solusi tersebut tersedia untuk pelanggan kami di bawah lisensi Apache 2.0 dan dapat diakses dari repositori alat kami di sini.](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation) Solusi ini memanfaatkan Amazon Route 53 untuk manajemen titik akhir dan menyediakan AWS Lambda fungsi yang dapat dipicu berdasarkan peristiwa yang sesuai. ## Melakukan peralihan untuk klaster global Amazon DocumentDB Dengan menggunakan switchover, Anda dapat mengubah Wilayah cluster utama Anda secara rutin. Pendekatan ini ditujukan untuk skenario yang terkontrol, seperti pemeliharaan operasional dan prosedur operasional terencana lainnya. Ada tiga kasus penggunaan umum untuk menggunakan switchover: + Untuk persyaratan "rotasi regional" yang diberlakukan pada industri tertentu. Misalnya, peraturan layanan keuangan mungkin menginginkan sistem tier-0 untuk beralih ke Wilayah yang berbeda selama beberapa bulan untuk memastikan prosedur pemulihan bencana dilaksanakan secara teratur. + Untuk aplikasi Multi-region follow-the-sun "”. Misalnya, suatu bisnis mungkin ingin menyediakan penulisan dengan latensi lebih rendah di berbagai Wilayah berdasarkan jam kerja di zona waktu yang berbeda. + Sebagai zero-data-loss metode untuk gagal kembali ke Wilayah primer asli setelah failover. **catatan** Switchovers dirancang untuk digunakan pada cluster global Amazon DocumentDB yang sehat. Untuk pulih dari pemadaman yang tak terduga, ikuti prosedur yang sesuai di [Melakukan failover manual untuk klaster global Amazon DocumentDB](#manual-failover). Untuk melakukan switchover, semua wilayah sekunder harus menjalankan versi mesin yang sama persis dengan yang utama. Jika versi mesin wilayah tidak cocok, peralihan akan diblokir. Silakan periksa peningkatan yang tertunda dan terapkan untuk memastikan semua versi mesin wilayah cocok dan peralihan cluster global tidak diblokir. Untuk informasi selengkapnya, lihat [Membuka blokir peralihan atau failover klaster global](#unblocking-gc-so-fo). Selama peralihan, Amazon DocumentDB mengalihkan klaster utama Anda ke Wilayah sekunder pilihan Anda sambil mempertahankan topologi replikasi klaster global yang ada. Sebelum memulai proses peralihan, Amazon DocumentDB menunggu semua cluster Region sekunder disinkronkan sepenuhnya dengan kluster Region primer. Selanjutnya, klaster DB di Wilayah primer menjadi klaster hanya-baca, dan klaster sekunder yang dipilih akan mempromosikan salah satu simpul hanya-bacanya menjadi status penulis penuh. Mempromosikan simpul ini menjadi penulis memungkinkan klaster sekunder mengambil peran klaster primer. Karena semua cluster sekunder disinkronkan dengan primer pada awal proses, primer baru melanjutkan operasi untuk cluster global Amazon DocumentDB tanpa kehilangan data apa pun. Basis data Anda tidak tersedia untuk sementara selama klaster primer dan klaster sekunder yang dipilih mengambil peran barunya masing-masing. Untuk mengoptimalkan ketersediaan aplikasi, sebaiknya lakukan hal berikut sebelum menggunakan fitur ini: + Lakukan operasi ini selama jam nonpeak atau di lain waktu ketika menulis ke cluster primer minimal. + Bawa aplikasi offline untuk mencegah penulisan dikirim ke cluster utama klaster global Amazon DocumentDB. + Periksa waktu jeda untuk semua cluster sekunder Amazon DocumentDB di cluster global dengan melihat metrik di `GlobalClusterReplicationLag` Amazon. CloudWatch Metrik ini menunjukkan seberapa jauh di belakang (dalam milidetik) replikasi ke cluster sekunder ke cluster primer. Nilai ini berbanding lurus dengan waktu yang dibutuhkan Amazon DocumentDB untuk menyelesaikan peralihan. Karena itu, semakin besar nilai keterlambatan, semakin lama durasi switchover. Untuk informasi selengkapnya tentang CloudWatch metrik untuk Amazon [Metrik Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list) DocumentDB, lihat. Selama proses switchover, klaster DB sekunder yang dipilih akan dipromosikan ke peran barunya sebagai primer. Namun, klaster ini tidak mewarisi berbagai opsi konfigurasi klaster DB primer. Ketidakcocokan dalam konfigurasi dapat menyebabkan masalah performa, inkompatibilitas beban kerja, dan perilaku anomali lainnya. Untuk menghindari masalah seperti itu, kami sarankan Anda menyelesaikan perbedaan antara kluster global Amazon DocumentDB Anda untuk hal-hal berikut: + **Konfigurasikan grup parameter cluster Amazon DocumentDB DB untuk primer baru, jika perlu — Anda dapat mengonfigurasi grup parameter klaster** Amazon DocumentDB secara independen untuk setiap cluster di klaster global Amazon DocumentDB Anda. Hal ini berarti ketika Anda mempromosikan klaster DB sekunder untuk mengambil alih peran primer, grup parameter dari klaster sekunder mungkin memiliki konfigurasi yang berbeda dengan klaster primer. Jika demikian, ubah grup parameter klaster DB sekunder yang dipromosikan agar sesuai dengan pengaturan klaster primer Anda. Untuk mempelajari caranya, lihat [Mengelola grup parameter cluster Amazon DocumentDB](cluster_parameter_groups.md). + **Konfigurasikan alat dan opsi pemantauan, seperti Amazon CloudWatch Events dan alarm** — Konfigurasikan klaster yang dipromosikan dengan kemampuan logging, alarm, dan sebagainya yang sama sesuai kebutuhan untuk klaster global. Seperti grup parameter, konfigurasi untuk fitur ini tidak diwariskan dari klaster primer selama proses switchover berlangsung. Beberapa CloudWatch metrik, seperti replikasi lag, hanya tersedia untuk Wilayah primer. Karena itu, switchover akan mengubah cara Anda melihat metrik tersebut dan mengatur alarmnya, serta mengharuskan adanya perubahan pada dasbor yang ditentukan sebelumnya. Untuk informasi selengkapnya, lihat [Memantau Amazon DocumentDB](monitoring_docdb.md). **catatan** Biasanya, switchover peran dapat memerlukan waktu hingga beberapa menit. Saat proses peralihan selesai, klaster Amazon DocumentDB yang dipromosikan dapat menangani operasi penulisan untuk klaster global. Anda dapat beralih ke klaster global Amazon DocumentDB menggunakan Konsol Manajemen AWS atau: AWS CLI ------ #### [ Using the Konsol Manajemen AWS ] **Lakukan peralihan di klaster global Amazon DocumentDB Anda** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Temukan dan pilih klaster global Amazon DocumentDB yang ingin Anda alihkan. ![\[Gambar: Tabel cluster dengan cluster global dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/switchover-cluster-table.png) 1. **Pilih **Switchover atau Failover** dari menu Tindakan.** 1. Pada kotak dialog yang muncul, pilih **Switchover**, lalu pilih cluster sekunder dari Daftar drop-down bidang **cluster primer baru**. ![\[Gambar: Cluster beralih dialog dengan cluster sekunder dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/switch-fail-confirm-2.png) 1. Pilih **Konfirmasi**. Status klaster utama berubah menjadi "**Switching-over**”. Kondisi ini akan memakan waktu sekitar tiga menit. Selama waktu ini, status semua cluster regional menunjukkan "**Memodifikasi**... “. Setelah wilayah disinkronkan dan primer baru dipromosikan, itu akan menampilkan "**Tersedia**" untuk semua bidang status dan akan dapat melayani transaksi. 1. Ketika selesai, cluster primer asli menjadi cluster sekunder. Cluster sekunder yang dipilih menjadi cluster utama. ![\[Gambar: Tabel cluster menunjukkan cluster primer baru.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/failover-complete.png) ------ #### [ Using the AWS CLI ] **Lakukan peralihan di klaster global Amazon DocumentDB Anda** Jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html)CLI untuk beralih ke cluster global Amazon DocumentDB Anda. Dengan perintah, berikan nilai untuk opsi berikut: + `--region` + `--global-cluster-identifier` + `--target-db-cluster-identifier` Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda. Untuk Linux, macOS, atau Unix: ``` aws docdb switchover-global-cluster \ --region region_of_primary \ --global-cluster-identifier global_cluster_id \ --target-db-cluster-identifier arn_of_secondary_to_promote ``` Untuk Windows: ``` aws docdb switchover-global-cluster ^ --region region_of_primary ^ --global-cluster-identifier global_cluster_id ^ --target-db-cluster-identifier arn_of_secondary_to_promote ``` ------ ## Membuka blokir peralihan atau failover klaster global Switchover dan failover cluster global diblokir ketika tidak semua cluster regional di cluster global menggunakan versi mesin yang sama. Jika versi tidak cocok, Anda mungkin melihat kesalahan ini sebagai respons saat memanggil switchover atau failover: Cluster DB target yang ditentukan menjalankan versi engine dengan tingkat patch yang berbeda dari cluster DB sumber. Kami merekomendasikan secara rutin menerapkan versi mesin terbaru untuk memastikan Anda menjalankan pembaruan terbaru untuk menjaga klaster global Anda dalam keadaan sehat. Untuk mengatasi kesalahan ini, perbarui semua wilayah sekunder terlebih dahulu, lalu wilayah utama ke versi mesin yang sama dengan menerapkan item tindakan pemeliharaan yang tertunda. Untuk melihat item tindakan pemeliharaan yang tertunda, dan menerapkan perubahan yang diperlukan untuk memperbaiki masalah, lakukan instruksi di salah satu tab berikut: ------ #### [ Using the Konsol Manajemen AWS ] Untuk membuka blokir peralihan atau failover klaster global, Anda harus menentukan apakah ada tindakan pemeliharaan yang tertunda untuk cluster Anda dan menerapkannya. Ikuti langkah-langkah ini untuk melihat dan menerapkan tindakan pemeliharaan: 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Dalam tabel **Clusters**, temukan klaster global Anda di kolom **pengenal Cluster**. Di bawah klaster global Anda, catat setiap cluster sekunder dan klaster utama untuk klaster global yang diberikan, dan lakukan langkah-langkah berikut untuk masing-masing klaster. 1. Untuk setiap cluster sekunder: 1. Jika pembaruan tersedia untuk klaster Anda, itu ditunjukkan sebagai **Tersedia**, **Diperlukan**, atau **Jendela Berikutnya** di kolom **Pemeliharaan**. 1. Untuk mengambil tindakan, pilih cluster untuk menampilkan detailnya, lalu pilih **Maintenance & backup**. Item **Pemeliharaan Tertunda** muncul. 1. Di bawah **Deskripsi**, jika ini menunjukkan bahwa “Pembaruan pemeliharaan baru tersedia”, pilih dan kemudian pilih **Terapkan sekarang**. 1. Untuk klaster utama Anda: 1. Jika pembaruan tersedia untuk klaster Anda, itu ditunjukkan sebagai **Tersedia**, **Diperlukan**, atau **Jendela Berikutnya** di kolom **Pemeliharaan**. 1. Untuk mengambil tindakan, pilih cluster untuk menampilkan detailnya, lalu pilih **Maintenance & backup**. Item **Pemeliharaan Tertunda** muncul. 1. Di bawah **Deskripsi**, jika ini menunjukkan bahwa “Pembaruan pemeliharaan baru tersedia”, pilih dan kemudian pilih **Terapkan sekarang**. ------ #### [ Using the AWS CLI ] Untuk membuka blokir peralihan atau failover klaster global, Anda harus menentukan apakah ada tindakan pemeliharaan yang tertunda untuk klaster dan menerapkannya. Ikuti langkah-langkah berikut untuk melihat dan menerapkan tindakan pemeliharaan terlebih dahulu pada cluster sekunder kemudian pada klaster utama untuk klaster global Anda: 1. Jalankan yang berikut ini pada setiap cluster regional regional sekunder terlebih dahulu dan kemudian untuk klaster regional daerah primer. 1. Jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)CLI dengan `--resource-identifier` opsi untuk menentukan apakah ada tindakan pemeliharaan yang tersedia untuk klaster regional Amazon DocumentDB Anda. Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ``` Untuk Windows: ``` aws docdb describe-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ``` Hasilnya terlihat mirip dengan ini: ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2025-04-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2025-06-18T03:01:00Z", "AutoAppliedAfterDate": "2025-05-11T03:01:00Z" "OptInStatus": "pending" } ] } ] } ``` 1. Jika tindakan pemeliharaan diperlukan, jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)CLI dengan opsi berikut: + `--resource-identifier` + `--apply-action` + `--opt-in-type` + `--region` Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda. Untuk Linux, macOS, atau Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \ --apply-action system-update \ --opt-in-type immediate \ --region us-east-1 ``` Untuk Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^ --apply-action system-update ^ --opt-in-type immediate ^ --region us-east-1 ``` 1. Setelah tindakan pemeliharaan selesai, jalankan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)perintah lagi untuk memastikan bahwa tidak ada tindakan lain yang tertunda untuk cluster Anda. Hasil yang Anda inginkan adalah: ``` { "PendingMaintenanceActions": [] } ``` ------ #### [ Using the Amazon DocumentDB API ] Untuk membuka blokir peralihan atau failover klaster global, Anda harus menentukan apakah ada tindakan pemeliharaan yang tertunda untuk klaster dan menerapkannya. Gunakan yang berikut ini APIs untuk melihat dan menerapkan tindakan pemeliharaan: 1. Jalankan yang berikut ini pada setiap cluster regional regional sekunder terlebih dahulu dan kemudian untuk klaster regional daerah primer. 1. Panggil [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html)API untuk menentukan apakah ada tindakan pemeliharaan yang tersedia untuk klaster global Amazon DocumentDB Anda. 1. Terapkan perubahan apa pun dengan memanggil [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html)API. ------ # Mengelola cluster Amazon DocumentDB Untuk mengelola klaster Amazon DocumentDB, Anda harus memiliki kebijakan IAM dengan izin bidang kontrol Amazon DocumentDB yang sesuai. Izin ini memungkinkan Anda untuk membuat, memodifikasi, dan menghapus klaster dan instans. Kebijakan `AmazonDocDBFullAccess` menyediakan semua izin yang diperlukan untuk mengelola klaster Amazon DocumentDB. Topik berikut menunjukkan bagaimana caranya melakukan berbagai tugas ketika bekerja dengan klaster Amazon DocumentDB, termasuk menciptakan, menghapus, memodifikasi, menghubungkan ke, dan melihat klaster. **Topics** + [Memahami cluster](db-clusters-understanding.md) + [Pengaturan cluster](db-cluster-parameters.md) + [Konfigurasi penyimpanan cluster](db-cluster-storage-configs.md) + [Menentukan status klaster](db-cluster-status.md) + [Siklus hidup cluster](db-cluster-life-cycle.md) + [Menskalakan klaster](db-cluster-manage-performance.md) + [Mengkloning volume untuk cluster](db-cluster-cloning.md) + [Memahami toleransi kesalahan cluster](db-cluster-fault-tolerance.md) # Memahami cluster Amazon DocumentDB memisahkan perhitungan dan penyimpanan, dan replikasi data offload dan backup ke volume klaster. Volume klaster menyediakan lapisan penyimpanan tahan lama, andal, dan sangat tersedia yang mereplikasi data enam cara di tiga Zona Ketersediaan. Replika memungkinkan ketersediaan data yang lebih tinggi dan membaca penskalaan. Setiap klaster dapat diskalakan ke atas hingga 15 replika. | Kata benda | Deskripsi | Operasi API (Kata Kerja) | | --- | --- | --- | | Klaster | Terdiri atas satu atau beberapa instans dan volume penyimpanan klaster yang mengelola data untuk instans tersebut. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` | | Instans | Membaca dan menulis data ke volume penyimpanan klaster dilakukan melalui instans. Dalam sebuah klaster tertentu, ada dua jenis instans: primer dan replika. Sebuah klaster selalu memiliki satu instans utama dan dapat memiliki 0–15 replika. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` | | Volume klaster | Volume penyimpanan basis data virtual yang mencakup tiga Availability Zone, dengan setiap Availability Zone memiliki dua salinan data klaster. | N/A | | Instans utama | Mendukung operasi baca dan tulis, dan melakukan semua modifikasi data pada volume klaster. Setiap klaster memiliki satu instans utama. | N/A | | Instans replika | Mendukung hanya operasi baca. Setiap klaster Amazon DocumentDB dapat memiliki hingga 15 instans replika di samping instans utama. Beberapa replika mendistribusikan beban kerja baca. Dengan menemukan replika di Availability Zone terpisah, Anda juga dapat meningkatkan ketersediaan basis data. | N/A | | Titik akhir klaster | Titik akhir untuk klaster Amazon DocumentDB yang menghubungkan ke instans utama saat ini untuk klaster. Setiap klaster Amazon DocumentDB memiliki titik akhir klaster dan satu instans utama. | N/A | | Reader endpoint | Titik akhir untuk klaster Amazon DocumentDB yang terhubung ke salah satu replika yang tersedia untuk klaster tersebut. Setiap klaster Amazon DocumentDB memiliki reader endpoint. Jika ada lebih dari satu replika, reader endpoint mengarahkan setiap permintaan koneksi ke salah satu replika Amazon DocumentDB. | N/A | | Instans titik akhir | Titik akhir untuk instans dalam klaster Amazon DocumentDB yang terhubung ke instans tertentu. Setiap instans dalam sebuah klaster, apa pun jenis instansnya, memiliki titik akhir instans uniknya sendiri. | N/A | # Pengaturan Amazon DocumentDB Cluster Ketika Anda membuat atau memodifikasi klaster, penting untuk memahami parameter yang tetap dan yang dimodifikasi setelah klaster selesai dibuat. Tabel berikut mencantumkan semua pengaturan, atau parameter, yang khusus dibuat untuk klaster. Seperti yang ditentukan dalam tabel, beberapa dapat dimodifikasi, yang lain tidak. **catatan** Pengaturan ini jangan sampai tertukar dengan grup parameter klaster Amazon DocumentDB dan parameternya. Untuk informasi selengkapnya tentang grup parameter klaster, lihat [Mengelola grup parameter cluster Amazon DocumentDB](cluster_parameter_groups.md). | Parameter | Dapat diubah | Catatan | | --- | --- | --- | | DBClusterIdentifier | Ya | Aturan penamaan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) | | Engine | Tidak | Harus berupa docdb. | | BackupRetentionPeriod | Ya | Harus antara [1-35] hari. | | DBClusterParameterGroupName | Ya | Aturan penamaan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) | | DBSubnetGroupName | Tidak | Setelah klaster selesai dibuat, Anda tidak dapat mengubah subnet klaster. | | EngineVersion | Tidak | Nilai bisa 5.0.0 (default),4.0.0, atau3.6.0. | | KmsKeyId | Tidak | Jika Anda memilih untuk mengenkripsi klaster Anda, Anda tidak dapat mengubah AWS KMS kunci yang Anda gunakan untuk mengenkripsi klaster Anda. | | MasterUsername | Tidak | Setelah sebuah klaster telah dibuat, Anda tidak dapat mengubah `MasterUsername`. Aturan penamaan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) | | MasterUserPassword | Ya | Aturan: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-parameters.html) | | Port | Ya | Nomor port berlaku untuk semua instans dalam klaster. | | PreferredBackupWindow | Ya | | | PreferredMaintenanceWindow | Ya | | | StorageEncrypted | Tidak | Jika Anda memilih untuk mengenkripsi klaster Anda, klaster tersebut tidak dapat terenkripsi. | | StorageType | Ya | Jenis penyimpanan untuk cluster DB: Standard (`standard`) atau I/O-Optimized (`iopt1`). Default: `standard` Parameter ini dapat dikonfigurasi dengan `CreateDBCluster` dan`ModifyDBCluster`. Untuk informasi selengkapnya, lihat [Konfigurasi penyimpanan klaster Amazon DocumentDB](db-cluster-storage-configs.md). | | Tags | Ya | | | VpcSecurityGroupIds | Tidak | Setelah klaster telah dibuat, Anda tidak dapat mengubah VPC tempat klaster berada. | # Konfigurasi penyimpanan klaster Amazon DocumentDB Mulai dari Amazon DocumentDB 5.0, cluster berbasis instance mendukung dua jenis konfigurasi penyimpanan: + Penyimpanan **standar Amazon DocumentDB**: Dirancang untuk pelanggan dengan konsumsi rendah hingga sedang. I/O Jika Anda mengharapkan I/O biaya Anda kurang dari 25% dari total cluster Amazon DocumentDB Anda, pilihan ini mungkin ideal untuk Anda. Dengan konfigurasi penyimpanan standar Amazon DocumentDB, Anda akan ditagih berdasarkan biaya pay-per-request I/O instans dan penyimpanan. Ini berarti tagihan Anda mungkin bervariasi dari satu siklus ke siklus lainnya berdasarkan penggunaan. Konfigurasi disesuaikan untuk mengakomodasi I/O permintaan aplikasi Anda yang berfluktuasi. + **Amazon DocumentDB I/O penyimpanan yang dioptimalkan**: Dirancang untuk pelanggan yang memprioritaskan prediktabilitas harga atau memiliki aplikasi intensif. I/O I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/OOperasi, memastikan biaya yang dapat diprediksi setiap siklus penagihan. Konfigurasi menstabilkan biaya sekaligus meningkatkan kinerja. Anda dapat mengalihkan kluster database yang ada setiap 30 hari sekali ke I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O Amazon DocumentDB -dioptimalkan dapat dilacak `describe-db-clusters` dengan perintah AWS CLI menggunakan atau Konsol Manajemen AWS melalui di halaman konfigurasi cluster. [Anda dapat membuat kluster database baru termasuk konfigurasi Amazon DocumentDB I/O yang dioptimalkan atau mengonversi kluster database yang ada dengan beberapa klik di, perubahan parameter tunggal [Konsol Manajemen AWS](https://console.aws.amazon.com/docdb/)di (), atau melalui.AWS Command Line InterfaceAWS CLI[AWS SDKs](https://aws.amazon.com/developer/tools/)](https://aws.amazon.com/cli/) Tidak ada downtime atau reboot instance yang diperlukan selama atau setelah memodifikasi konfigurasi penyimpanan. ![\[Gambar: Tabel yang menjelaskan perbedaan antara standar Amazon DocumentDB dan penyimpanan yang dioptimalkan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/io-diagram-1.png) ## Membuat cluster yang dioptimalkan I/O ------ #### [ Using the Konsol Manajemen AWS ] Untuk membuat atau memodifikasi cluster yang dioptimalkan I/O menggunakan: Konsol Manajemen AWS 1. **Di konsol manajemen Amazon DocumentDB, **di bawah** Clusters, pilih Create **atau** pilih cluster dan pilih Actions, lalu pilih **Modify**.** 1. Jika Anda membuat klaster baru, pastikan Anda memilih **Instance Based Cluster** **di bagian tipe Cluster** (ini adalah opsi default). ![\[Gambar: Tangkapan layar konsol dari opsi tipe cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-cluster/cc-type.png) 1. Di bagian **Konfigurasi**, di bawah **konfigurasi penyimpanan Cluster**, pilih **Amazon DocumentDB** I/O-Optimized. ![\[Gambar: Tangkapan layar konsol dari opsi konfigurasi penyimpanan cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/storage-config-1.png) 1. Selesaikan pembuatan atau modifikasi cluster Anda dan pilih **Create cluster** atau **Modify cluster**. Untuk proses Create cluster yang lengkap, lihat[Membuat cluster dan instance primer menggunakan Konsol Manajemen AWS](db-cluster-create.md#db-cluster-create-con). Untuk proses klaster Modify yang lengkap, lihat[Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). ------ #### [ Using the AWS CLI ] Untuk membuat cluster yang dioptimalkan I/O menggunakan: AWS CLI Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri. Untuk Linux, macOS, atau Unix: ``` aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 5.0.0 \ --storage-type iopt1 \ --deletion-protection \ --master-username username \ --master-user-password password ``` Untuk Windows: ``` aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 5.0.0 ^ --storage-type iopt1 ^ --deletion-protection ^ --master-username username ^ --master-user-password password ``` ------ ## Analisis biaya untuk menentukan konfigurasi penyimpanan Dengan Amazon DocumentDB, Anda memiliki fleksibilitas untuk memilih konfigurasi penyimpanan untuk setiap cluster database yang Anda miliki. Untuk mengalokasikan cluster Anda dengan benar antara standar dan I/O yang dioptimalkan, Anda dapat melacak biaya Amazon DocumentDB Anda berdasarkan klaster. Untuk melakukannya, Anda dapat menambahkan tag ke cluster yang ada, mengaktifkan penandaan alokasi biaya di [AWS Manajemen Penagihan dan Biaya dasbor](https://aws.amazon.com/pricing/) Anda, dan menganalisis biaya Anda untuk klaster tertentu di. [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/) Untuk informasi tentang analisis biaya, lihat blog kami [Menggunakan tag alokasi biaya](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/). # Menentukan status klaster Anda dapat menentukan status cluster menggunakan Konsol Manajemen AWS atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] Gunakan prosedur berikut untuk melihat status klaster Amazon DocumentDB Anda menggunakan Konsol Manajemen AWS 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Klaster**. 1. Dalam kolom **Pengidentifikasi klaster**, temukan nama klaster yang Anda minati. Kemudian, untuk menemukan status klaster, bacalah di baris tersebut pada kolom **Status**, seperti yang ditunjukkan di bawah ini. ![\[Screenshot dari halaman klaster dengan contoh-klaster yang menunjukkan status aktif.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-status-con.png) ------ #### [ Using the AWS CLI ] Gunakan operasi `describe-db-clusters` untuk melihat status klaster Amazon DocumentDB Anda menggunakan AWS CLI. Kode berikut menemukan status klaster `sample-cluster`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,Status]' ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterIdentifier,Status]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "sample-cluster", "available" ] ] ``` ------ # Siklus hidup klaster Amazon DocumentDB Siklus hidup dari Klaster Amazon DocumentDB termasuk menciptakan, menggambarkan, memodifikasi, dan menghapus klaster. Bagian ini menyediakan informasi tentang cara menyelesaikan proses ini. **Topics** + [Membuat kluster](db-cluster-create.md) + [Menggambarkan cluster](db-cluster-view-details.md) + [Mengubah klaster](db-cluster-modify.md) + [Menentukan pemeliharaan yang tertunda](db-cluster-determine-pending-maintenance.md) + [Patch memperbarui versi mesin cluster](db-cluster-version-upgrade.md) + [Menghentikan dan memulai klaster](db-cluster-stop-start.md) + [Menghapus klaster](db-cluster-delete.md) # Membuat cluster Amazon DocumentDB Sebuah klaster Amazon DocumentDB terdiri dari instans dan volume yang mewakili data untuk klaster. Volume klaster direplikasi dengan enam cara di tiga Availability Zone sebagai volume virtual tunggal. Klaster berisi instans utama dan, secara opsional, hingga 15 instans replika. Bagian berikut menunjukkan cara membuat cluster Amazon DocumentDB menggunakan salah satu atau Konsol Manajemen AWS . AWS CLI Anda kemudian dapat menambahkan instans replika tambahan untuk klaster tersebut. Bila Anda menggunakan konsol untuk membuat klaster Amazon DocumentDB, instans utama secara otomatis dibuat untuk Anda pada saat yang sama. Jika Anda menggunakan AWS CLI untuk membuat klaster Amazon DocumentDB, setelah status klaster *tersedia*, Anda harus membuat instance utama untuk klaster tersebut. ## Prasyarat Berikut ini adalah prasyarat untuk membuat klaster Amazon DocumentDB. Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya. **Untuk mendaftar untuk Akun AWS** 1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup) 1. Ikuti petunjuk online. Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon. Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). ### Prasyarat VPC Anda hanya dapat membuat cluster Amazon DocumentDB di Amazon Virtual Private Cloud (Amazon VPC). VPC Amazon Anda harus memiliki setidaknya satu subnet di masing-masing setidaknya dua Availability Zone agar Anda dapat menggunakannya dengan cluster Amazon DocumentDB. Dengan mendistribusikan instance klaster di seluruh Availability Zone, Anda memastikan bahwa instance tersedia di klaster jika terjadi kegagalan Availability Zone. ### Prasyarat subnet Saat membuat klaster Amazon DocumentDB, Anda harus memilih VPC dan grup subnet yang sesuai dalam VPC itu untuk meluncurkan klaster Anda. Subnet menentukan Availability Zone dan cakupan IP dalam Availability Zone yang ingin Anda gunakan untuk meluncurkan instans. Untuk tujuan diskusi ini, istilah *subnet* dan *Availability Zone* digunakan secara bergantian. Grup subnet adalah set subnet yang telah diberi nama (atau Availability Zone). Apa yang grup subnet izinkan untuk Anda lakukan adalah menentukan Availability Zone yang ingin Anda gunakan untuk meluncurkan instans Amazon DocumentDB. Misalnya, dalam klaster dengan tiga instans, untuk ketersediaan tinggi direkomendasikan agar masing-masing instans tersebut disediakan di Availability Zone yang terpisah. Jadi, jika performa Availability Zone menurun, itu hanya memengaruhi satu instans. Instans Amazon DocumentDB saat ini dapat disediakan dalam hingga tiga Availability Zone. Bahkan jika grup subnet memiliki lebih dari tiga subnet, Anda hanya dapat menggunakan tiga subnet tersebut untuk membuat klaster Amazon DocumentDB. Oleh karenanya, disarankan agar saat Anda membuat grup subnet, pilih hanya tiga subnet tempat Anda ingin menerapkan instans. Di US East (N. Virginia), grup subnet Anda dapat memiliki enam subnet (atau Availability Zones). Namun, ketika sebuah klaster Amazon DocumentDB disediakan, Amazon DocumentDB memilih tiga dari Availability Zones yang digunakannya untuk menyediakan instans. Sebagai contoh, misalkan bahwa ketika Anda membuat sebuah klaster, Amazon DocumentDB memilih Availability Zone \$11A, 1B, dan 1C\$1. Jika Anda mencoba untuk membuat sebuah instans di Availability Zone \$11D\$1, panggilan API gagal. Namun, jika Anda memilih untuk membuat sebuah instans tanpa menentukan Availability Zone tertentu, maka Amazon DocumentDB memilih Availability Zone atas nama Anda. Amazon DocumentDB menggunakan algoritme untuk menyeimbangkan beban instans di Availability Zone untuk membantu Anda mencapai ketersediaan tinggi. Sebagai contoh, jika tiga instans disediakan, secara default, mereka disediakan di tiga Availability Zone dan tidak disediakan secara bersamaan di Availability Zone tunggal. **Rekomendasi:** + Kecuali Anda memiliki alasan tertentu, selalu buat grup subnet dengan tiga subnet. Dengan melakukannya, Anda dibantu untuk memastikan bahwa klaster dengan tiga instans atau lebih dapat mencapai ketersediaan yang lebih tinggi karena instans disediakan di tiga Availability Zone. + Selalu sebarkan instans di beberapa Availability Zone untuk mencapai ketersediaan yang tinggi. Jangan pernah menempatkan semua instans untuk klaster dalam Availability Zone tunggal. + Karena peristiwa failover dapat terjadi setiap saat, Anda tidak boleh berasumsi bahwa instans utama atau instans replika selalu berada di Availability Zone tertentu. ### Prasyarat tambahan Berikut ini adalah beberapa prasyarat tambahan untuk menciptakan sebuah klaster Amazon DocumentDB: + Jika Anda terhubung ke kredensial AWS menggunakan AWS Identity and Access Management (IAM), akun IAM Anda harus memiliki kebijakan IAM yang memberikan izin yang diperlukan untuk menjalankan operasi Amazon DocumentDB. Jika Anda menggunakan akun IAM untuk mengakses konsol Amazon DocumentDB, Anda harus terlebih dahulu masuk Konsol Manajemen AWS ke akun dengan IAM Anda. [Lalu pergi ke konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) + Jika Anda ingin menyesuaikan parameter konfigurasi untuk klaster, Anda harus menentukan grup parameter klaster dan grup parameter dengan pengaturan parameter yang diperlukan. Untuk informasi tentang membuat atau memodifikasi grup parameter klaster atau grup parameter, lihat [Mengelola grup parameter cluster Amazon DocumentDB](cluster_parameter_groups.md). + Anda harus menentukan nomor TCP/IP port yang ingin Anda tentukan untuk cluster Anda. Firewall di beberapa perusahaan memblokir koneksi ke port default untuk Amazon DocumentDB. Jika firewall perusahaan Anda memblokir port default, pilih port lain untuk klaster Anda. Semua instans dalam klaster menggunakan port yang sama. ## Membuat cluster dan instance primer menggunakan Konsol Manajemen AWS Prosedur berikut menjelaskan cara menggunakan konsol untuk meluncurkan klaster Amazon DocumentDB dengan satu atau beberapa instans. ### Buat cluster: menggunakan pengaturan default **Untuk membuat cluster dengan instance menggunakan pengaturan default menggunakan Konsol Manajemen AWS** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Jika Anda ingin membuat klaster di wilayah Wilayah AWS lain selain Wilayah AS Timur (Virginia N.), pilih Wilayah dari daftar di bagian kanan atas konsol. 1. Di panel navigasi, pilih **Klaster**, lalu pilih **Buat**. **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. 1. Pada halaman **Buat klaster Amazon DocumentDB**, selesaikan panel **Konfigurasi**. 1. **Pengidentifikasi klaster**—Terima nama yang disediakan oleh Amazon DocumentDB, atau masukkan nama untuk klaster Anda; misalnya, **sample-cluster**. Aturan penamaan klaster: + Panjangnya adalah [1—63] huruf, angka, atau tanda hubung. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. + Harus unik untuk semua cluster di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS 1. **Versi mesin** —Terima versi mesin default 5.0.0, atau opsional pilih 8.0.0, 4.0.0, atau 3.6.0. 1. **Kelas instans**—Terima default`db.r5.large`, atau pilih kelas instans yang Anda inginkan dari daftar. 1. **Jumlah instans**—Dalam daftar, pilih jumlah instans yang ingin Anda buat dengan klaster ini. Instans pertama adalah instans utama, dan semua instans lain adalah instans replika hanya baca. Anda dapat menambahkan dan menghapus instans nanti jika Anda perlu. Secara default, sebuah klaster Amazon DocumentDB melakukan peluncuran dengan tiga instans (satu primer dan dua replika). 1. Lengkapi bagian **konfigurasi penyimpanan Cluster**. **Pilih **Amazon DocumentDB Standard (default) atau Amazon DocumentDB** I/O-Optimized.** Untuk informasi selengkapnya, lihat [Konfigurasi penyimpanan klaster Amazon DocumentDB](db-cluster-storage-configs.md). 1. Menyelesaikan panel **Autentikasi**. 1. **Username** —Masukkan nama untuk pengguna utama. Untuk masuk ke cluster Anda, Anda harus menggunakan nama pengguna utama. Kendala penamaan pengguna utama: + Panjangnya adalah [1—63] karakter alfanumerik. + Karakter pertamanya harus berupa huruf. + Tidak dapat berupa kata yang dicadangkan oleh mesin basis data. 1. Pilih salah satu opsi kata sandi berikut: + **Dikelola di AWS Secrets Manager** —Pilih opsi ini jika Anda AWS Secrets Manager ingin mengelola kata sandi pengguna utama secara otomatis. Jika Anda memilih opsi ini, konfigurasikan kunci KMS dengan membuat sendiri atau menggunakan kunci yang dibuat Secrets Manager. + **Dikelola sendiri** —Pilih opsi ini jika Anda ingin mengelola sendiri kata sandi pengguna utama Anda. Jika Anda memilih opsi ini, masukkan kata sandi untuk pengguna utama, lalu konfirmasikan. Untuk masuk ke cluster Anda, Anda harus menggunakan kata sandi untuk pengguna utama. Aturan kata sandi: + Panjangnya adalah [8-100] karakter ASCII yang dapat dicetak. + Dapat menggunakan karakter ASCII apa pun yang dapat dicetak kecuali untuk yang berikut ini: + **/** (garis miring ke depan) + **"** (tanda kutip ganda) + **@** (simbol pada) 1. Di bagian bawah layar, pilih salah satu dari berikut ini: + Untuk membuat klaster sekarang, pilih **Buat klaster**. + Untuk membatalkan pembuatan klaster, pilih **Batalkan**. + Untuk lebih mengkonfigurasi klaster sebelum membuat, pilih **Menampilkan konfigurasi tambahan**, dan kemudian lanjutkan di [Buat cluster: konfigurasi tambahan](#db-cluster-create-con-additional-configs). Konfigurasi yang tercakup dalam bagian **Konfigurasi tambahan** adalah sebagai berikut: + **Pengaturan jaringan**—Default di sini akan menggunakan grup keamanan VPC `default`. + **Opsi klaster**—Default di sini akan menggunakan port 27017 dan grup parameter default. + **Enkripsi**—Default adalah untuk mengaktifkan enkripsi dengan menggunakan kunci `(default) aws/rds`. **penting** Setelah dienkripsi, klaster tidak dapat dibuat tanpa enkripsi. + **Backup**—Default adalah untuk mempertahankan backup selama 1 hari dan membiarkan Amazon DocumentDB memilih jendela backup. + **Ekspor log** —Defaultnya adalah tidak mengekspor log audit ke CloudWatch Log. + **Pemeliharaan**—Defaultnya adalah membiarkan Amazon DocumentDB memilih jendela pemeliharaan. + **Perlindungan penghapusan**—Lindungi klaster Anda dari penghapusan yang tidak disengaja. Default untuk klaster yang dibuat dengan menggunakan konsol *diaktifkan*. Jika Anda menerima pengaturan default sekarang, Anda dapat mengubah sebagian besar pengaturan tersebut nanti dengan memodifikasi klaster. 1. Mengaktifkan sambungan masuk untuk grup keamanan klaster Anda. Jika Anda tidak mengubah pengaturan default untuk klaster Anda, Anda membuat sebuah klaster menggunakan grup keamanan default untuk VPC default di wilayah tertentu. Untuk terhubung ke Amazon DocumentDB, Anda harus mengaktifkan koneksi masuk pada port 27017 (atau port pilihan Anda) untuk grup keamanan klaster Anda. **Untuk menambahkan koneksi masuk ke grup keamanan klaster Anda** 1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EC2 di. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) 1. Di bagian **Sumber Daya** dari jendela utama, pilih **Grup keamanan**. ![\[Gambar: Daftar sumber daya yang menyoroti opsi tautan Grup Keamanan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png) 1. Dari daftar grup keamanan, temukan grup keamanan yang Anda gunakan saat membuat klaster Anda (kemungkinan besar grup keamanan *default*) dan pilih kotak di sebelah kiri nama grup keamanan. ![\[Gambar: Daftar grup keamanan yang menyoroti satu grup keamanan dengan kotak yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png) 1. Dari menu **Tindakan**, pilih **Edit aturan masuk** lalu pilih atau masukkan batasan aturan. 1. **Jenis**—Dari daftar tersebut, pilih protokol untuk membuka lalu lintas jaringan. 1. **Protokol**—Dari daftar, pilih jenis protokol. 1. **Cakupan Port**—Untuk aturan kustom, masukkan nomor port atau cakupan port. Pastikan bahwa nomor port atau cakupan terdiri atas port yang Anda tentukan ketika membuat klaster Anda (default: 27017). 1. **Sumber**—Menentukan lalu lintas yang dapat menjangkau instans Anda. Dari daftar, pilih sumber lalu lintas. Jika Anda memilih **Khusus**, tentukan alamat IP tunggal atau cakupan alamat IP dalam notasi CIDR (misalnya, 203.0.113.5/32). 1. **Deskripsi**—Masukkan deskripsi untuk aturan ini. 1. Setelah selesai membuat aturan, pilih **Simpan**. ### Buat cluster: konfigurasi tambahan Jika Anda ingin menerima pengaturan default untuk klaster Anda, Anda dapat melewatkan langkah-langkah berikut dan memilih **Buat klaster**. 1. Menyelesaikan panel **Pengaturan jaringan**. ![\[Cuplikan layar yang menampilkan panel pengaturan jaringan dan langkah-langkah untuk mengkonfigurasi pengaturan jaringan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png) 1. **Virtual Private Cloud (VPC)**—Dalam daftar, pilih Amazon VPC tempat Anda ingin meluncurkan klaster ini. 1. **Grup subnet**—Dalam daftar, pilih grup subnet yang ingin Anda gunakan untuk klaster ini. 1. **Grup keamanan VPC**—Di daftar, pilih grup keamanan VPC untuk klaster ini. 1. Lengkapi panel **Opsi klaster**. ![\[Screenshot menampilkan panel pilihan klaster dengan langkah-langkah untuk mengkonfigurasi pengaturan klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png) 1. **Port basis data** —Gunakan panah atas dan bawah untuk mengatur TCP/IP port yang akan digunakan aplikasi untuk terhubung ke instans Anda. 1. **Grup parameter klaster**—Dalam daftar grup parameter, pilih grup parameter klaster untuk klaster ini. 1. Menyelesaikan panel **Enkripsi**. ![\[Cuplikan layar dari panel enkripsi yang menunjukkan langkah-langkah untuk mengkonfigurasi enkripsi pada klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/encrypt-at-rest.png) 1. **E ncryption-at-rest** —Pilih salah satu dari berikut ini: + **Aktifkan enkripsi**—Default. Semua data at rest dienkripsi. Jika Anda memilih untuk mengenkripsi data, Anda tidak dapat membatalkan tindakan ini. + **Menonaktifkan enkripsi**—Data Anda tidak dienkripsi. 1. **AWS Kunci KMS** —Ini hanya tersedia jika Anda mengenkripsi data Anda. Dalam daftar, pilih kunci yang ingin Anda gunakan untuk mengenkripsi data dalam klaster ini. Nilai default-nya `(default) aws/rds`. Jika Anda memilih **Masukkan ARN kunci**, Anda harus memasukkan Amazon Resource Name (ARN) untuk kunci tersebut. 1. Menyelesaikan panel **Backup**. ![\[Cuplikan layar dari panel Backup menampilkan langkah-langkah untuk mengkonfigurasi jendela backup klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png) 1. **Periode retensi cadangan**—Dalam daftar, pilih jumlah hari untuk menyimpan backup otomatis klaster ini sebelum menghapusnya. 1. **Jendela backup**—Atur waktu harian dan durasi yang akan digunakan oleh Amazon DocumentDB untuk membuat backup dari klaster ini. 1. **Waktu mulai**—Pada daftar pertama, pilih jam waktu mulai (UTC) untuk memulai pencadangan otomatis. Dalam daftar kedua, pilih menit dari jam pilihan Anda untuk memulai backup otomatis. 1. **Durasi**—Dalam daftar, pilih jumlah jam yang akan dialokasikan untuk membuat cadangan otomatis. 1. Lengkapi panel **ekspor Log** dengan memilih jenis log yang ingin Anda ekspor ke CloudWatch Log. ![\[Cuplikan layar dari panel ekspor Log menunjukkan langkah-langkah untuk mengkonfigurasi pencatatan DLL klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png) + **Log audit** —Pilih opsi ini untuk mengaktifkan mengekspor log audit ke Amazon CloudWatch Logs. Jika Anda memilih **Log audit**, Anda harus mengaktifkan `audit_logs` di grup parameter kustom klaster. Untuk informasi selengkapnya, lihat [Mengaudit acara Amazon DocumentDB](event-auditing.md). + **Log profiler** —Pilih opsi ini untuk mengaktifkan mengekspor log profiler operasi ke Amazon Logs. CloudWatch Jika Anda memilih **Log profil**, Anda juga harus mengubah parameter berikut dalam grup parameter kustom klaster: + `profiler`—Setel ke`enabled`. + `profiler_threshold_ms`—Set ke nilai `[0-INT_MAX]` untuk mengatur ambang batas pada profil operasi. + `profiler_sampling_rate`—Set ke nilai `[0.0-1.0]` untuk mengatur persentase operasi lambat ke profil. Untuk informasi selengkapnya, lihat [Membuat profil operasi Amazon DocumentDB](profiling.md). 1. Menyelesaikan panel **Pemeliharaan**. ![\[Cuplikan layar dari panel Pemeliharaan yang menampilkan langkah-langkah untuk mengkonfigurasi jendela pemeliharaan klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png) 1. Pilih salah satu dari berikut + **Pilih jendela**—Anda dapat menentukan hari dalam seminggu, waktu mulai UTC, dan durasi untuk Amazon DocumentDB untuk melakukan pemeliharaan pada klaster Anda. 1. **Hari mulai**—Dalam daftar, pilih hari dalam seminggu untuk memulai pemeliharaan klaster. 1. **Waktu mulai**—Dalam daftar, pilih jam dan menit (UTC) untuk memulai pemeliharaan. 1. **Durasi**—Dalam daftar, pilih berapa banyak waktu yang akan dialokasikan untuk pemeliharaan klaster. Jika pemeliharaan tidak dapat diselesaikan dalam waktu yang ditentukan, proses pemeliharaan akan berlanjut melewati waktu yang ditentukan sampai selesai. + **Tidak Ada preferensi**-Amazon DocumentDB memilih hari dalam seminggu, waktu mulai, dan durasi untuk melakukan pemeliharaan. 1. Jika Anda ingin menambahkan satu atau beberapa tag ke klaster ini, lengkapi panel **Tag**. ![\[Cuplikan layar dari kotak centang Aktifkan perlindungan penghapusan, yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png) Untuk setiap tag yang ingin Anda tambahkan ke klaster, ulangi langkah-langkah berikut. Anda mungkin memiliki hingga 10 di sebuah klaster. 1. Pilih **Tambahkan tag**. 1. Ketik **Kunci** tag. 1. Secara opsional, ketik **Nilai** tag. Untuk menghapus sebuah tag, pilih **Hapus tag**. 1. **Perlindungan penghapusan** diaktifkan secara default ketika Anda membuat klaster dengan menggunakan konsol. Untuk menonaktifkan perlindungan penghapusan, kosongkan **Aktifkan perlindungan penghapusan**. Ketika diaktifkan, perlindungan penghapusan mencegah agar klaster tidak terhapus. Untuk menghapus klaster yang dilindungi dari penghapusan, Anda harus terlebih dahulu memodifikasi klaster untuk menonaktifkan penghapusan perlindungan. ![\[Cuplikan layar dari kotak centang Aktifkan perlindungan penghapusan, yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png) Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). 1. Untuk membuat klaster, pilih **Buat klaster**. Jika tidak, pilih **Batalkan**. ## Membuat cluster menggunakan AWS CLI Prosedur berikut menjelaskan cara menggunakan AWS CLI untuk meluncurkan cluster Amazon DocumentDB dan membuat replika Amazon DocumentDB. **Parameter** + **--db-cluster-identifier**—Diperlukan. Sebuah string huruf kecil yang mengidentifikasi klaster ini. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-create.html) + **--engine**—Diperlukan. Harus berupa **docdb**. + **--deletion-protection \$1 --no-deletion-protection**—Opsional. Ketika diaktifkan, perlindungan penghapusan mencegah agar klaster tidak terhapus. Saat Anda menggunakan AWS CLI, pengaturan defaultnya adalah menonaktifkan perlindungan penghapusan. Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). + **--storage-type standard \$1 iopt1**—Opsional. Default: **standard**. Konfigurasi penyimpanan cluster. Nilai yang valid adalah `standard` (Standar) atau `iopt1` (I/O dioptimalkan). + **--master-username**—Diperlukan. Nama pengguna yang digunakan untuk mengautentikasi pengguna. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-create.html) + **--master-user-password**—Opsional. Kata sandi pengguna yang digunakan untuk mengautentikasi pengguna. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-cluster-create.html) + **--manage-master-user-password**—Opsional. Amazon DocumentDB menghasilkan kata sandi pengguna utama dan mengelolanya sepanjang siklus hidupnya di Secrets Manager. Untuk parameter tambahan, lihat [CreateDBCluster](API_CreateDBCluster.md). **Untuk meluncurkan cluster Amazon DocumentDB menggunakan AWS CLI** Untuk membuat cluster Amazon DocumentDB, hubungi file. `create-db-cluster` AWS CLI AWS CLI Perintah berikut membuat klaster Amazon DocumentDB `sample-cluster` bernama dengan perlindungan penghapusan diaktifkan. Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). Juga, `--engine-version` adalah parameter opsional yang default ke versi mesin utama terbaru. Versi mesin default saat ini adalah 5.0.0 (catatan: Amazon DocumentDB 8.0 tersedia tetapi harus ditentukan secara eksplisit). Ketika versi mesin utama baru dirilis, versi mesin default untuk `--engine-version` akan diperbarui untuk mencerminkan versi mesin utama terakhir. Akibatnya, untuk beban kerja produksi, dan terutama yang bergantung pada skrip, otomatisasi, atau CloudFormation templat, kami menyarankan Anda secara eksplisit menentukan `--engine-version` ke versi utama yang dimaksud. **catatan** Jika `db-subnet-group-name` atau `vpc-security-group-id` tidak ditentukan, Amazon DocumentDB akan menggunakan grup subnet default dan grup keamanan Amazon VPC untuk wilayah tertentu. Untuk Linux, macOS, atau Unix: ``` aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 5.0.0 \ --deletion-protection \ --master-username masteruser \ --master-user-password password ``` Untuk Windows: ``` aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 5.0.0 ^ --deletion-protection ^ --master-username masteruser ^ --master-user-password password ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBCluster": { "StorageEncrypted": false, "DBClusterMembers": [], "Engine": "docdb", "DeletionProtection" : "enabled", "ClusterCreateTime": "2018-11-26T17:15:19.885Z", "DBSubnetGroup": "default", "EngineVersion": "5.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "DBClusterIdentifier": "sample-cluster", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb5.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com", "AssociatedRoles": [], "HostedZoneId": "ZNKXTT8WH85VW", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "AvailabilityZones": [ "us-east-1a", "us-east-1c", "us-east-1e" ], "Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com" } } ``` Dibutuhkan beberapa menit untuk membuat klaster. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk memantau status cluster Anda. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md). **penting** Saat Anda menggunakan AWS CLI untuk membuat klaster Amazon DocumentDB, tidak ada instance yang dibuat. Akibatnya, Anda harus secara eksplisit membuat instans primer dan semua instans replika yang Anda butuhkan. Anda dapat menggunakan konsol atau AWS CLI untuk membuat instance. Untuk informasi selengkapnya, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md). Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html) di *Referensi API Amazon DocumentDB*. # Menggambarkan cluster Amazon DocumentDB Anda dapat menggunakan Amazon DocumentDB Management Console atau AWS CLI untuk melihat detail seperti titik akhir koneksi, grup keamanan VPCs, dan grup parameter yang berkaitan dengan cluster Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat berikut ini: + [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md) + [Menemukan titik akhir klaster](db-cluster-endpoints-find.md) ------ #### [ Using the Konsol Manajemen AWS ] Gunakan prosedur berikut untuk melihat perincian klaster Amazon DocumentDB yang ditentukan dengan menggunakan konsol. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Dalam daftar klaster, pilih nama klaster yang ingin Anda lihat perinciannya. Informasi tentang klaster diatur ke dalam pengelompokan berikut: + **Ringkasan** — Informasi umum tentang klaster, termasuk versi mesin, status klaster, pemeliharaan tertunda, dan status grup parameter. + **Konektivitas & Keamanan** —Bagian **Hubungkan** berisi daftar titik akhir sambungan untuk membuat sambungan ke klaster ini dengan mongo shell atau dengan aplikasi. Bagian **Grup Keamanan** terdiri atas daftar grup keamanan yang terkait dengan klaster ini dan ID VPC serta deskripsinya. + **Konfigurasi** — Bagian **Detail klaster** berisi daftar perincian tentang klaster, termasuk Amazon Resource Name (ARN) klaster, titik akhir, dan grup parameter. Ini juga berisi daftar informasi backup klaster, perincian pemeliharaan, dan pengaturan keamanan dan jaringan. Bagian **Instans klaster** berisi daftar instans yang dimiliki klaster ini dengan masing-masing peran instans dan status grup parameter klaster. + **Monitoring** — Metrik Amazon CloudWatch Logs untuk klaster ini. Untuk informasi selengkapnya, lihat [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md). + **Acara & tag** — Bagian **Peristiwa terbaru** berisi daftar peristiwa terbaru untuk klaster ini. Amazon DocumentDB menyimpan catatan peristiwa yang terkait dengan klaster, instans, snapshot, grup keamanan, dan grup parameter klaster Anda. Informasi ini mencakup tanggal, waktu, dan pesan yang terkait dengan setiap peristiwa. Bagian **Tag** berisi daftar tag yang dilampirkan ke klaster ini. ------ #### [ Using the AWS CLI ] Untuk melihat detail cluster Amazon DocumentDB Anda menggunakan, gunakan perintah seperti AWS CLI yang ditunjukkan pada contoh `describe-db-clusters` di bawah ini. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html)di Referensi *API Manajemen Sumber Daya Amazon DocumentDB*. **catatan** Untuk fitur pengelolaan tertentu seperti pengelolaan siklus hidup klaster dan instans, Amazon DocumentDB memanfaatkan teknologi operasi yang dibagikan dengan Amazon RDS. Parameter filter `filterName=engine,Values=docdb` hanya mengembalikan klaster Amazon DocumentDB. **Example** **Contoh 1: Daftar semua cluster Amazon DocumentDB** AWS CLI Kode berikut mencantumkan detail untuk semua cluster Amazon DocumentDB di suatu wilayah. ``` aws docdb describe-db-clusters --filter Name=engine,Values=docdb ``` Output dari operasi ini akan terlihat seperti berikut. ``` { "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] } ``` **Example** **Contoh 2: Daftar semua detail untuk klaster Amazon DocumentDB tertentu** AWS CLI Kode berikut mencantumkan rincian untuk cluster`sample-cluster`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ``` Output dari operasi ini terlihat seperti berikut ini. ``` { "DBClusters": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1c", "us-east-1a", "us-east-1d" ], "BackupRetentionPeriod": 2, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00", "Endpoint": "sample-cluster.node.us-east-1.amazon.com", "ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "5.0.0", "LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00", "Port": 27017, "MasterUsername": "chimeraAdmin", "PreferredBackupWindow": "22:22-22:52", "PreferredMaintenanceWindow": "sun:03:01-sun:03:31", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-9084c2ec", "Status": "active" } ], "HostedZoneId": "Z06853723JYKYBXTJ49RB", "StorageEncrypted": false, "DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "iopt1", "AutoMinorVersionUpgrade": false, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00" } ] } ``` **Example** **Contoh 3: Daftar detail spesifik untuk klaster Amazon DocumentDB** Untuk mencantumkan subset detail kluster menggunakan AWS CLI, tambahkan yang menentukan anggota klaster mana yang akan dicantumkan `describe-db-clusters` operasi. `--query` Parameter `--db-cluster-identifier` adalah pengenal untuk klaster tertentu yang perinciannya ingin Anda tampilkan. Untuk informasi selengkapnya tentang kueri, lihat [ Cara Filter Output dengan `--query` Opsi](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) di *AWS Command Line Interface Panduan Pengguna*. Contoh berikut mencantumkan instans dalam klaster Amazon DocumentDB. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterMembers]' ``` Output dari operasi ini terlihat seperti berikut ini. ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ------ # Memodifikasi cluster Amazon DocumentDB Untuk mengubah suatu klaster, klaster tersebut harus dalam kondisi *tersedia*. Anda tidak dapat mengubah klaster yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu hingga klaster *tersedia*, lalu buat modifikasi yang diinginkan. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md). ------ #### [ Using the Konsol Manajemen AWS ] Gunakan prosedur berikut untuk memodifikasi klaster Amazon DocumentDB tertentu menggunakan konsol. **Cara memodifikasi klaster Amazon DocumentDB** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Tentukan klaster yang ingin Anda modifikasi dengan memilih tombol di sebelah kiri nama klaster. 1. Pilih **Tindakan**, lalu pilih **Modifikasi**. 1. Di **Modifikasi klaster: panel **, buat perubahan yang Anda inginkan. Anda dapat membuat perubahan di bidang berikut: + **Spesifikasi klaster** —Nama klaster, grup keamanan, dan manajemen kredensialnya. + **Konfigurasi penyimpanan cluster** —Mode penyimpanan data cluster. Pilih antara konfigurasi Standar dan I/O-Optimized. + **Opsi klaster**—Port klaster dan grup parameter. + **Backup**—Periode penyimpanan backup klaster dan jendela backup. + **Ekspor log**—Aktifkan atau nonaktifkan ekspor audit atau log pembuat profil. + **Pemeliharaan**—Atur jendela pemeliharaan klaster. + **Perlindungan penghapusan**—Aktifkan atau nonaktifkan perlindungan penghapusan pada klaster. Perlindungan penghapusan diaktifkan secara default. 1. Setelah selesai, pilih **Lanjutkan** untuk melihat ringkasan perubahan Anda. 1. Jika Anda puas dengan perubahan Anda, Anda dapat memilih **Modifikasi klaster** untuk memodifikasi klaster Anda. Sebagai alternatif, Anda dapat memilih **Kembali** atau **Batalkan** untuk mengedit atau membatalkan perubahan Anda, masing-masing. Diperlukan waktu beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan klaster hanya ketika statusnya *tersedia*. Anda dapat memantau status klaster menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md). ------ #### [ Using the AWS CLI ] Gunakan operasi `modify-db-cluster` untuk mengubah klaster yang ditentukan dengan menggunakan AWS CLI. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) di *Referensi API Amazon DocumentDB*. **Parameter** + **--db-cluster-identifier**—Diperlukan. Pengenal klaster Amazon DocumentDB yang akan Anda modifikasi. + **--backup-retention-period**—Opsional. Jumlah hari untuk penyimpanan cadangan otomatis dipertahankan. Nilai yang valid adalah 1–35. + **--storage-type**—Opsional. Konfigurasi penyimpanan cluster. Nilai yang valid adalah `standard` (Standar) atau `iopt1` (I/O dioptimalkan). + **--db-cluster-parameter-group-name**—Opsional. Nama grup parameter klaster yang digunakan untuk klaster. + **--manage-master-user-password**—Opsional. Amazon DocumentDB menghasilkan kata sandi pengguna utama dan mengelolanya sepanjang siklus hidupnya di Secrets Manager. + **--rotate-master-user-password**—Opsional. Secrets Manager menghasilkan versi rahasia baru untuk rahasia yang ada. Versi baru rahasia berisi kata sandi pengguna utama yang baru. Amazon DocumentDB mengubah kata sandi pengguna utama untuk cluster agar sesuai dengan kata sandi untuk versi rahasia baru. Anda harus menentukan **--apply-immediately** opsi ketika Anda memutar kata sandi utama. + **--master-user-password**—Opsional. Kata sandi baru untuk pengguna basis data utama. Aturan kata sandi: + Panjang adalah [8—100] karakter ASCII yang dapat dicetak. + Dapat menggunakan karakter ASCII yang dapat dicetak kecuali untuk berikut ini: + **/** (garis miring ke depan) + **"** (tanda kutip ganda) + **@** (simbol pada) + **--new-db-cluster-identifier**—Opsional. Pengenal klaster baru untuk klaster ketika mengubah nama klaster. Nilai ini disimpan sebagai string huruf kecil. Aturan penamaan: + Panjangnya adalah [1—63] huruf, angka, atau tanda hubung. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. + Harus unik untuk semua cluster di Amazon RDS, Amazon Neptune, dan Amazon DocumentDB per, per wilayah. Akun AWS + **--preferred-backup-window**—Opsional. Dalam rentang waktu harian selama pencadangan otomatis dibuat, dalam Waktu Terkoordinasi Universal (UTC). + Format: `hh24:mm-hh24:mm` + **--preferred-maintenance-window**—Opsional. Rentang waktu mingguan untuk melakukan pemeliharaan sistem dapat terjadi, dalam UTC. + Format: `ddd:hh24:mm-ddd:hh24:mm` + Hari yang sah: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, dan `Sat`. + **--deletion-protection** atau **--no-deletion-protection**—Opsional. Apakah perlindungan penghapusan harus diaktifkan pada klaster ini. Perlindungan penghapusan mencegah sebuah klaster dari yang sengaja dihapus sampai klaster dimodifikasi untuk menonaktifkan perlindungan penghapusan. Untuk informasi selengkapnya, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). + **--apply-immediately** atau **--no-apply-immediately**—Gunakan `--apply-immediately` untuk segera membuat perubahan. Gunakan `--no-apply-immediately` untuk membuat perubahan selama jendela pemeliharaan berikutnya pada klaster Anda. **Example** Kode berikut mengubah periode penyimpanan cadangan untuk klaster `sample-cluster`. Untuk Linux, macOS, atau Unix: ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --apply-immediately \ --backup-retention-period 7 ``` Untuk Windows: ``` aws docdb modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --apply-immediately ^ --backup-retention-period 7 ``` Output dari operasi ini terlihat seperti berikut ini. ``` { "DBCluster": { "BackupRetentionPeriod": 7, "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE", "Status": "available", "DBClusterMembers": [ { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster-instance", "IsClusterWriter": true } ], "ReadReplicaIdentifiers": [], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PreferredMaintenanceWindow": "sat:09:51-sat:10:21", "EarliestRestorableTime": "2018-06-17T00:06:19.374Z", "StorageEncrypted": false, "MultiAZ": false, "AssociatedRoles": [], "MasterUsername": "", "DBClusterIdentifier": "sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "HostedZoneId": "Z2SUY0A1719RZT", "LatestRestorableTime": "2018-06-18T21:17:05.737Z", "AllocatedStorage": 1, "Port": 27017, "Engine": "docdb", "DBClusterParameterGroup": "default.docdb3.4", "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBSubnetGroup": "default", "PreferredBackupWindow": "00:00-00:30", "EngineVersion": "3.4", "ClusterCreateTime": "2018-06-06T19:25:47.991Z", "IAMDatabaseAuthenticationEnabled": false } } ``` Diperlukan waktu beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan klaster hanya ketika statusnya *tersedia*. Anda dapat memantau status klaster menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md). ------ # Menentukan pemeliharaan yang tertunda Anda dapat menentukan apakah Anda memiliki versi mesin Amazon DocumentDB terbaru dengan menentukan apakah Anda memiliki pemeliharaan klaster tertunda. ------ #### [ Using the Konsol Manajemen AWS ] Anda dapat menggunakan Konsol Manajemen AWS untuk menentukan apakah klaster memiliki pemeliharaan yang tertunda. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Klaster**. **Tip** Jika panel navigasi tidak terlihat di sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Temukan kolom **Pemeliharaan** untuk menentukan apakah sebuah klaster memiliki pemeliharaan tertunda. ![\[Cuplikan layar konsol yang menunjukkan bidang pemeliharaan klaster Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png) **Tidak ada** menunjukkan bahwa klaster menjalankan versi mesin terbaru. **Tersedia** menunjukkan bahwa klaster memiliki pemeliharaan tertunda, yang mungkin berarti bahwa peningkatan mesin diperlukan. 1. Jika klaster Anda memiliki pemeliharaan tertunda, lanjutkan dengan langkah-langkah di [Melakukan pembaruan tambalan ke versi mesin cluster](db-cluster-version-upgrade.md). ------ #### [ Using the AWS CLI ] Anda dapat menggunakan AWS CLI untuk menentukan apakah sebuah cluster memiliki versi mesin terbaru dengan menggunakan `describe-pending-maintenance-actions` operasi dengan parameter berikut. **Parameter** + **--resource-identifier**—Opsional. ARN untuk sumber daya (klaster). Jika parameter ini dihilangkan, tindakan pemeliharaan tertunda untuk semua klaster didaftarkan. + **--region**—Opsional. Wilayah AWS tempat Anda ingin menjalankan operasi ini, misalnya, `us-east-1`. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \ --region us-east-1 ``` Untuk Windows: ``` aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^ --region us-east-1 ``` Output dari operasi ini terlihat seperti berikut ini. ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Description": "New feature", "Action": "db-upgrade", "ForcedApplyDate": "2019-02-25T21:46:00Z", "AutoAppliedAfterDate": "2019-02-25T07:41:00Z", "CurrentApplyDate": "2019-02-25T07:41:00Z" } ] } ] } ``` Jika klaster Anda memiliki pemeliharaan tertunda, lanjutkan dengan langkah-langkah di [Melakukan pembaruan tambalan ke versi mesin cluster](db-cluster-version-upgrade.md). ------ # Melakukan pembaruan tambalan ke versi mesin cluster Di bagian ini, kami akan menjelaskan cara menerapkan pembaruan tambalan menggunakan Konsol Manajemen AWS atau. AWS CLI Pembaruan patch adalah pembaruan dalam versi mesin yang sama (misalnya, memperbarui versi mesin 3.6 ke versi mesin 3.6 yang lebih baru). Anda dapat memperbaruinya segera atau selama jendela pemeliharaan berikutnya pada klaster Anda. Untuk menentukan apakah mesin Anda memerlukan pembaruan, lihat [Menentukan pemeliharaan yang tertunda](db-cluster-determine-pending-maintenance.md). Silakan dicatat bahwa ketika Anda menerapkan pembaruan, klaster Anda akan mengalami waktu henti selama beberapa saat. **catatan** Jika Anda mencoba untuk meng-upgrade dari versi mesin utama ke yang lain, seperti 3.6 ke 5.0, lihat salah satu [Peningkatan versi utama Amazon DocumentDB di tempat](docdb-mvu.md) atau[Memutakhirkan cluster Amazon DocumentDB Anda menggunakan AWS Database Migration Service](docdb-migration.versions.md). Upgrade versi utama di tempat hanya mendukung docdb 5.0 sebagai versi mesin target. Ada dua persyaratan konfigurasi untuk mendapatkan pembaruan patch terbaru untuk sebuah versi mesin pada suatu klaster: + Status klaster harus *tersedia*. + Klaster harus menjalankan versi mesin sebelumnya. ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut menerapkan pembaruan patch untuk versi mesin pada klaster dengan menggunakan konsol. Anda memiliki pilihan untuk memperbarui segera atau selama jendela pemeliharaan berikutnya pada klaster Anda. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda tingkatkan. Status klaster harus *tersedia*. **Tip** Jika panel navigasi tidak terlihat di sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Dari menu **Tindakan**, pilih salah satu dari berikut ini. Opsi menu ini dapat dipilih hanya jika klaster yang Anda pilih tidak menjalankan versi mesin terbaru. ![\[Gambar: Tindakan Pembaruan Amazon DocumentDB\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-upgrade-action.png) + **Tingkatkan sekarang**—Segera memulai proses peningkatan. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru. + **Tingkatkan pada jendela berikutnya**—Memulai proses peningkatan selama jendela pemeliharaan berikutnya pada klaster. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru. 1. Jika jendela konfirmasi terbuka, pilih salah satu hal berikut: + **Meningkatkan**—Untuk meningkatkan klaster Anda ke versi mesin terbaru sesuai dengan jadwal yang dipilih pada langkah sebelumnya. + **Batalkan**—Untuk membatalkan peningkatan mesin klaster dan melanjutkan dengan versi mesin saat ini pada klaster. ------ #### [ Using the AWS CLI ] Anda dapat menerapkan pembaruan tambalan ke cluster Anda menggunakan AWS CLI dan `apply-pending-maintenance-action` operasi dengan parameter berikut. **Parameter** + **--resource-identifier**—Diperlukan. ARN dari klaster Amazon DocumentDB yang akan Anda tingkatkan. + **--apply-action**—Diperlukan. Nilai berikut diizinkan. Untuk meningkatkan versi mesin klaster Anda, gunakan `db-upgrade`. + **db-upgrade** + **system-update** + **--opt-in-type**—Diperlukan. Nilai berikut diizinkan. + `immediate`—Terapkan tindakan pemeliharaan segera. + `next-maintenance`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya. + `undo-opt-in`—Membatalkan permintaan keikutsertaan `next-maintenance` yang ada. **Example** Patch contoh berikut memperbarui versi mesin `sample-cluster` ke versi 4.0.0. Untuk Linux, macOS, atau Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \ --apply-action db-upgrade \ --opt-in-type immediate ``` Untuk Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^ --apply-action db-upgrade ^ --opt-in-type immediate ``` Output dari operasi ini terlihat seperti berikut ini. ``` { "ResourcePendingMaintenanceActions": { "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38", "PendingMaintenanceActionDetails": [ { "CurrentApplyDate": "2019-02-20T20:57:06.904Z", "Description": "Bug fixes", "ForcedApplyDate": "2019-02-25T21:46:00Z", "OptInStatus": "immediate", "Action": "db-upgrade", "AutoAppliedAfterDate": "2019-02-25T07:41:00Z" } ] } } ``` ------ # Menghentikan dan memulai cluster Amazon DocumentDB Menghentikan dan memulai klaster Amazon DocumentDB membantu Anda mengelola biaya untuk pengembangan dan pengujian lingkungan. Alih-alih menciptakan dan menghapus klaster dan instans setiap kali Anda menggunakan Amazon DocumentDB, untuk sementara, Anda dapat menghentikan semua instans pada klaster ketika tidak diperlukan. Anda kemudian dapat memulainya lagi saat melanjutkan pengujian. **Topics** + [Ikhtisar menghentikan dan memulai klaster](#db-cluster-stop-start-overview) + [Operasi yang dapat Anda lakukan pada cluster yang dihentikan](#db-cluster-stopped-operations) ## Ikhtisar menghentikan dan memulai klaster Selama periode di mana Anda tidak memerlukan klaster Amazon DocumentDB, Anda dapat menghentikan semua instans dalam klaster itu sekaligus. Anda lalu dapat memulai klaster lagi kapan saja Anda memerlukannya. Memulai dan menghentikan menyederhanakan proses pengaturan dan perombakan pada klaster yang digunakan untuk pengembangan, pengujian, atau aktifitas serupa yang tidak memerlukan ketersediaan berkelanjutan. Anda dapat menghentikan dan memulai cluster menggunakan Konsol Manajemen AWS atau AWS CLI dengan satu tindakan, terlepas dari berapa banyak instance yang ada di cluster. Sementara klaster Anda berhenti, volume penyimpanan klaster tetap tidak berubah. Anda hanya dikenakan biaya untuk penyimpanan, snapshot manual, dan penyimpanan cadangan otomatis dalam jendela penyimpanan yang Anda tentukan. Anda tidak dikenakan biaya untuk jam instans apa pun. Amazon DocumentDB secara otomatis memulai klaster Anda setelah tujuh hari sehingga tidak tertinggal pembaruan pemeliharaan yang diperlukan. Ketika klaster Anda dimulai setelah tujuh hari, Anda akan mulai dikenakan biaya untuk instans di klaster lagi. Sementara klaster Anda berhenti, Anda tidak dapat mengajukan kueri untuk volume penyimpanan Anda karena kueri mengharuskan instans dalam keadaan tersedia. Ketika sebuah klaster Amazon DocumentDB dihentikan, baik klaster maupun instans dapat dimodifikasi dengan cara apa pun. Ini termasuk menambahkan atau menghapus instans, atau menghapus klaster. ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut menunjukkan kepada Anda caranya menghentikan sebuah klaster dengan satu atau beberapa instans dalam keadaan tersedia, atau caranya memulai klaster yang telah dihentikan. **Untuk menghentikan atau memulai klaster Amazon DocumentDB** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Klaster**. **Tip** Jika panel navigasi tidak terlihat di sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda mulai atau tingkatkan. 1. Pilih **Tindakan**, lalu pilih tindakan yang ingin Anda lakukan pada klaster. + Jika Anda ingin menghentikan klaster dan klaster tersedia: 1. Pilih **Berhenti**. ![\[Gambar: Menghentikan sebuah klaster\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-stop.png) Untuk menghindari pengaktifan mekanisme failover, operasi stop menghentikan instans replika terlebih dahulu, lalu instans utama. 1. Pada dialog konfirmasi, konfirmasikan bahwa Anda ingin menghentikan klaster dengan memilih **Hentikan klaster**, atau untuk mempertahankan klaster agar terus berjalan, pilih **Batalkan**. ![\[Gambar: Mulai sebuah klaster\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png) + Jika Anda ingin memulai klaster, dan klaster berhenti, pilih **Mulai**. ![\[Gambar: Mulai sebuah klaster\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-start.png) 1. Pantau status klaster dan instansnya. Jika Anda memulai klaster, Anda dapat melanjutkan penggunaan klaster ketika klaster dan instansnya *tersedia*. Untuk informasi selengkapnya, lihat [Menentukan status klaster](db-cluster-status.md). ![\[Gambar: Status klaster berhenti dan mulai\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png) ------ #### [ Using the AWS CLI ] Contoh kode berikut menunjukkan kepada Anda caranya menghentikan sebuah klaster dengan satu atau beberapa instans dalam keadaan tersedia, atau caranya memulai klaster yang telah dihentikan. Untuk menghentikan cluster dengan satu atau lebih instance yang tersedia menggunakan AWS CLI, gunakan `stop-db-cluster` operasi. Untuk memulai klaster yang telah dihentikan, gunakan operasi `start-db-cluster`. Kedua operasi menggunakan parameter `--db-cluster-identifier`. **Parameter:** + **--db-cluster-identifier**—Diperlukan. Nama klaster untuk berhenti atau mulai. **Example — Untuk menghentikan cluster menggunakan AWS CLI** Kode berikut menghentikan klaster `sample-cluster`. Klaster harus memiliki satu atau beberapa instans dalam keadaan tersedia. Untuk Linux, macOS, atau Unix: ``` aws docdb stop-db-cluster \ --db-cluster-identifier sample-cluster ``` Untuk Windows: ``` aws docdb stop-db-cluster ^ --db-cluster-identifier sample-cluster ``` **Example — Untuk memulai cluster menggunakan AWS CLI** Kode berikut memulai klaster `sample-cluster`. Klaster saat ini harus dihentikan. Untuk Linux, macOS, atau Unix: ``` aws docdb start-db-cluster \ --db-cluster-identifier sample-cluster ``` Untuk Windows: ``` aws docdb start-db-cluster ^ --db-cluster-identifier sample-cluster ``` ------ ## Operasi yang dapat Anda lakukan pada cluster yang dihentikan Saat klaster Amazon DocumentDB dihentikan, Anda dapat melakukan point-in-time pemulihan ke titik mana pun dalam jendela retensi cadangan otomatis yang Anda tentukan. Untuk detail tentang melakukan point-in-time pemulihan, lihat[Memulihkan ke titik waktu](backup_restore-point_in_time_recovery.md). Anda tidak dapat memodifikasi konfigurasi klaster Amazon DocumentDB, atau salah satu instansnya saat klaster dihentikan. Anda juga tidak dapat menambahkan atau menghapus instans dari klaster, atau menghapus klaster tersebut jika masih memiliki instans terkait. Anda harus memulai klaster sebelum melakukan tindakan administratif tersebut. Amazon DocumentDB menerapkan pemeliharaan terjadwal pada klaster yang dihentikan hanya setelah dimulai lagi. Setelah tujuh hari, Amazon DocumentDB secara otomatis memulai klaster yang telah dihentikan sehingga tidak jauh tertinggal dalam status pemeliharaan. Ketika klaster dinyalakan kembali, Anda akan mulai kembali dikenakan biaya untuk instans dalam klaster. Sementara klaster dihentikan, Amazon DocumentDB tidak melakukan backup otomatis atau memperpanjang periode retensi cadangan. # Menghapus cluster Amazon DocumentDB Anda dapat menghapus cluster Amazon DocumentDB menggunakan Konsol Manajemen AWS atau file. AWS CLI Untuk menghapus sebuah klaster, klaster harus dalam kondisi *tersedia* dan tidak harus memiliki instans apa pun yang terkait dengannya. Jika klaster berhenti, pertama mulai klaster, tunggu sampai klaster *tersedia*, kemudian hapus klaster tersebut. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md). ## Perlindungan penghapusan Untuk melindungi klaster Anda dari penghapusan tidak disengaja, Anda dapat mengaktifkan *perlindungan penghapusan*. Perlindungan penghapusan diaktifkan secara default ketika Anda membuat klaster dengan menggunakan konsol. Namun, perlindungan penghapusan dinonaktifkan secara default jika Anda membuat klaster menggunakan AWS CLI. Amazon DocumentDB memberlakukan perlindungan penghapusan untuk klaster, tidak soal apakah Anda melakukan operasi hapus dengan menggunakan konsol atau AWS CLI. Jika perlindungan penghapusan diaktifkan, Anda tidak dapat menghapus klaster. Untuk menghapus klaster yang mengaktifkan perlindungan penghapusan, Anda harus terlebih dahulu mengubah klaster dan menonaktifkan perlindungan penghapusan. Saat menggunakan konsol dengan perlindungan penghapusan yang diaktifkan di sebuah klaster, Anda tidak dapat menghapus instans terakhir pada klaster karena hal itu juga akan menghapus klaster. Anda dapat menghapus instans terakhir dari klaster dengan perlindungan penghapusan menggunakan AWS CLI. Namun, klaster itu sendiri masih ada, dan data Anda disimpan. Anda dapat mengakses data dengan membuat instans baru untuk klaster. Untuk informasi selengkapnya tentang mengaktifkan dan menonaktifkan perlindungan penghapusan, lihat: + [Membuat cluster Amazon DocumentDB](db-cluster-create.md) + [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md) ------ #### [ Using the Konsol Manajemen AWS ] Untuk menghapus cluster menggunakan Konsol Manajemen AWS, perlindungan penghapusan harus dinonaktifkan. **Untuk menentukan apakah sebuah klaster memiliki perlindungan penghapusan yang diaktifkan:** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Perhatikan bahwa di kotak navigasi Cluster, kolom **pengenal Cluster menunjukkan cluster** dan instance. Instans tercantum di bawah klaster, mirip dengan tangkapan layar di bawah ini. ![\[Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/clusters.png) 1. Pilih nama klaster, dan pilih tab **Konfigurasi**. Di bagian **Detail klaster**, temukan **Perlindungan penghapusan**. Jika perlindungan penghapusan diaktifkan, modifikasi klaster untuk menonaktifkan perlindungan penghapusan. Untuk informasi tentang memodifikasi klaster, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). Setelah **Perlindungan penghapusan** dinonaktifkan, Anda siap untuk menghapus klaster. **Untuk menghapus klaster:** 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Tentukan apakah cluster memiliki instance dengan memeriksa kolom **pengidentifikasi Cluster** untuk contoh yang tercantum di bawahnya. Sebelum dapat menghapus klaster, Anda harus menghapus semua instans. Untuk informasi selengkapnya, lihat [Menghapus instans Amazon DocumentDB](db-instance-delete.md). 1. Tergantung pada apakah klaster Anda memiliki instans, lakukan salah satu langkah berikut. + Jika klaster tidak memiliki instans, pilih tombol di sebelah kiri nama klaster dan pilih **Tindakan**. Dari menu pilihan menurun, pilih **Hapus**. Lengkapi kotak dialog **Hapus **, lalu pilih **Hapus**. + Jika klaster memiliki satu atau beberapa instans, lakukan hal berikut: 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Hapus setiap instance cluster dengan memilih kotak centang di sebelah kiri nama cluster. Pilih **Tindakan**, lalu pilih **Hapus**. Lengkapi kotak dialog **Hapus **, lalu pilih **Hapus**. Ketika Anda menghapus contoh terakhir, cluster juga akan dihapus. Untuk informasi selengkapnya tentang menghapus instance, lihat. [Menghapus instans Amazon DocumentDB](db-instance-delete.md) Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md). ------ #### [ Using the AWS CLI ] Anda tidak dapat menghapus klaster yang memiliki instans yang berhubungan dengan itu. Untuk menentukan instans mana yang terkait dengan klaster Anda, jalankan perintah `describe-db-clusters` dan hapus semua instans klaster. Kemudian, jika diperlukan, nonaktifkan perlindungan penghapusan pada klaster Anda, dan terakhir, hapus klaster. 1. **Pertama, hapus semua instance cluster.** Untuk menentukan instans mana yang perlu Anda hapus, jalankan perintah berikut. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` Jika klaster yang Anda ingin hapus memiliki suatu instans, hapuslah dengan cara yang ditunjukkan di bawah ini. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance ``` 1. **Kedua, nonaktifkan perlindungan penghapusan.** Menggunakan AWS CLI untuk menghapus semua instance cluster tidak menghapus cluster. Anda juga harus menghapus klaster, tetapi Anda dapat melakukan ini hanya jika perlindungan penghapusan dinonaktifkan. Untuk menentukan apakah klaster memiliki perlindungan penghapusan yang diaktifkan, jalankan perintah berikut. **Tip** Untuk melihat status perlindungan penghapusan di seluruh klaster Amazon DocumentDB Anda, hilangkan parameter `--db-cluster-identifier`. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]' ``` Output dari operasi ini terlihat seperti berikut ini. ``` [ [ "sample-cluster", "true" ] ] ``` Jika klaster memiliki perlindungan penghapusan yang diaktifkan, modifikasi klaster dan nonaktifkan perlindungan penghapusan. Untuk menonaktifkan perlindungan penghapusan pada klaster, jalankan perintah berikut. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --no-deletion-protection \ --apply-immediately ``` 1. **Akhirnya, hapus cluster.** Setelah perlindungan penghapusan dinonaktifkan, Anda siap untuk menghapus klaster. Untuk menghapus klaster, gunakan operasi `delete-db-cluster` dengan parameter berikut. + **--db-cluster-identifier**—Diperlukan. Pengenal klaster yang ingin Anda hapus. + **--final-db-snapshot-identifier**—Opsional. Jika Anda ingin snapshot akhir, Anda harus menyertakan parameter ini dengan nama untuk snapshot akhir. Anda harus menyertakan `--final-db-snapshot-identifier` atau `--skip-final-snapshot`. Aturan penamaan: + Panjangnya adalah [1—63] huruf, angka, atau tanda hubung. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. + Harus unik untuk semua cluster di Amazon RDS, Amazon Neptune, dan Amazon DocumentDB per, per Wilayah. Akun AWS + **--skip-final-snapshot**—Opsional. Gunakan parameter ini hanya jika Anda tidak ingin mengambil snapshot akhir sebelum menghapus klaster Anda. Pengaturan default adalah untuk mengambil snapshot akhir. Anda harus menyertakan `--final-db-snapshot-identifier` atau `--skip-final-snapshot`. AWS CLI Kode berikut menghapus cluster `sample-cluster` dengan snapshot akhir. Operasi gagal jika ada setiap instans yang terkait dengan klaster atau jika perlindungan penghapusan diaktifkan. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-final-snapshot ``` Untuk Windows: ``` aws docdb delete-db-cluster ^ --db-cluster-identifier sample-cluster ^ --final-db-snapshot-identifier sample-cluster-final-snapshot ``` **Example** AWS CLI Kode berikut menghapus cluster `sample-cluster` tanpa mengambil snapshot akhir. Untuk Linux, macOS, atau Unix: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` Untuk Windows: ``` aws docdb delete-db-cluster ^ --db-cluster-identifier sample-cluster ^ --skip-final-snapshot ``` Output dari operasi `delete-db-cluster` adalah klaster Anda akan Anda hapus. Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat [Memantau status klaster](monitoring_docdb-cluster_status.md). ------ # Menskalakan cluster Amazon DocumentDB Amazon DocumentDB memungkinkan Anda untuk menskalakan penyimpanan dan melakukan komputasi dalam klaster Anda berdasarkan kebutuhan Anda. Bagian ini menjelaskan bagaimana Anda dapat menggunakan penskalaan untuk penyimpanan, penskalaan untuk instans, dan penskalaan untuk pembacaan guna mengelola performa dan penskalaan untuk klaster dan instans Amazon DocumentDB. **Topics** + [Penskalaan penyimpanan](#db-cluster-manage-scaling-storage) + [Penskalaan instans](#db-cluster-manage-scaling-instance) + [Penskalaan baca](#db-cluster-manage-scaling-reads) + [Tulis penskalaan](#db-cluster-manage-scaling-writes) ## Penskalaan penyimpanan Penyimpanan Amazon DocumentDB secara otomatis diskalakan dengan data dalam volume klaster Anda. Seiring pertumbuhan data Anda, penyimpanan volume cluster Anda tumbuh dalam peningkatan 10 GiB, hingga 128 TiB. ## Penskalaan instans Anda dapat menskalakan klaster Amazon DocumentDB sesuai kebutuhan dengan memodifikasi kelas instans untuk setiap instans dalam klaster. Amazon DocumentDB mendukung beberapa kelas instans yang dioptimalkan untuk Amazon DocumentDB. Untuk informasi selengkapnya, lihat [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md). ## Penskalaan baca Anda dapat mencapai penskalaan baca untuk klaster Amazon DocumentDB dengan membuat hingga 15 replika Amazon DocumentDB dalam klaster. Setiap replika Amazon DocumentDB menghasilkan data yang sama dari volume klaster dengan sedikit penundaan replika—biasanya kurang dari 100 milidetik setelah instans utama menulis pembaruan. Saat lalu lintas baca meningkat, Anda dapat membuat replika Amazon DocumentDB tambahan dan terhubung langsung ke sana untuk mendistribusikan beban baca pada klaster Anda. Replika Amazon DocumentDB tidak harus dari kelas instans DB yang sama dengan instans utama. Untuk informasi selengkapnya, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md). Untuk membaca penskalaan dengan Amazon DocumentDB, Anda sebaiknya membuat sambungan ke klaster Anda sebagai set replika dan mendistribusikan pembacaan ke instans replika menggunakan kemampuan preferensi baca bawaan driver Anda. Untuk informasi selengkapnya, lihat [Menghubungkan ke Amazon DocumentDB sebagai set replika](connect-to-replica-set.md). ## Tulis penskalaan Anda dapat menskalakan kapasitas tulis pada klaster Amazon DocumentDB Anda dengan meningkatkan ukuran instans utama klaster Anda. Bagian ini menyediakan dua metode untuk menskalakan instans utama klaster Anda berdasarkan kebutuhan. Opsi pertama berupaya meminimalkan dampak aplikasi tetapi membutuhkan lebih banyak langkah untuk menyelesaikannya. Opsi kedua mengoptimalkan kesederhanaan karena memiliki langkah yang lebih sedikit, tetapi dilengkapi dengan tradeoff yang memiliki dampak yang lebih potensial untuk aplikasi Anda. Bergantung pada aplikasi Anda, Anda bisa memilih pendekatan apa di bawah ini yang terbaik untuk Anda. Untuk informasi selengkapnya tentang ukuran dan biaya instans yang tersedia, lihat halaman [Harga Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/). 1. **Optimalkan ketersediaan dan performa tinggi** — Jika Anda terhubung ke klaster Anda di [mode set replika](connect-to-replica-set.md) (disarankan), Anda dapat menggunakan proses berikut untuk meminimalkan dampak aplikasi Anda saat menskalakan instans primer Anda. Metode ini meminimalkan dampak karena mempertahankan klaster Anda pada atau di atas ketersediaan tinggi Anda, dan target penskalaan baca ditambahkan ke klaster sebagai instans, alih-alih diperbarui pada tempatnya. 1. Tambahkan satu atau beberapa replika dari jenis instans yang lebih besar ke klaster Anda (lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md)). Semua replika sebaiknya memiliki jenis instans yang sama dengan atau lebih besar dari yang utama. Hal ini untuk menghindari pengurangan yang tidak disengaja dalam performa tulis akibat kegagalan terhadap jenis instans yang lebih kecil. Untuk sebagian besar pelanggan, ini berarti penggandaan jumlah instans sementara di klaster mereka, kemudian penghapusan replika yang lebih kecil setelah penskalaan selesai. 1. Atur tingkat failover pada semua replika baru ke prioritas nol, hal ini memastikan replika jenis instans yang lebih kecil memiliki prioritas failover tertinggi. Untuk informasi selengkapnya, lihat [Mengontrol target failover](failover.md#failover-target_control). 1. Memulai failover manual, yang akan mempromosikan salah satu replika baru menjadi instans utama. Untuk informasi selengkapnya, lihat [Menguji failover](failover.md#failover-testing). **catatan** Ini akan menimbulkan \$130 detik waktu henti untuk klaster Anda. Silakan buat rencana yang sesuai. 1. Hapus semua replika dengan jenis instans yang lebih kecil daripada intans utama baru Anda dari klaster. 1. Kembalikan tingkat failover semua intans ke prioritas yang sama (biasanya, ini berarti pengaturan kembali ke 1). Sebagai contoh, anggaplah Anda memiliki klaster yang saat ini berisi tiga instans `r5.large` (satu primer dan dua replika), dan Anda ingin melakukan penskalaan ke tipe instans `r5.xlarge`. Untuk melakukannya, pertama Anda akan menambahkan tiga instans replika `r5.xlarge` ke klaster Anda, lalu tetapkan tingkat failover replika `r5.xlarge` baru ke nol. Selanjutnya, Anda akan memulai failover manual (diketahui bahwa aplikasi Anda akan mengalami \$1 30 detik waktu henti). Setelah failover selesai, Anda akan menghapus ketiga instans `r5.large` dari klaster Anda, sehingga klaster tersebut diskalakan ke instans `r5.xlarge`. Untuk membantu mengoptimalkan biaya, instans Amazon DocumentDB ditagih dalam kenaikan satu detik, dengan biaya minimum sepuluh menit setelah perubahan status yang dapat ditagih seperti membuat, memodifikasi, atau menghapus instans. Untuk informasi selengkapnya lihat [Optimalisasi biaya](best_practices.md#best_practices-cost_optimization) dalam dokumentasi praktik terbaik. 1. **Optimalisasi untuk kesederhanaan** — Pendekatan ini dioptimalkan untuk menyederhanakan prosesnya. Cara ini tidak memperluas dan menyempitkan klaster, tetapi mungkin mengurangi kapasitas baca Anda untuk sementara. Ada kemungkinan bahwa mengubah kelas instans replika akan menghasilkan instans yang tidak melayani permintaan untuk jangka waktu singkat, dari beberapa detik hingga kurang dari 30 detik. Jika Anda terhubung ke klaster Anda di [mode set replika](connect-to-replica-set.md) (direkomendasikan), maka ini akan mengurangi kapasitas baca Anda pada satu replika (misalnya, untuk 66% kapasitas dalam klaster 3-node, atau 75% kapasitas dalam klaster 4-node, dll) selama operasi penskalaan. 1. Skalakan salah satu contoh instans di klaster Anda. Untuk informasi selengkapnya, lihat [Mengelola kelas instance](db-instance-classes.md). 1. Tunggu sampai instans tersedia (lihat[Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md)). **catatan** Ini akan menimbulkan \$130 detik waktu henti untuk klaster Anda. Silakan buat rencana yang sesuai. 1. Lanjutkan menjalankan langkah 1 dan 2 sampai semua instans replika telah diskalakan, satu per satu. 1. Memulai failover manual. Ini akan mempromosikan salah satu replika menjadi instans utama. Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md). **catatan** Tindakan ini akan menyebabkan waktu henti hingga 30 detik untuk klaster Anda, tetapi seringkali membutuhkan waktu lebih singkat. Silakan buat rencana yang sesuai. 1. Skalakan instans primer sebelumnya (sekarang replika). # Mengkloning volume untuk cluster Amazon DocumentDB Dengan menggunakan kloning Amazon DocumentDB, Anda dapat membuat cluster baru yang menggunakan volume cluster Amazon DocumentDB yang sama dan memiliki data yang sama dengan aslinya. Prosesnya dirancang agar cepat dan hemat biaya. Klaster baru dengan volume data terkaitnya dikenal sebagai *Klon*. Membuat klon lebih cepat dan lebih hemat ruang daripada menyalin data secara fisik menggunakan teknik lain, seperti memulihkan snapshot. Amazon DocumentDB mendukung pembuatan klon yang disediakan Amazon DocumentDB dari klaster Amazon DocumentDB yang disediakan. Saat Anda membuat klon menggunakan konfigurasi penyebaran yang berbeda dari sumbernya, klon dibuat menggunakan versi terbaru dari mesin Amazon DocumentDB sumber. Saat Anda membuat klon dari kluster Amazon DocumentDB Anda, klon dibuat AWS di akun Anda—akun yang sama yang memiliki cluster Amazon DocumentDB sumber. **Topics** + [Ikhtisar kloning Amazon DocumentDB](#db-cloning-overview) + [Keterbatasan kloning Amazon DocumentDB](#db-cloning-limitations) + [Cara kerja kloning Amazon DocumentDB](#db-how-db-cloning-works) + [Membuat klon Amazon DocumentDB](#db-creating-db-clone) ## Ikhtisar kloning Amazon DocumentDB Amazon DocumentDB menggunakan protokol untuk *copy-on-write membuat klon*. Mekanisme ini menggunakan ruang tambahan minimal untuk membuat klon awal. Saat klon pertama kali dibuat, Amazon DocumentDB menyimpan satu salinan data yang digunakan oleh cluster DB sumber dan cluster Amazon DocumentDB baru (kloning). Penyimpanan tambahan dialokasikan hanya ketika perubahan dilakukan pada data (pada volume penyimpanan Amazon DocumentDB) oleh cluster Amazon DocumentDB sumber atau klon klon Amazon DocumentDB. Untuk mempelajari lebih lanjut tentang copy-on-write protokol, lihat[Cara kerja kloning Amazon DocumentDB](#db-how-db-cloning-works). Kloning Amazon DocumentDB sangat berguna untuk menyiapkan lingkungan pengujian dengan cepat menggunakan data produksi Anda, tanpa risiko kerusakan data. Anda dapat menggunakan klon untuk berbagai jenis aplikasi, seperti berikut: + Bereksperimen dengan potensi perubahan (misalnya, perubahan skema dan perubahan grup parameter) untuk menilai semua dampak. + Menjalankan operasi sarat beban kerja, seperti mengekspor data atau menjalankan kueri analitis. + Membuat salinan dari klaster DB produksi Anda untuk pengembangan, pengujian, atau tujuan lainnya. Anda dapat membuat lebih dari satu klon dari cluster Amazon DocumentDB yang sama. Anda juga dapat membuat beberapa klon dari klon lain. Setelah membuat klon Amazon DocumentDB, Anda dapat mengonfigurasi instans Amazon DocumentDB secara berbeda dari cluster Amazon DocumentDB sumber. Misalnya, Anda mungkin tidak memerlukan klon untuk tujuan pengembangan agar memenuhi persyaratan ketersediaan tinggi yang sama dengan klaster Amazon DocumentDB produksi sumber. Dalam hal ini, Anda dapat mengonfigurasi klon dengan satu instans Amazon DocumentDB daripada beberapa instans DB yang digunakan oleh cluster Amazon DocumentDB. Setelah selesai menggunakan klon untuk pengujian, pengembangan, atau tujuan lainnya, Anda dapat menghapusnya. ## Keterbatasan kloning Amazon DocumentDB Amazon DocumentDB; kloning saat ini memiliki batasan sebagai berikut: + Anda dapat membuat klon sebanyak yang Anda inginkan, hingga jumlah maksimum klaster DB yang diizinkan di Wilayah AWS. Namun, setelah Anda membuat 15 klon, klon berikutnya adalah salinan lengkap. Operasi kloning bertindak seperti point-in-time pemulihan. + Anda tidak dapat membuat klon di AWS Wilayah yang berbeda dari cluster Amazon DocumentDB sumber. + Anda tidak dapat membuat klon dari cluster Amazon DocumentDB yang tidak memiliki instans DB. Anda hanya dapat mengkloning cluster Amazon DocumentDB yang memiliki setidaknya satu instans DB. + Anda dapat membuat klon di cloud pribadi virtual (VPC) yang berbeda dari klaster Amazon DocumentDB. Jika Anda melakukannya, subnet VPCs harus dipetakan ke Availability Zones yang sama. ## Cara kerja kloning Amazon DocumentDB Kloning Amazon DocumentDB bekerja pada lapisan penyimpanan cluster Amazon DocumentDB. Ini menggunakan *copy-on-write*protokol yang cepat dan hemat ruang dalam hal media tahan lama yang mendasarinya yang mendukung volume penyimpanan Amazon DocumentDB. Anda dapat mempelajari lebih lanjut tentang volume klaster Amazon DocumentDB di. [Mengelola cluster Amazon DocumentDB](db-clusters.md) **Topics** + [Memahami copy-on-write protokol](#db-copy-on-write-protocol) + [Menghapus volume klaster sumber](#db-deleting-source-cluster-volume) ### Memahami copy-on-write protokol Cluster Amazon DocumentDB menyimpan data di halaman dalam volume penyimpanan Amazon DocumentDB yang mendasarinya. Misalnya, dalam diagram berikut Anda dapat menemukan cluster Amazon DocumentDB (A) yang memiliki empat halaman data, 1, 2, 3, dan 4. Bayangkan bahwa klon, B, dibuat dari cluster Amazon DocumentDB. Saat klon dibuat, tidak ada data yang disalin. Sebaliknya, klon menunjuk ke kumpulan halaman yang sama dengan cluster Amazon DocumentDB sumber. ![\[Volume cluster Amazon DocumentDB dengan 4 halaman untuk cluster sumber, A, dan klon, B\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png) Saat klon dibuat, tidak ada penyimpanan tambahan yang biasanya diperlukan. copy-on-writeProtokol menggunakan segmen yang sama pada media penyimpanan fisik sebagai segmen sumber. Penyimpanan tambahan hanya diperlukan jika kapasitas segmen sumber tidak cukup untuk seluruh segmen klon. Jika demikian, segmen sumber disalin ke perangkat fisik lain. Dalam diagram berikut, Anda dapat menemukan contoh copy-on-write protokol yang sedang beraksi menggunakan cluster A yang sama dan klonnya, B, seperti yang ditunjukkan sebelumnya. Katakanlah Anda membuat perubahan pada klaster Amazon DocumentDB (A) yang menghasilkan perubahan pada data yang disimpan di halaman 1. Alih-alih menulis ke halaman asli 1, Amazon DocumentDB membuat halaman baru 1 [A]. Volume cluster Amazon DocumentDB untuk cluster (A) sekarang menunjuk ke halaman 1 [A], 2, 3, dan 4, sedangkan klon (B) masih mereferensikan halaman asli. ![\[Volume cluster DB sumber Amazon DocumentDB dan klonnya, keduanya dengan perubahan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png) Pada klon, perubahan dibuat pada halaman 4 di volume penyimpanan. Alih-alih menulis ke halaman asli 4, Amazon DocumentDB membuat halaman baru, 4 [B]. Klon sekarang menunjuk ke halaman 1, 2, 3, dan halaman 4[B], sementara klaster (A) terus menunjuk ke 1[A], 2, 3, dan 4. ![\[Volume cluster DB sumber Amazon DocumentDB dan klonnya, keduanya dengan perubahan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png) Karena semakin banyak perubahan terjadi dari waktu ke waktu di volume cluster Amazon DocumentDB sumber dan klon, lebih banyak penyimpanan diperlukan untuk menangkap dan menyimpan perubahan. ### Menghapus volume klaster sumber Saat Anda menghapus volume klaster sumber yang memiliki satu atau beberapa klon yang berkaitan dengannya, klon ini tidak akan terpengaruh. Klon terus menunjuk ke halaman yang sebelumnya dimiliki oleh volume klaster sumber. ## Membuat klon Amazon DocumentDB Anda dapat membuat klon di AWS akun yang sama dengan cluster Amazon DocumentDB sumber. Untuk melakukannya, Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI dan prosedur berikut. Dengan menggunakan kloning Amazon DocumentDB, Anda dapat membuat klon klon Amazon DocumentDB yang disediakan dari klon Amazon DocumentDB yang disediakan. ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut menjelaskan cara mengkloning cluster Amazon DocumentDB menggunakan. Konsol Manajemen AWS Membuat klon menggunakan Konsol Manajemen AWS hasil di cluster Amazon DocumentDB dengan satu instance Amazon DocumentDB. Instruksi ini berlaku untuk cluster DB yang dimiliki oleh AWS akun yang sama yang membuat klon. Cluster DB harus dimiliki oleh AWS akun yang sama karena kloning lintas akun tidak didukung di Amazon DocumentDB. **Untuk membuat tiruan dari cluster DB yang dimiliki oleh AWS akun Anda menggunakan Konsol Manajemen AWS** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. **Pilih klaster Amazon DocumentDB Anda dari daftar, dan **untuk** Tindakan, pilih Buat klon.** ![\[Membuat klon dimulai dengan memilih klaster Amazon DocumentDB Anda.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png) Halaman Create clone terbuka, di mana Anda dapat mengonfigurasi **pengenal Cluster** dan **kelas Instance**, dan opsi lain untuk klon klon Amazon DocumentDB. 1. Di bagian **Pengaturan**, lakukan hal berikut: 1. Untuk **pengidentifikasi Cluster**, masukkan nama yang ingin Anda berikan ke klaster Amazon DocumentDB kloning Anda. 1. Untuk **konfigurasi Instance**, pilih **class Instance** yang sesuai untuk klaster Amazon DocumentDB kloning Anda. ![\[Membuat klon dimulai dengan memilih klaster Amazon DocumentDB Anda dan menentukan ukuran instans DB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png) 1. Untuk **pengaturan Jaringan**, pilih **grup Subnet** untuk kasus penggunaan Anda dan grup keamanan VPC terkait. 1. Untuk **E ncryption-at-rest**, jika cluster sumber (cluster yang sedang dikloning) mengaktifkan enkripsi, klaster kloning juga harus mengaktifkan enkripsi. Jika skenario ini benar, maka opsi **Enable encryption** berwarna abu-abu (dinonaktifkan) tetapi dengan pilihan **Enable encryption** yang dipilih. Sebaliknya, jika cluster sumber tidak mengaktifkan enkripsi, opsi **Enable encryption** tersedia dan Anda dapat memilih untuk mengaktifkan atau menonaktifkan enkripsi. ![\[Tentukan pengaturan jaringan dan enkripsi untuk klon klon Amazon DocumentDB Anda.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png) 1. Selesaikan konfigurasi klon cluster baru dengan memilih jenis log yang akan diekspor (opsional), memasukkan port tertentu yang digunakan untuk terhubung ke cluster, dan mengaktifkan perlindungan dari penghapusan cluster secara tidak sengaja (diaktifkan secara default). ![\[Selesaikan konfigurasi klon baru dengan memilih jenis log yang akan diekspor secara opsional, port tertentu yang digunakan untuk terhubung ke cluster, dan formulir perlindungan secara tidak sengaja menghapus cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png) 1. Selesai memasukkan semua pengaturan untuk klon klon Amazon DocumentDB Anda. Untuk mempelajari selengkapnya tentang setelan cluster dan instans Amazon DocumentDB, lihat. [Mengelola cluster Amazon DocumentDB](db-clusters.md) 1. Pilih **Buat klon untuk meluncurkan klon** Amazon DocumentDB dari klaster Amazon DocumentDB pilihan Anda. Saat klon dibuat, klon tersebut terdaftar dengan kluster Amazon DocumentDB Anda yang lain di **bagian** Database konsol dan menampilkan statusnya saat ini. Klon Anda siap digunakan ketika statusnya **Tersedia**. ------ #### [ Using the AWS CLI ] Menggunakan AWS CLI untuk mengkloning cluster Amazon DocumentDB Anda melibatkan beberapa langkah. `restore-db-cluster-to-point-in-time` AWS CLI Perintah yang Anda gunakan menghasilkan klaster Amazon DocumentDB kosong dengan 0 instance Amazon DocumentDB. Artinya, perintah hanya mengembalikan cluster Amazon DocumentDB, bukan instance DB untuk cluster itu. Anda melakukannya secara terpisah setelah klon tersedia. Dua langkah dalam proses ini adalah sebagai berikut: 1. Buat klon dengan menggunakan perintah [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. Parameter yang Anda gunakan dengan perintah ini mengontrol jenis kapasitas dan detail lain dari klaster Amazon DocumentDB kosong (klon) yang sedang dibuat. 1. Buat instance Amazon DocumentDB untuk klon dengan menggunakan perintah [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI untuk membuat ulang instans Amazon DocumentDB di cluster Amazon DocumentDB yang dipulihkan. Perintah berikut mengasumsikan bahwa AWS CLI diatur dengan AWS Wilayah Anda sebagai default. Dengan pendekatan ini, Anda tidak perlu meneruskan nama `--region` di setiap perintah. Untuk informasi selengkapnya, lihat [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Anda juga dapat menentukan `--region` di setiap perintah CLI selanjutnya. **Topics** **Membuat klon** Parameter tertentu yang Anda teruskan ke perintah CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` akan bervariasi. Apa yang Anda lewati tergantung pada jenis klon yang ingin Anda buat. Gunakan prosedur berikut untuk membuat klon Amazon DocumentDB yang disediakan dari klaster Amazon DocumentDB yang disediakan. **Untuk membuat tiruan dari mode mesin yang sama dengan sumber cluster Amazon DocumentDB** + Gunakan perintah CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` dan tentukan nilai untuk parameter berikut: + `--db-cluster-identifier` – Pilih nama yang bermakna untuk klon anda. Anda memberi nama klon saat Anda menggunakan perintah [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. + `--restore-type` – Gunakan `copy-on-write` untuk membuat klon dari klaster DB sumber. Tanpa parameter ini, `restore-db-cluster-to-point-in-time` mengembalikan cluster Amazon DocumentDB daripada membuat klon. Default untuk `restore-type` adalah`full-copy`. + `--source-db-cluster-identifier`— Gunakan nama cluster Amazon DocumentDB sumber yang ingin Anda kloning. + `--use-latest-restorable-time` – Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon. Parameter ini diperlukan untuk`restore-type copy-on-write`, bagaimanapun, Anda tidak dapat menggunakan `restore-to-time parameter` dengan itu. Contoh berikut membuat klon bernama `my-clone` dari klaster bernama `my-source-cluster`. Untuk Linux, macOS, atau Unix: ``` aws docdb restore-db-cluster-to-point-in-time \ --source-db-cluster-identifier my-source-cluster \ --db-cluster-identifier my-clone \ --restore-type copy-on-write \ --use-latest-restorable-time ``` Untuk Windows: ``` aws docdb restore-db-cluster-to-point-in-time ^ --source-db-cluster-identifier my-source-cluster ^ --db-cluster-identifier my-clone ^ --restore-type copy-on-write ^ --use-latest-restorable-time ``` Perintah tersebut mengembalikan objek JSON yang berisi rincian dari klon. Periksa untuk memastikan bahwa klaster DB yang Anda kloning tersedia sebelum mencoba membuat instans DB untuk klon Anda. Untuk informasi selengkapnya, lihat Memeriksa status dan mendapatkan detail klon di bawah ini: **Memeriksa status dan mendapatkan detail klon** Anda dapat menggunakan perintah berikut untuk memeriksa status klaster DB kosong yang baru dibuat. ``` $ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text ``` Atau Anda dapat memperoleh status dan nilai-nilai lain yang Anda butuhkan untuk membuat instance DB untuk klon Anda dengan menggunakan AWS CLI kueri berikut: Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters --db-cluster-identifier my-clone \ --query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}' ``` Untuk Windows: ``` aws docdb describe-db-clusters --db-cluster-identifier my-clone ^ --query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}" ``` Kueri ini menghasilkan output yang serupa dengan berikut ini: ``` [ { "Status": "available", "Engine": "docdb", "EngineVersion": "4.0.0", } ] ``` **Membuat instance Amazon DocumentDB untuk klon Anda** Gunakan perintah [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI untuk membuat instance DB untuk klon Anda. `--db-instance-class`Parameter ini digunakan hanya untuk klaster Amazon DocumentDB yang disediakan. Untuk Linux, macOS, atau Unix: ``` aws docdb create-db-instance \ --db-instance-identifier my-new-db \ --db-cluster-identifier my-clone \ --db-instance-class db.r5.4xlarge \ --engine docdb ``` Untuk Windows: ``` aws docdb create-db-instance ^ --db-instance-identifier my-new-db ^ --db-cluster-identifier my-clone ^ --db-instance-class db.r5.4xlarge ^ --engine docdb ``` **Parameter yang akan digunakan untuk kloning** Tabel berikut merangkum berbagai parameter yang digunakan `restore-db-cluster-to-point-in-time` untuk mengkloning cluster Amazon DocumentDB. | Parameter | Deskripsi | | --- | --- | | --source-db-cluster-identifier | Gunakan nama cluster Amazon DocumentDB sumber yang ingin Anda kloning. | | --db-cluster-identifier | Gunakan parameter ini untuk memilih nama yang bermakna untuk klon anda. Anda menamai klon Anda dengan perintah ` restore-db-cluster-to-point-in-time`. Kemudian, Anda meneruskan nama ini ke perintah `create-db-instance`. | | --restore-type | Tentukan `copy-on-write` sebagai `--restore-type` untuk membuat klon dari cluster DB sumber daripada memulihkan sumber Amazon DocumentDB cluster. | | --use-latest-restorable-time | Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon. | ------ # Memahami toleransi kesalahan klaster Amazon DocumentDB Klaster Amazon DocumentDB menurut desainnya toleran terhadap kesalahan. Setiap volume klaster mencakup beberapa Availability Zone dalam satu Wilayah AWS, dan setiap Availability Zone berisi salinan data volume cluster. Dengan fungsionalitas ini, klaster Anda dapat menoleransi kegagalan Availability Zone tanpa kehilangan data dan hanya gangguan layanan singkat. Jika instans utama dalam sebuah klaster gagal, Amazon DocumentDB secara otomatis melakukan failover ke instans utama baru dengan salah satu dari dua cara berikut: + Dengan mempromosikan replika Amazon DocumentDB yang ada ke instans utama baru yang dipilih berdasarkan pengaturan Tingkat Promosi dari setiap replika, lalu membuat pengganti untuk instans primer sebelumnya. Failover untuk instans replika biasanya membutuhkan waktu kurang dari 30 detik. Operasi baca dan tulis mungkin mengalami gangguan singkat selama periode ini. Untuk meningkatkan ketersediaan klaster Anda, kami sarankan Anda membuat setidaknya satu replika Amazon DocumentDB atau lebih di dua Availability Zone yang berbeda. + Dengan membuat instans primer baru. Ini hanya terjadi jika Anda tidak memiliki instans replika di klaster Anda dan penyelesaiannya dapat memakan waktu beberapa menit. Jika klaster memiliki satu atau beberapa replika Amazon DocumentDB, replika Amazon DocumentDB akan dipromosikan ke instans primer selama peristiwa kegagalan. Peristiwa failover mengakibatkan interupsi singkat, selama operasi baca dan tulis gagal dengan pengecualian. Namun, layanan biasanya dipulihkan dalam waktu kurang dari 120 detik, dan sering kali kurang dari 60 detik. Untuk meningkatkan ketersediaan klaster Anda, kami sarankan Anda membuat setidaknya satu replika Amazon DocumentDB atau lebih di dua Availability Zone yang berbeda. Anda dapat membuat urutan tertentu agar replika Amazon DocumentDB Anda dipromosikan ke instans primer setelah kegagalan dengan menetapkan prioritas pada setiap replika. Prioritas berkisar dari 0 untuk prioritas tertinggi hingga 15 untuk prioritas terendah. Jika instans primer gagal, replika Amazon DocumentDB dengan prioritas tertinggi akan dipromosikan ke instans primer baru. Anda dapat mengubah prioritas replika Amazon DocumentDB kapan saja. Memodifikasi prioritas tidak memicu failover. Anda dapat menggunakan operasi `modify-db-instance` dengan parameter `--promotion-tier`. Untuk informasi lebih lanjut tentang menyesuaikan prioritas failover instans, lihat [Failover Amazon DocumentDB](failover.md). Lebih dari satu replika Amazon DocumentDB dapat berbagi prioritas yang sama, dan menghasilkan tingkat promosi. Jika dua replika Amazon DocumentDB atau lebih berbagi prioritas yang sama, maka replika dengan ukuran terbesar akan dipromosikan menjadi yang primer. Jika dua replika Amazon DocumentDB atau lebih memiliki prioritas dan ukuran yang sama, replika arbitrer di tingkat promosi yang sama akan dipromosikan. Jika klaster tidak berisi replika Amazon DocumentDB, instans primer akan dibuat ulang selama peristiwa kegagalan. Peristiwa failover mengakibatkan gangguan di mana selama operasi baca dan tulis gagal dengan pengecualian. Layanan dipulihkan ketika instans primer baru dibuat, yang biasanya memakan waktu kurang dari 10 menit. Mempromosikan replika Amazon DocumentDB ke instans utama jauh lebih cepat daripada membuat instans utama baru. # Mengelola instans Amazon DocumentDB Topik berikut memberikan informasi untuk membantu Anda mengelola instans Amazon DocumentDB Anda. Topik-topik tersebut menyertakan detail tentang kelas dan status instans, serta cara membuat, menghapus, dan memodifikasi instans. **Topics** + [Menentukan status instans](#db-instance-status) + [Siklus hidup instans](db-instance-life-cycle.md) + [Mengelola kelas instance](db-instance-classes.md) + [NVMecontoh -didukung](db-instance-nvme.md) ## Menentukan status instans Untuk melihat status instans yang valid, artinya, dan cara menentukan status instans Anda, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). # Siklus hidup instance Amazon DocumentDB Siklus hidup dari instans Amazon DocumentDB termasuk menciptakan, memodifikasi, memelihara dan meningkatkan, melakukan backup dan pemulihan, mem-boot ulang, dan menghapus instans. Bagian ini menyediakan informasi tentang cara menyelesaikan proses ini. **Topics** + [Menambahkan sebuah instance](db-instance-add.md) + [Menjelaskan contoh](db-instance-view-details.md) + [Memodifikasi sebuah instance](db-instance-modify.md) + [Mem-boot ulang sebuah instance](db-instance-reboot.md) + [Menghapus sebuah instans](db-instance-delete.md) Anda dapat membuat instance Amazon DocumentDB baru menggunakan Konsol Manajemen AWS atau. AWS CLI Untuk menambahkan instans ke klaster, klaster harus dalam status *tersedia*. Anda tidak dapat menambahkan instans ke klaster yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu sampai klaster *tersedia*, kemudian tambahkan instans. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md). **catatan** Jika Anda membuat klaster Amazon DocumentDB menggunakan konsol, sebuah instans secara otomatis dibuat untuk Anda pada saat yang sama. Jika Anda ingin membuat instans tambahan, gunakan salah satu prosedur berikut. # Menambahkan instance Amazon DocumentDB ke klaster ------ #### [ Using the Konsol Manajemen AWS ] Gunakan prosedur berikut untuk membuat instans untuk klaster Anda menggunakan konsol Amazon DocumentDB. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Untuk memilih klaster yang ingin Anda tambahi instans, pilih tombol di sebelah kiri nama klaster. 1. Pilih **Tindakan**, dan kemudian pilih **Tambahkan instans**. 1. Di halaman **Tambahkan instans ke: **, ulangi langkah berikut untuk setiap instans yang ingin Anda tambahkan ke klaster. Anda dapat memiliki hingga 15. 1. **Pengidentifikasi instans** — Anda dapat memasukkan pengidentifikasi unik untuk instans ini atau mengizinkan Amazon DocumentDB menyediakan pengidentifikasi instans berdasarkan pengidentifikasi klaster. Kendala penamaan instans: + Panjangnya adalah [1—63] huruf, angka, atau tanda hubung. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. + Harus unik untuk semua instans di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS 1. **Kelas instans** — Dari daftar tarik-turun, pilih tipe instans yang Anda inginkan untuk instans ini. 1. **Tingkat promosi** — Dari daftar tarik-turun, pilih tingkat promosi untuk instans Anda atau pilih *Tidak ada preferensi* guna mengizinkan Amazon DocumentDB untuk mengatur tingkat promosi untuk instans Anda. Angka yang lebih rendah berarti prioritas yang lebih tinggi. Untuk informasi selengkapnya, lihat [Mengontrol target failover](failover.md#failover-target_control). 1. Untuk menambahkan lebih banyak instans, pilih **Tambahkan instans tambahan** dan ulangi langkah a, b, dan c. 1. Selesaikan operasi. + Untuk menambahkan instans ke klaster Anda, pilih **Buat**. + Untuk membatalkan operasi, pilih **Batal**. Dibutuhkan beberapa menit untuk membuat sebuah instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat [Memantau status instans](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Gunakan `create-db-instance` AWS CLI operasi dengan parameter berikut untuk membuat instance utama untuk cluster Anda. + **--db-instance-class** — Diperlukan. Kapasitas komputasi dan memori instans, misalnya, `db.m4.large`. Tidak semua kelas instans tersedia di semua Wilayah AWS. + **--db-instance-identifier** — Diperlukan. Sebuah string yang mengidentifikasi instans. Kendala Penamaan Instans: + Panjangnya adalah [1—63] huruf, angka, atau tanda hubung. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. + Harus unik untuk semua instans di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS + **--engine** — Diperlukan. Harus berupa `docdb`. + **--availability-zone** — Opsional. Availability Zone tempat Anda ingin membuat instans ini. Gunakan parameter ini untuk menemukan instans Anda di Availability Zone yang berbeda untuk meningkatkan toleransi kesalahan. Untuk informasi selengkapnya, lihat [Amazon DocumentDB Ketersediaan dan replikasi tinggi](replication.md). + **--promotion-tier** — Opsional. Tingkat prioritas failover untuk instans ini. Harus antara 0 dan 15 dengan angka yang lebih rendah menjadi prioritas yang lebih tinggi. Untuk informasi selengkapnya, lihat [Mengontrol target failover](failover.md#failover-target_control). 1. **Pertama, tentukan Availability Zone tempat Anda dapat membuat instance Anda.** Jika Anda ingin menentukan Availability Zone sebelum membuat instans, jalankan perintah berikut untuk menentukan Availability Zone mana yang tersedia untuk klaster Amazon DocumentDB Anda. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]' ``` Output dari operasi ini terlihat seperti berikut. ``` [ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] ``` 1. **Kedua, tentukan kelas instance apa yang dapat Anda buat di Wilayah Anda.** Untuk menentukan kelas instans mana yang tersedia untuk Anda di Wilayah Anda, jalankan perintah berikut. Dari output, pilih kelas instans untuk instans yang ingin Anda tambahkan ke klaster Amazon DocumentDB Anda. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` Untuk Windows: ``` aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass' ``` Output dari operasi ini terlihat seperti berikut. ``` [ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] ``` 1. **Terakhir, tambahkan instance ke cluster Amazon DocumentDB Anda.** Untuk menambahkan instans ke klaster Amazon DocumentDB Anda, jalankan perintah berikut.. Untuk Linux, macOS, atau Unix: ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdb ``` Untuk Windows: ``` aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdb ``` Output dari operasi ini terlihat seperti berikut. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2" } } ``` Dibutuhkan beberapa menit untuk membuat instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Menjelaskan instans Amazon DocumentDB Anda dapat menggunakan Amazon DocumentDB Management Console atau AWS CLI untuk melihat detail seperti titik akhir koneksi, VPCs grup keamanan, otoritas sertifikat, dan grup parameter yang berkaitan dengan instans Amazon DocumentDB Anda. ------ #### [ Using the Konsol Manajemen AWS ] Untuk melihat detail instans Anda menggunakan Konsol Manajemen AWS, ikuti langkah-langkah di bawah ini. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah. ![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png) 1. Dalam daftar instans, pilih nama instans yang ingin Anda lihat detailnya. Informasi tentang instans diatur ke dalam pengelompokan berikut: + **Ringkasan** — Informasi umum tentang instans, termasuk versi mesin, kelas, status, dan setiap pemeliharaan tertunda. + **Konektivitas & Keamanan** — Bagian **Hubungkan** berisi daftar titik akhir koneksi untuk membuat sambungan ke instans ini dengan mongo shell atau dengan aplikasi. Bagian **Grup Keamanan** terdiri atas daftar grup keamanan yang terkait dengan instans ini dan ID VPC serta deskripsinya. + **Konfigurasi** — Bagian **Detail** berisi daftar konfigurasi dan status instans, termasuk Amazon Resource Name (ARN), titik akhir, peran, kelas, dan otoritas sertifikat instans. Ini juga berisi daftar pengaturan keamanan dan jaringan, serta informasi backup instans. Bagian **Detail klaster** berisi daftar detail klaster tempat instans ini berada. Bagian **Instans klaster** berisi daftar semua instans yang dimiliki klaster Anda dengan masing-masing peran instans dan status grup parameter klaster. **catatan** Anda dapat memodifikasi klaster yang terkait dengan instans Anda dengan memilih **Modifikasi** di samping header **Detail klaster**. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). + **Monitoring** —Metrik CloudWatch Log untuk contoh ini. Untuk informasi selengkapnya, lihat [Memantau Amazon DocumentDB dengan CloudWatch](cloud_watch.md). + **Peristiwa & tag** — Bagian **Peristiwa terbaru** berisi daftar peristiwa terbaru untuk instans ini. Amazon DocumentDB menyimpan catatan peristiwa yang terkait dengan klaster, instans, snapshot, grup keamanan, dan grup parameter klaster Anda. Informasi ini mencakup tanggal, waktu, dan pesan yang terkait dengan setiap peristiwa. Bagian **Tag** berisi daftar tag yang dilampirkan ke klaster ini. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Untuk melihat detail instance Amazon DocumentDB Anda menggunakan, gunakan perintah seperti AWS CLI yang ditunjukkan pada contoh `describe-db-clusters` di bawah ini. Untuk informasi selengkapnya, lihat [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)di Referensi *API Manajemen Sumber Daya Amazon DocumentDB*. **catatan** Untuk fitur pengelolaan tertentu seperti pengelolaan siklus hidup klaster dan instans, Amazon DocumentDB memanfaatkan teknologi operasi yang dibagikan dengan Amazon RDS. Parameter filter `filterName=engine,Values=docdb` hanya mengembalikan klaster Amazon DocumentDB. 1. **Daftar semua instance Amazon DocumentDB.** AWS CLI Kode berikut mencantumkan detail untuk semua instance Amazon DocumentDB di suatu wilayah. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` Untuk Windows: ``` aws docdb describe-db-instances \ --filter Name=engine,Values=docdb ``` 1. **Cantumkan semua detail untuk instance Amazon DocumentDB tertentu** Kode berikut mengeluarkan daftar detail untuk `sample-cluster-instance`. Termasuk parameter `--db-instance-identifier` dengan nama instans membatasi output ke informasi pada instans tertentu. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` Untuk Windows: ``` aws docdb describe-db-instances \ --db-instance-identifier sample-cluster-instance ``` Output dari operasi ini terlihat seperti berikut. ``` { "DBInstances": [ { "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM", "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00", "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-77186e0d", "Status": "active" } ], "DBInstanceClass": "db.r5.large", "DBInstanceStatus": "creating", "AutoMinorVersionUpgrade": true, "PreferredMaintenanceWindow": "fri:09:32-fri:10:02", "BackupRetentionPeriod": 1, "StorageEncrypted": true, "DBClusterIdentifier": "sample-cluster", "EngineVersion": "3.6.0", "AvailabilityZone": "us-east-1a", "Engine": "docdb", "PromotionTier": 2, "DBInstanceIdentifier": "sample-cluster-instance", "PreferredBackupWindow": "00:00-00:30", "PubliclyAccessible": false, "DBSubnetGroup": { "DBSubnetGroupName": "default", "Subnets": [ { "SubnetIdentifier": "subnet-4e26d263", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-afc329f4", "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-b3806e8f", "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-53ab3636", "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-991cb8d0", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-29ab1025", "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupDescription": "default", "SubnetGroupStatus": "Complete" }, "PendingModifiedValues": {}, "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b" } ] } ``` ------ # Memodifikasi instance Amazon DocumentDB Anda dapat memodifikasi instans Amazon DocumentDB Anda menggunakan salah satu atau Konsol Manajemen AWS . AWS CLI Untuk memodifikasi sebuah instans, instans harus dalam status *tersedia*. Anda tidak dapat memodifikasi instans yang dihentikan. Jika klaster berhenti, pertama mulai klaster, tunggu hingga instans *tersedia*, lalu buat modifikasi yang diinginkan. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md). ------ #### [ Using the Konsol Manajemen AWS ] Untuk memodifikasi instans Amazon DocumentDB tertentu menggunakan konsol, selesaikan langkah berikut. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah. ![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png) 1. Centang kotak di sebelah kiri instans yang ingin Anda modifikasi. 1. Pilih **Tindakan**, dan kemudian pilih **Modifikasi**. 1. Di panel **Modifikasi instans: **, buat perubahan yang Anda inginkan. Anda dapat membuat perubahan berikut: + **Spesifikasi instans** — Pengidentifikasi dan kelas instans. Kendala penamaan pengidentifikasi instans: + **Instance identifier** — Masukkan nama yang unik untuk semua instans yang dimiliki oleh Anda Akun AWS di wilayah saat ini. Pengidentifikasi instans harus berisi [1-63] karakter alfanumerik atau tanda hubung, memiliki huruf sebagai karakter pertama, dan tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berturut-turut. + **Kelas instans** — Dari menu tarik-turun, pilih kelas instans untuk instans Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat [Mengelola kelas instance](db-instance-classes.md). + **Otoritas sertifikat** — Sertifikat server untuk instans ini. Untuk informasi selengkapnya, lihat [Memperbarui sertifikat Amazon DocumentDB TLS](ca_cert_rotation.md). + **Failover** — Selama failover, instans dengan tingkat promosi tertinggi akan dipromosikan ke primer. Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md). + **Pemeliharaan** — Jendela pemeliharaan di mana modifikasi atau patch yang tertunda diterapkan ke instans di klaster. 1. Setelah selesai, pilih **Lanjutkan** untuk melihat ringkasan perubahan Anda. 1. Setelah memverifikasi perubahan Anda, Anda dapat menerapkannya segera atau selama jendela pemeliharaan berikutnya di bawah **Penjadwalan modifikasi**. Pilih **Modifikasi instans** untuk menyimpan perubahan Anda. Atau, Anda dapat memilih **Batal** untuk membuang perubahan Anda. Diperlukan beberapa menit agar perubahan Anda diterapkan. Anda dapat menggunakan instans hanya ketika statusnya *tersedia*. Anda dapat memantau status instans menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Untuk memodifikasi instans Amazon DocumentDB tertentu menggunakan AWS CLI, gunakan dengan parameter `modify-db-instance` berikut. Untuk informasi selengkapnya, lihat [Memodifikasi DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). Kode berikut memodifikasi kelas instans menjadi `db.r5.large` untuk instans `sample-instance`. **Parameter** + **--db-instance-identifier** — Diperlukan. Pengidentifikasi untuk instans yang akan dimodifikasi. + **--db-instance-class** — Opsional. Kapasitas komputasi dan memori baru dari instans; misalnya, `db.r5.large`. Tidak semua kelas instans tersedia di semua Wilayah AWS. Jika Anda memodifikasi kelas instans, pemadaman terjadi selama perubahan. Perubahan diterapkan selama jendela pemeliharaan berikutnya, kecuali `ApplyImmediately` ditentukan sebagai true untuk permintaan ini. + **--apply-immediately** atau **--no-apply-immediately** — Opsional. Menentukan apakah modifikasi ini harus diterapkan segera atau menunggu hingga jendela pemeliharaan berikutnya. Jika parameter ini dihilangkan, modifikasi dilakukan selama jendela pemeliharaan berikutnya. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb modify-db-instance \ --db-instance-identifier sample-instance \ --db-instance-class db.r5.large \ --apply-immediately ``` Untuk Windows: ``` aws docdb modify-db-instance ^ --db-instance-identifier sample-instance ^ --db-instance-class db.r5.large ^ --apply-immediately ``` Output dari operasi ini terlihat seperti berikut. ``` { "DBInstances": [ { "DBInstanceIdentifier": "sample-instance-1", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "modifying", "Endpoint": { "Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-01-10T22:18:55.921Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1a", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:10:57-sun:11:27", "PendingModifiedValues": { "DBInstanceClass": "db.r5.large" }, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1", "EnabledCloudwatchLogsExports": [ "profiler" ] } ] } ``` Diperlukan beberapa menit agar modifikasi Anda diterapkan. Anda dapat menggunakan instans hanya ketika statusnya *tersedia*. Anda dapat memantau status instans menggunakan Konsol Manajemen AWS atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Mem-boot ulang instans Amazon DocumentDB Terkadang, Anda mungkin perlu mem-boot ulang instans Amazon DocumentDB Anda, biasanya karena alasan pemeliharaan. Jika Anda melakukan perubahan tertentu, seperti mengubah grup parameter klaster yang terkait dengan klaster, Anda harus mem-boot ulang instans di klaster agar perubahan diterapkan. Anda dapat me-reboot instance tertentu menggunakan Konsol Manajemen AWS atau AWS CLI. Mem-boot ulang instans akan memulai ulang layanan mesin basis data. Mem-boot ulang menyebabkan pemadaman sementara, selama status instans diatur ke `rebooting`. Peristiwa Amazon DocumentDB dibuat saat boot ulang selesai. Mem-boot ulang instans tidak mengakibatkan failover. Untuk melakukan failover cluster Amazon DocumentDB, Konsol Manajemen AWS gunakan atau operasinya. AWS CLI `failover-db-cluster` Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md). Anda tidak dapat mem-boot ulang instans Anda jika tidak berada dalam status *tersedia*. Basis data Anda dapat tidak tersedia karena beberapa alasan, seperti modifikasi yang diminta sebelumnya, atau tindakan jendela pemeliharaan. Untuk informasi lebih lanjut tentang status instans, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut mem-boot ulang instans yang Anda tentukan menggunakan konsol. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah. ![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png) 1. Centang kotak di sebelah kiri instans yang ingin Anda boot ulang. 1. Pilih **Tindakan**, pilih **Boot ulang**, lalu pilih **Boot ulang** untuk mengonfirmasi boot ulang Anda. Diperlukan waktu beberapa menit agar instans di-boot ulang. Anda dapat menggunakan instans hanya ketika statusnya *tersedia*. Anda dapat memantau status instans menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Untuk mem-boot ulang instans Amazon DocumentDB, gunakan operasi `reboot-db-instance` dengan parameter `--db-instance-identifier`. Parameter ini menentukan pengidentifikasi untuk instans yang akan di-boot ulang. Kode berikut mem-boot ulang instans `sample-instance`. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-instance ``` Untuk Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-instance ``` Output dari operasi ini terlihat seperti berikut. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "rebooting", "Endpoint": { "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-abcd0123", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` Diperlukan waktu beberapa menit agar instans di-boot ulang. Anda dapat menggunakan instans hanya ketika statusnya *tersedia*. Anda dapat memantau status instans menggunakan konsol atau AWS CLI. Untuk informasi selengkapnya, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ # Menghapus instans Amazon DocumentDB Anda dapat menghapus instans Amazon DocumentDB Anda menggunakan salah satu atau Konsol Manajemen AWS . AWS CLI Untuk menghapus sebuah instans, instans harus dalam status *tersedia*. Anda tidak dapat menghapus instans yang dihentikan. Jika klaster Amazon DocumentDB yang berisi instans Anda berhenti, pertama mulai klaster, tunggu instans menjadi *tersedia*, dan kemudian hapus instans tersebut. Untuk informasi selengkapnya, lihat [Menghentikan dan memulai cluster Amazon DocumentDB](db-cluster-stop-start.md). **catatan** Amazon DocumentDB menyimpan semua data Anda dalam volume klaster. Data tetap ada dalam volume klaster tersebut, meskipun Anda menghapus semua instans dari klaster Anda. Jika Anda perlu mengakses data lagi, Anda dapat menambahkan instans ke klaster kapan saja dan melanjutkan dari bagian terakhir yang Anda tinggalkan. ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut menghapus instans Amazon DocumentDB yang ditentukan dengan menggunakan konsol. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 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. 1. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah. ![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png) 1. Centang kotak di sebelah kiri instans yang ingin Anda hapus. 1. Pilih **Tindakan**, lalu pilih **Hapus**. 1. Jika Anda menghapus instans terakhir di klaster Anda: + **Buat snapshot cluster akhir?** — Pilih **Ya** jika Anda ingin membuat snapshot akhir sebelum klaster dihapus. Jika tidak, pilih **Tidak**. + **Nama snapshot akhir** — Jika Anda memilih untuk membuat snapshot akhir, masukkan pengidentifikasi snapshot klaster dari snapshot klaster baru yang dibuat. + **Hapus contoh?** — Masukkan frasa **hapus seluruh klaster** ke dalam bidang untuk mengonfirmasi penghapusan. 1. Jika Anda tidak menghapus instans terakhir di klaster Anda: + **Hapus contoh?** — Masukkan frasa **hapus saya** ke dalam bidang untuk mengonfirmasi penghapusan. 1. Pilih **Hapus** untuk menghapus instans. Diperlukan beberapa menit untuk menghapus instans. Untuk memantau status instans, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ------ #### [ Using the AWS CLI ] Prosedur berikut menghapus instans Amazon DocumentDB dengan menggunakan AWS CLI. 1. **Pertama, tentukan berapa banyak instance yang ada di cluster Amazon DocumentDB Anda:** Untuk menentukan berapa banyak instans di klaster Anda, jalankan perintah `describe-db-clusters`, sebagai berikut. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ``` Output dari operasi ini terlihat seperti berikut. ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` 1. **Jika ada lebih dari satu instance di cluster Amazon DocumentDB Anda:** Untuk menghapus instans Amazon DocumentDB tertentu, gunakan perintah `delete-db-instance` dengan parameter `--db-instance-identifier`, seperti yang ditunjukkan di bawah ini. Diperlukan beberapa menit untuk menghapus instans. Untuk memantau status instans, lihat [Memantau status instans Amazon DocumentDB](monitoring_docdb-instance_status.md). ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance-2 ``` Output dari operasi ini akan terlihat seperti berikut. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "deleting", "Endpoint": { "Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com", "Port": 27017, "HostedZoneId": "ABCDEFGHIJKLM" }, "InstanceCreateTime": "2020-03-27T08:05:56.314Z", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1c", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:06:53-sun:07:23", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 1, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2", "EnabledCloudwatchLogsExports": [ "profiler" ] } } ``` 1. **Jika instance yang ingin Anda hapus adalah instance terakhir di cluster Amazon DocumentDB Anda:** Jika Anda menghapus instans terakhir di klaster Amazon DocumentDB, Anda juga menghapus klaster tersebut serta snapshot otomatis dan backup terus menerus yang terkait dengan klaster tersebut. Untuk menghapus instans terakhir di klaster Anda, Anda dapat menghapus klaster dan secara opsional membuat snapshot akhir. Untuk informasi selengkapnya, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). ------ ## Perlindungan penghapusan Menghapus instans terakhir dari klaster Amazon DocumentDB juga akan menghapus klaster tersebut, serta snapshot otomatis dan backup terus menerus yang terkait dengan klaster tersebut. Amazon DocumentDB memberlakukan perlindungan penghapusan untuk klaster apakah Anda melakukan operasi penghapusan menggunakan atau. Konsol Manajemen AWS AWS CLI Jika perlindungan penghapusan diaktifkan, Anda tidak dapat menghapus klaster. Untuk menghapus klaster yang mengaktifkan perlindungan penghapusan, Anda harus terlebih dahulu mengubah klaster dan menonaktifkan perlindungan penghapusan. Lihat informasi yang lebih lengkap di [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md). # Mengelola kelas instance Kelas instans menentukan komputasi dan kapasitas memori dari instans Amazon DocumentDB (dengan kompatibilitas MongoDB). Kelas instans yang Anda butuhkan tergantung pada kebutuhan daya dan memori pemrosesan Anda. Amazon DocumentDB mendukung keluarga kelas instans R4, R5, R6G, R8G, T3, dan T4G. Kelas-kelas ini adalah kelas instans generasi saat ini yang dioptimalkan untuk aplikasi yang memakan memori. Untuk spesifikasi pada kelas-kelas ini, lihat [Spesifikasi kelas instans](#db-instance-class-specs). **Topics** + [Menentukan kelas instance](#db-instance-class-determining) + [Mengubah kelas instance](#db-instance-class-changing) + [Kelas instance yang didukung berdasarkan wilayah](#db-instance-classes-by-region) + [Spesifikasi kelas instans](#db-instance-class-specs) ## Menentukan kelas instance Untuk menentukan kelas sebuah instance, Anda dapat menggunakan Konsol Manajemen AWS atau `describe-db-instances` AWS CLI operasi. ------ #### [ Using the Konsol Manajemen AWS ] Untuk menentukan kelas instans bagi instans klaster Anda, selesaikan langkah-langkah berikut di konsol. 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Klaster **untuk menemukan instans yang Anda minati. **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. 1. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah. ![\[Tabel cluster yang menunjukkan bagaimana sebuah instance bersarang di bawah cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png) 1. Dalam daftar instans, perluas klaster untuk menemukan instans Anda minati. Temukan instans yang Anda inginkan. Kemudian, lihat pada kolom **Ukuran** dari baris instans untuk melihat kelas instansnya. Pada gambar berikut, kelas instans untuk instans `robo3t` adalah `db.r5.4xlarge`. ![\[Daftar contoh dalam tabel Clusters dengan kolom Ukuran yang menunjukkan jenis instance.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/instance-class.png) ------ #### [ Using the AWS CLI ] Untuk menentukan kelas instance menggunakan AWS CLI, gunakan `describe-db-instances` operasi dengan parameter berikut. + **--db-instance-identifier**— Opsional. Menentukan instans yang ingin Anda temukan kelas instansnya. Jika parameter ini dihilangkan, `describe-db-instances` mengembalikan deskripsi hingga 100 instans Anda. + **--query** — Opsional. Menentukan anggota instans untuk disertakan dalam hasil. Jika parameter ini dihilangkan, semua anggota instans dikembalikan. **Example** Contoh berikut menemukan nama dan kelas instans untuk instans `sample-instance-1`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \ --db-instance-identifier sample-instance-1 ``` Untuk Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^ --db-instance-identifier sample-instance-1 ``` Output dari operasi ini terlihat seperti berikut. ``` [ [ "sample-instance-1", "db.r5.large" ] ``` **Example** Contoh berikut menemukan nama dan kelas instans hingga 100 instans Amazon DocumentDB. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \ --filter Name=engine,Values=docdb ``` Untuk Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^ --filter Name=engine,Values=docdb ``` Output dari operasi ini terlihat seperti berikut. ``` [ [ "sample-instance-1", "db.r5.large" ], [ "sample-instance-2", "db.r5.large" ], [ "sample-instance-3", "db.r5.4xlarge" ], [ "sample-instance-4", "db.r5.4xlarge" ] ] ``` Untuk informasi selengkapnya, lihat [Menjelaskan instans Amazon DocumentDB](db-instance-view-details.md). ------ ## Mengubah kelas instance Anda dapat mengubah kelas instance instance Anda menggunakan Konsol Manajemen AWS atau AWS CLI. Untuk informasi selengkapnya, lihat [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md). ## Kelas instance yang didukung berdasarkan wilayah Amazon DocumentDB mendukung kelas instans berikut: + `R8G`—Generasi terbaru dari instans yang dioptimalkan memori yang didukung oleh prosesor AWS Graviton4 berbasis ARM yang memberikan kinerja hingga 30% lebih baik dibandingkan instans R6G. + `R6G`—Instans yang dioptimalkan untuk memori yang didukung oleh prosesor AWS Graviton2 berbasis ARM yang memberikan kinerja hingga 30% lebih baik dibandingkan instans R5 dengan biaya 5% lebih murah. + `R6GD`—Instans R6G yang dioptimalkan memori dengan penyimpanan Solid-State Drive (SSDNVMe) berbasis memori non-volatile express () lokal untuk data sementara. + `R5`—Instans yang dioptimalkan untuk memori yang memberikan kinerja hingga 100% lebih baik dibandingkan instans R4 dengan biaya instans yang sama. + `R4` — Generasi sebelumnya dari instans dengan memori yang dioptimalkan. + `T4G`—Jenis instans tujuan umum burstable berbiaya rendah generasi terbaru yang ditenagai oleh prosesor AWS Graviton2 berbasis ARM yang memberikan tingkat kinerja CPU dasar, memberikan kinerja harga hingga 35% lebih baik dibandingkan instans T3 dan ideal untuk menjalankan aplikasi dengan penggunaan CPU moderat yang mengalami lonjakan sementara dalam penggunaan. + `T3`—Jenis instans tujuan umum burstable dengan biaya rendah yang memberikan tingkat kinerja CPU dasar dengan kemampuan untuk meningkatkan penggunaan CPU kapan saja selama diperlukan. Untuk spesifikasi mendetail tentang kelas instans, lihat [Spesifikasi kelas instans](#db-instance-class-specs). **catatan** Penyimpanan I/O-Optimized hanya tersedia pada engine versi 5.0 dan 8.0 (cluster berbasis instance). Sebuah kelas instans tertentu mungkin atau mungkin tidak didukung di Wilayah tertentu. Tabel berikut menentukan kelas instans yang didukung oleh Amazon DocumentDB di setiap Wilayah. **Kelas instans yang didukung berdasarkan Wilayah** | | Kelas Instans | Region | R8G | R6GD | R6G | R5 | R4 | T4G | T3 | Nirserver | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | AS Timur (Ohio) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | | US East (N. Virginia) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | | US West (Oregon) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | | Africa (Cape Town) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | Amerika Selatan (Sao Paulo) | | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pasifik (Hong Kong) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pasifik (Hyderabad) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pasifik (Malaysia) | | | Didukung | | | Didukung | Didukung | | | Asia Pasifik (Mumbai) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pasifik (Osaka) | | Didukung | Didukung | Didukung | | Didukung | Didukung | | | Asia Pasifik (Seoul) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pacific (Sydney) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pasifik (Jakarta) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | | | Asia Pacific (Melbourne) | | | Didukung | Didukung | | Didukung | Didukung | | | Asia Pacific (Singapore) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Asia Pasifik (Thailand) | | | Didukung | | | Didukung | Didukung | | | Asia Pacific (Tokyo) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Kanada (Pusat) | | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Eropa (Frankfurt) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Europe (Zurich) | | Didukung | Didukung | Didukung | | Didukung | Didukung | | | Eropa (Irlandia) | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | Didukung | | Eropa (London) | | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Europe (Milan) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | Eropa (Paris) | | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Eropa (Spanyol) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Eropa (Stockholm) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | | | Meksiko (Tengah) | | | Didukung | | | Didukung | Didukung | | | Timur Tengah (UAE) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | Tiongkok (Beijing) | | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | Tiongkok (Ningxia) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | Israel (Tel Aviv) | | | Didukung | Didukung | | Didukung | Didukung | Didukung | | AWS GovCloud (AS-Barat) | Didukung | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | | AWS GovCloud (AS-Timur) | | Didukung | Didukung | Didukung | | Didukung | Didukung | Didukung | ## Spesifikasi kelas instans Tabel berikut memberikan rincian kelas instans Amazon DocumentDB, termasuk jenis instance yang didukung di setiap kelas. Anda dapat menemukan penjelasan untuk setiap kolom tabel di bawah tabel. | Kelas instans | vCPU1 | Memori (GiB) 2 | NVMe Cache berjenjang SSD (GiB) 3 | Maks. temp. penyimpanan (GiB) 4 | Bandwidth dasar/burst (Gbps) 5 | Mesin Pendukung 6 | | --- | --- | --- | --- | --- | --- | --- | | R8G - Kelas Instance yang Dioptimalkan Memori Generasi Saat Ini berdasarkan Graviton4 R8G adalah keluarga instans terbaru (Graviton4), hanya tersedia pada versi mesin 5.0 dan 8.0. Ukuran db.r8g.24xlarge dan db.r8g.48xlarge belum tersedia. | | db.r8g.large | 2 | 16 | - | 30 | 0,937/12,5 | 5.0.0 dan 8.0.0 | | db.r8g.xlarge | 4 | 32 | - | 60 | 1.875/12,5 | 5.0.0 dan 8.0.0 | | db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75/15,0 | 5.0.0 dan 8.0.0 | | db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5/15,0 | 5.0.0 dan 8.0.0 | | db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 dan 8.0.0 | | db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 dan 8.0.0 | | db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 dan 8.0.0 | | R6G - Kelas Instance yang Dioptimalkan Memori Generasi Saat Ini berdasarkan Graviton2 | | db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0, dan 8.0.0 | | db.r6g.xlarge | 4 | 32 | - | 63 | 1,25/10 | 4.0.0, 5.0.0, dan 8.0.0 | | db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/10 | 4.0.0, 5.0.0, dan 8.0.0 | | db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/10 | 4.0.0, 5.0.0, dan 8.0.0 | | db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0, dan 8.0.0 | | db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0, dan 8.0.0 | | db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0, dan 8.0.0 | | R6GD - Kelas Instance yang NVMe didukung Generasi Saat Ini berdasarkan Graviton2 | | db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1,25/10 | 5.0.0 dan 8.0.0 | | db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2.5/10 | 5.0.0 dan 8.0.0 | | db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5.0/10 | 5.0.0 dan 8.0.0 | | db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 dan 8.0.0 | | db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 dan 8.0.0 | | db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 dan 8.0.0 | | R5 - Kelas Instance Dioptimalkan Memori Generasi Sebelumnya | | db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.xlarge | 4 | 32 | - | 62 | 1,25/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.2xlarge | 8 | 64 | - | 124 | 2.5/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | R4 - Kelas Instance Dioptimalkan Memori Generasi Sebelumnya Instans R4 hanya didukung pada engine versi 3.6. Perhatikan bahwa Amazon DocumentDB 3.6 mencapai akhir dukungan standar pada 30 Maret 2026. Extended Support (berbayar) tersedia hingga Maret 2029. | | db.r4.large | 2 | 15.25 | - | 30 | 0,75/10 | 3.6.0 saja | | db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | 3.6.0 saja | | db.r4.2xlarge | 8 | 61 | - | 120 | 2.5/10 | 3.6.0 saja | | db.r4.4xlarge | 16 | 122 | - | 240 | 5.0 /10 | 3.6.0 saja | | db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 3.6.0 saja | | db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 3.6.0 saja | | T4G — Kelas Instans Kinerja Burstable Generasi Terbaru berdasarkan Graviton2 Instans seri-T berjalan dalam mode burst CPU Tidak Terbatas. Penggunaan burst di luar baseline ditagih ekstra. Tidak didukung untuk Global Cluster. | | db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/5 | 4.0.0, 5.0.0, dan 8.0.0 | | T3 — Kelas Instans Kinerja Burstable Generasi Sebelumnya | | db.t3.medium | 2 | 4 | - | 7.5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0, dan 8.0.0 | | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/db-instance-classes.html) | # NVMecontoh -didukung NVMeInstans yang didukung menawarkan kinerja kueri hingga 7x lebih cepat untuk aplikasi dengan kumpulan data besar yang melebihi memori instans biasa. Instans ini memanfaatkan penyimpanan Solid-State Drive (SSDNVMe) berbasis memori non-volatile lokal yang tersedia pada instans r6gd untuk menyimpan data sementara, mengurangi akses penyimpanan berbasis jaringan, dan meningkatkan latensi dan throughput baca. Ruang SSD lokal dibagi menjadi dua bagian: + **Cache berjenjang** — Sekitar 73% dari SSD lokal dialokasikan sebagai cache database, memungkinkan sistem untuk menyimpan hingga lima kali lebih banyak halaman database daripada memori utama saja. SSD lokal bertindak sebagai cache tingkat kedua, sedangkan cache buffer dalam memori yang ada tetap menjadi cache tingkat pertama. Kueri hanya mengakses penyimpanan eksternal jika cache buffer dan cache SSD mengalami kehilangan. + **Penyimpanan sementara** — 27% sisanya dicadangkan untuk penyimpanan file sementara yang tidak persisten, digunakan untuk kueri kompleks yang melibatkan jenis atau operasi intensif sumber daya seperti pembuatan indeks. Pada instans reguler, ruang sementara berada di volume Amazon Elastic Block Store (EBS). Penyimpanan sementara yang dihosting secara lokal pada SSD mengurangi latensi kueri yang melibatkan jenis hingga dua kali dan mempercepat operasi intensif sumber daya seperti pembuatan indeks. Rincian mengenai jenis instans NVMe yang didukung dan spesifikasinya dapat ditemukan di. [Spesifikasi kelas instans](db-instance-classes.md#db-instance-class-specs) **Topics** + [Kasus penggunaan yang disarankan untuk NVMe instance yang didukung](#nvme-use-cases) + [Menggunakan instans NVMe yang didukung dengan Amazon DocumentDB](#using-nvme) + [Memantau NVMe instans yang didukung](#monitoring-nvme) ## Kasus penggunaan yang disarankan untuk NVMe instance yang didukung Sebaiknya gunakan instans NVMe yang didukung dalam skenario berikut: + **Beban kerja baca-berat - Jika beban** kerja Anda padat baca, dan kumpulan data Anda lebih besar dari cache buffer, ditunjukkan oleh `ReadIOPS` metrik rendah `BufferCacheHitRatio` dan tinggi, instans yang didukung dapat memberikan manfaat kinerja. NVMe + **Beban kerja pembaruan-berat** - Jika beban kerja Anda padat pembaruan, dan pengumpulan sampah tidak dapat mengikuti karena latensi baca pada penyimpanan jaringan, instans yang didukung dapat membantu mengurangi masalah. NVMe NVMeinstans yang didukung dapat menguntungkan berbagai kasus penggunaan, termasuk: + **Aplikasi skala internet — Aplikasi** seperti pemrosesan pembayaran, penagihan, dan e-commerce dengan Perjanjian Tingkat Layanan (SLAs) kinerja yang ketat dapat memanfaatkan keunggulan kinerja instans yang didukung. NVMe + **Dasbor pelaporan real-time** — Dasbor yang menjalankan ratusan kueri untuk pengumpulan metrik/data dapat memanfaatkan latensi rendah dan throughput tinggi dari instans yang didukung. NVMe + **Aplikasi AI generatif** — Aplikasi yang menggunakan pencarian vektor untuk menemukan tetangga yang tepat atau terdekat di jutaan penyematan vektor dapat memanfaatkan kinerja tinggi instance yang didukung. NVMe ## Menggunakan instans NVMe yang didukung dengan Amazon DocumentDB Untuk menggunakan instance NVMe Amazon DocumentDB yang didukung: + Buat klaster Amazon DocumentDB dan tambahkan salah satu kelas instans yang didukung NVMe. Untuk informasi selengkapnya, lihat [Membuat cluster Amazon DocumentDB](db-cluster-create.md). + Atau, ubah cluster Amazon DocumentDB yang ada untuk menggunakan salah satu kelas instans yang didukung NVMe. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). Untuk memeriksa ketersediaan instans yang NVMe didukung di berbagai AWS Wilayah, lihat. [Kelas instance yang didukung berdasarkan wilayah](db-instance-classes.md#db-instance-classes-by-region) Jika Anda ingin beralih kembali dari instance NVMe -backed ke instance biasa, ubah class instance database instance Amazon DocumentDB Anda ke kelas instance serupa tanpa penyimpanan. NVMe Misalnya, jika kelas instance Anda saat ini adalah 'db.r6gd.4xlarge', pilih 'db.r6g.4xlarge' untuk beralih kembali. Untuk informasi selengkapnya, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). ## Memantau NVMe instans yang didukung Selain metrik instans reguler yang tersedia di Amazon CloudWatch, instans yang NVMe didukung memancarkan metrik tambahan khusus untuk penyimpanan SSD NVMe berbasis, IOPS, dan throughput. ``` NVMeStorageCacheHitRatio FreeNVMeStorage ReadIOPSNVMeStorage ReadLatencyNVMeStorage ReadThroughputNVMeStorage WriteIOPSNVMeStorage WriteLatencyNVMeStorage WriteThroughputNVMeStorage ``` Untuk informasi selengkapnya tentang metrik ini, lihat [NVMemetrik instance yang didukung](cloud_watch.md#nvme-metrics) # Mengelola grup subnet Amazon DocumentDB Virtual Private Cloud (VPC) adalah jaringan virtual yang didedikasikan untuk Anda. Akun AWS Secara logis terisolasi dari jaringan virtual lain di AWS Cloud. Anda dapat meluncurkan AWS sumber daya Anda, seperti cluster Amazon DocumentDB, ke dalam Amazon VPC Anda. Anda dapat menentukan kisaran alamat IP untuk VPC, menambahkan subnet, grup keamanan yang berkaitan, dan mengonfigurasi tabel rute. Subnet adalah serangkaian alamat IP di Amazon VPC Anda. Anda dapat meluncurkan AWS sumber daya ke subnet tertentu. Gunakan subnet *publik* untuk sumber daya yang harus dihubungkan ke internet. Gunakan subnet *privat* untuk sumber daya yang tidak akan dihubungkan ke internet. Untuk informasi selengkapnya tentang subnet publik dan privat, lihat [Basic VPC dan Subnet](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html#vpc-subnet-basics) di *Panduan Pengguna Amazon Virtual Private Cloud*. Grup subnet DB adalah kumpulan subnet yang Anda buat di VPC dan kemudian Anda tetapkan untuk klaster Anda. Grup subnet memungkinkan Anda untuk menentukan VPC tertentu saat membuat klaster. Jika Anda menggunakan grup subnet `default`, ini mencakup semua subnet di VPC. Setiap grup subnet DB harus memiliki subnet di setidaknya dua Availability Zone di Wilayah tertentu. Saat membuat klaster DB dalam VPC, Anda harus memilih grup subnet DB. Amazon DocumentDB menggunakan grup subnet DB dan Availability Zone pilihan Anda untuk memilih subnet dan alamat IP di dalam subnet tersebut untuk dikaitkan dengan klaster Anda. Jika instans primer gagal, Amazon DocumentDB dapat mempromosikan instans replika yang sesuai menjadi primer baru. Hal ini kemudian dapat membuat instans replika baru menggunakan alamat IP subnet di mana primer sebelumnya terletak. Saat Amazon DocumentDB membuat instans dalam VPC, jaringan ini menetapkan antarmuka jaringan ke klaster Anda menggunakan alamat IP yang dipilih dari grup subnet DB Anda. Kami sangat menyarankan agar Anda menggunakan nama DNS karena alamat IP dapat berubah selama failover. Untuk informasi selengkapnya, lihat [Titik akhir Amazon DocumentDB](how-it-works.md#how-it-works.endpoints). Untuk informasi tentang membuat VPC dan subnet Anda sendiri, lihat [Bekerja dengan VPCs dan Subnet](https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html) di Panduan Pengguna *Amazon Virtual Private Cloud*. **Topics** + [Membuat grup subnet Amazon DocumentDB](document-db-subnet-group-create.md) + [Menjelaskan grup subnet Amazon DocumentDB](document-db-subnet-group-describe.md) + [Memodifikasi grup subnet Amazon DocumentDB](document-db-subnet-group-modify.md) + [Menghapus grup subnet Amazon DocumentDB](document-db-subnet-group-delete.md) # Membuat grup subnet Amazon DocumentDB Saat membuat klaster Amazon DocumentDB, Anda harus memilih Amazon VPC dan grup subnet yang sesuai di dalam Amazon VPC tersebut untuk meluncurkan klaster Anda. Subnet menentukan availability zone dan kisaran IP di dalam availability zone yang ingin Anda gunakan untuk meluncurkan instans. Grup subnet adalah kumpulan subnet bernama (atau AZs) yang memungkinkan Anda menentukan zona ketersediaan yang ingin Anda gunakan untuk meluncurkan instans Amazon DocumentDB. Misalnya, dalam klaster dengan tiga instance, disarankan agar masing-masing instance tersebut disediakan secara terpisah AZs —melakukannya mengoptimalkan ketersediaan tinggi. Dengan demikian, jika AZ tunggal gagal, maka hanya akan memengaruhi instans tunggal. Saat ini, instans Amazon DocumentDB dapat disediakan hingga tiga. AZs Bahkan jika grup subnet memiliki lebih dari tiga subnet, Anda hanya akan dapat menggunakan tiga subnet tersebut untuk membuat klaster Amazon DocumentDB. Oleh karena itu, kami menyarankan bahwa ketika Anda membuat grup subnet di mana Anda hanya memilih tiga subnet tempat Anda akan menyebarkan instans Anda. Misalnya: Cluster dibuat dan Amazon DocumentDB AZs memilih \$11A, 1B, dan 1C\$1. Jika Anda mencoba untuk membuat instans di AZ \$11D\$1 panggilan API akan gagal. Namun demikian, jika Anda memilih untuk membuat instans, tanpa menentukan AZ tertentu, maka Amazon DocumentDB akan memilih AZ atas nama Anda. Amazon DocumentDB menggunakan algoritme untuk memuat keseimbangan instans untuk membantu Anda AZs mencapai ketersediaan tinggi. Jika tiga instance disediakan, secara default, mereka akan disediakan di tiga AZs dan tidak akan disediakan semuanya dalam satu AZ. Praktik Terbaik + Kecuali Anda memiliki alasan tertentu, selalu buat grup subnet dengan tiga subnet. Ini memastikan bahwa cluster dengan tiga atau lebih instance akan dapat mencapai ketersediaan yang lebih tinggi karena instance akan disediakan di tiga. AZs + Selalu sebarkan instans di beberapa AZs untuk mencapai ketersediaan tinggi. Jangan pernah menempatkan semua instance untuk cluster dalam satu AZ. + Karena peristiwa failover dapat terjadi kapan saja, Anda tidak boleh berasumsi bahwa instance utama atau instance replika akan selalu berada di AZ tertentu. ## Cara untuk membuat grup subnet Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk membuat grup subnet Amazon DocumentDB: ------ #### [ Using the Konsol Manajemen AWS ] Gunakan langkah-langkah berikut ini untuk membuat grup subnet Amazon DocumentDB. **Untuk membuat grup subnet Amazon DocumentDB** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup subnet**, kemudian pilih **Buat**. **Tip** Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Pada halaman **Buat grup subnet**: 1. Di bagian **Detail grup subnet**: 1. **Nama**—Masukkan nama yang bermakna untuk grup subnet. 1. **Deskripsi**—Masukkan deskripsi untuk grup subnet. 1. Di bagian **Tambahkan subnet**: 1. **VPC**—Dalam daftar, pilih VPC untuk grup subnet ini. 1. Lakukan salah satu hal berikut ini: + Untuk memasukkan semua subnet dalam VPC yang dipilih, pilih **Tambahkan semua subnet yang berkaitan dengan VPC ini**. + Untuk menentukan subnet untuk grup subnet ini, lakukan hal berikut ini untuk setiap Availability Zone tempat Anda ingin menyertakan subnet. Anda harus menyertakan setidaknya dua Availability Zone. 1. **Availability Zone**—Dalam daftar, pilih Availability Zone. 1. **Subnet**—Dalam daftar, pilih subnet dari Availability Zone yang yang dipilih untuk grup subnet ini. 1. Pilih **Tambahkan subnet**. 1. Pilih **Buat**. Ketika grup subnet dibuat, maka akan dicantumkan dengan grup subnet Anda lainnya. ![\[Tangkapan layar: Menampilkan detail grup subnet.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-subnet-groups-list.png) ------ #### [ Using the AWS CLI ] Sebelum Anda dapat membuat grup subnet menggunakan AWS CLI, Anda harus terlebih dahulu menentukan subnet mana yang tersedia. Jalankan AWS CLI operasi berikut untuk membuat daftar Availability Zones dan subnetnya. **Parameter:** + **--db-subnet-group**—Opsional. Menentukan grup subnet tertentu akan mencantumkan Availability Zone dan subnet untuk grup tersebut. Menghilangkan parameter ini akan mencantumkan Availability Zone dan subnet untuk semua grup subnet Anda. Menentukan grup subnet `default` akan mencantumkan semua subnet VPC. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name default \ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` Untuk Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name default ^ --query 'DBSubnetGroups[*].[DBSubnetGroupName,Subnets[*].[SubnetAvailabilityZone.Name,SubnetIdentifier]]' ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` [ [ "default", [ [ "us-east-1a", "subnet-4e26d263" ], [ "us-east-1c", "subnet-afc329f4" ], [ "us-east-1e", "subnet-b3806e8f" ], [ "us-east-1d", "subnet-53ab3636" ], [ "us-east-1b", "subnet-991cb8d0" ], [ "us-east-1f", "subnet-29ab1025" ] ] ] ] ``` Dengan menggunakan keluaran dari operasi sebelumnya, Anda dapat membuat grup subnet baru. Grup subnet baru harus mencakup subnet dari setidaknya dua Availability Zone. **Parameter:** + **--db-subnet-group-name**—Wajib. Nama untuk grup subnet ini. + **--db-subnet-group-description**—Wajib. Deskripsi dari grup subnet ini. + **--subnet-ids**—Wajib. Daftar subnet untuk disertakan dalam grup subnet ini. Contoh:`subnet-53ab3636`. + --Tanda****—Opsional. Daftar tanda (pasangan nilai kunci) untuk dilampirkan ke grup subnet ini. Kode berikut ini membuat `sample-subnet-group` grup subnet dengan tiga subnet, `subnet-4e26d263`, `subnet-afc329f4`, dan `subnet-b3806e8f`. Untuk Linux, macOS, atau Unix: ``` aws docdb create-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --db-subnet-group-description "A sample subnet group" \ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f \ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` Untuk Windows: ``` aws docdb create-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --db-subnet-group-description "A sample subnet group" ^ --subnet-ids subnet-4e26d263 subnet-afc329f4 subnet-b3806e8f ^ --tags Key=tag1,Value=One Key=tag2,Value=2 ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupDescription": "A sample subnet group", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetIdentifier": "subnet-4e26d263", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetIdentifier": "subnet-afc329f4", "SubnetStatus": "Active" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetIdentifier": "subnet-b3806e8f", "SubnetStatus": "Active" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "SubnetGroupStatus": "Complete" } } ``` ------ # Menjelaskan grup subnet Amazon DocumentDB Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk mendapatkan rincian grup subnet Amazon DocumentDB. ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut ini menunjukkan kepada Anda cara untuk mendapatkan detail grup subnet Amazon DocumentDB. **Untuk menemukan detail grup subnet** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup Subnet**. **Tip** Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Untuk melihat detail grup subnet, pilih nama grup subnet tersebut. ![\[Tangkapan layar: Menampilkan detail grup subnet.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-subnet-group-details.png) ------ #### [ Using the AWS CLI ] Untuk menemukan detail grup subnet Amazon DocumentDB, gunakan operasi `describe-db-subnet-groups` dengan parameter berikut ini. **Parameter** + `--db-subnet=group-name`—Opsional. Jika disertakan, detail untuk grup subnet yang diberi nama dicantumkan. Jika dihilangkan, detail untuk hingga 100 grup subnet dicantumkan. **Example** Kode berikut ini mencantumkan detail untuk grup subnet `sample-subnet-group` yang kita buat di bagian [Membuat grup subnet Amazon DocumentDB](document-db-subnet-group-create.md). Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-subnet-groups \ --db-subnet-group-name sample-subnet-group ``` Untuk Windows: ``` aws docdb describe-db-subnet-groups ^ --db-subnet-group-name sample-subnet-group ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "VpcId": "vpc-91280df6", "SubnetGroupStatus": "Complete", "DBSubnetGroupName": "sample-subnet-group", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1a" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-4e26d263" }, { "SubnetAvailabilityZone": { "Name": "us-east-1c" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-afc329f4" }, { "SubnetAvailabilityZone": { "Name": "us-east-1e" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-b3806e8f" } ], "DBSubnetGroupDescription": "A sample subnet group" } } ``` ------ # Memodifikasi grup subnet Amazon DocumentDB Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk memodifikasi deskripsi grup subnet atau untuk menambah atau menghapus subnet dari grup subnet Amazon DocumentDB. Namun demikian, Anda tidak dapat mengubah grup subnet `default`. ------ #### [ Using the Konsol Manajemen AWS ] Anda dapat menggunakan Konsol Manajemen AWS untuk mengubah deskripsi grup subnet atau untuk menambah dan menghapus subnet. Ingat bahwa setelah selesai, Anda harus memiliki setidaknya dua Availability Zone yang berkaitan dengan grup subnet Anda. **Untuk memodifikasi grup subnet Anda** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup Subnet**. Kemudian pilih tombol di sebelah kiri nama grup subnet. Ingat bahwa Anda tidak dapat memodifikasi grup subnet `default`. **Tip** Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Pilih **Tindakan**, dan kemudian pilih **Modifikasi**. 1. **Deskripsi**—Untuk mengubah deskripsi grup subnet Anda, masukkan deskripsi baru. 1. Untuk mengubah subnet yang berkaitan dengan grup subnet Anda, di bagian **Tambahkan subnet**, lakukan salah satu atau lebih dari hal berikut ini: + Untuk menghapus semua subnet dari grup subnet ini, pilih **Hapus semua**. + Untuk menghapus subnet tertentu dari grup subnet ini, pilih **Hapus** untuk setiap subnet yang ingin Anda hapus. + Untuk menambahkan semua subnet yang berkaitan dengan VPC ini, pilih **Tambahkan semua subnet yang berkaitan dengan VPC ini**. + Untuk menambahkan subnet tertentu ke grup subnet ini, lakukan hal berikut ini untuk setiap Availability Zone tempat Anda ingin menambahkan subnet. 1. **Availability zone**—Dalam daftar, pilih Availability Zone baru. 1. **Subnet**—Dalam daftar, pilih subnet dari Availability Zone yang yang dipilih untuk grup subnet ini. 1. Pilih **Tambahkan subnet**. 1. Di kotak dialog konfirmasi: + Untuk membuat perubahan tersebut ke grup subnet, pilih **Modifikasi**. + Untuk menyimpan grup subnet agar tidak berubah, pilih **Batal**. ------ #### [ Using the AWS CLI ] Anda dapat menggunakan AWS CLI untuk mengubah deskripsi grup subnet atau untuk menambah dan menghapus subnet. Ingat bahwa setelah selesai, Anda harus memiliki setidaknya dua Availability Zone yang berkaitan dengan grup subnet Anda. Anda tidak dapat memodifikasi grup subnet `default`. **Parameter:** + `--db-subnet-group-name`—Wajib. Nama grup subnet Amazon DocumentDB yang Anda modifikasi. + `--subnet-ids`—Wajib. Daftar semua subnet yang Anda inginkan dalam grup subnet setelah perubahan ini dilakukan. **penting** Setiap subnet yang saat ini berada dalam grup subnet yang tidak disertakan dalam daftar ini akan dihapus dari grup subnet. Jika Anda ingin menyimpan salah satu subnet yang saat ini dalam grup subnet, Anda harus menyertakannya dalam daftar ini. + `--db-subnet-group-description`—Opsional. Deskripsi grup subnet. **Example** Kode berikut memodifikasi deskripsi dan menggantikan subnet yang ada dengan subnet `subnet-991cb8d0`, `subnet-53ab3636`, dan `subnet-29ab1025`. Untuk Linux, macOS, atau Unix: ``` aws docdb modify-db-subnet-group \ --db-subnet-group-name sample-subnet-group \ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 \ --db-subnet-group-description "Modified subnet group" ``` Untuk Windows: ``` aws docdb modify-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ^ --subnet-ids subnet-991cb8d0 subnet-53ab3636 subnet-29ab1025 ^ --db-subnet-group-description "Modified subnet group" ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). Perhatikan bahwa ini adalah grup subnet yang sama yang dibuat di bagian [Membuat grup subnet Amazon DocumentDB](document-db-subnet-group-create.md). Namun demikian, subnet dalam grup subnet diganti dengan yang tercantum dalam operasi `modify-db-subnet-group`. ``` { "DBSubnetGroup": { "DBSubnetGroupArn": "arn:aws:rds:us-east-1:123SAMPLE012:subgrp:sample-subnet-group", "DBSubnetGroupDescription": "Modified subnet group", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetAvailabilityZone": { "Name": "us-east-1d" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-53ab3636" }, { "SubnetAvailabilityZone": { "Name": "us-east-1b" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-991cb8d0" }, { "SubnetAvailabilityZone": { "Name": "us-east-1f" }, "SubnetStatus": "Active", "SubnetIdentifier": "subnet-29ab1025" } ], "VpcId": "vpc-91280df6", "DBSubnetGroupName": "sample-subnet-group" } } ``` ------ # Menghapus grup subnet Amazon DocumentDB Anda dapat menggunakan Konsol Manajemen AWS atau menghapus grup AWS CLI subnet Amazon DocumentDB. Namun demikian, Anda tidak dapat menghapus grup subnet `default`. ------ #### [ Using the Konsol Manajemen AWS ] Anda dapat menggunakan Konsol Manajemen AWS untuk menghapus grup subnet. Namun Anda tidak dapat menghapus grup subnet `default`. **Untuk menghapus grup subnet** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup Subnet**. Kemudian pilih tombol di sebelah kiri nama grup subnet. Ingat bahwa Anda tidak dapat menghapus grup subnet `default`. **Tip** Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Pilih **Tindakan**, lalu pilih **Hapus**. 1. Di kotak dialog konfirmasi: + Untuk menghapus grup subnet, pilih **Hapus**. + Untuk menyinmpan grup subnet, pilih **Batal**. ------ #### [ Using the AWS CLI ] Untuk menghapus grup subnet Amazon DocumentDB menggunakan, gunakan operasi AWS CLI dengan parameter `delete-db-subnet-group` berikut. **Parameter** + `--db-subnet-group-name`—Wajib. Nama grup subnet Amazon DocumentDB yang akan dihapus. Ingat bahwa Anda tidak dapat menghapus grup subnet `default`. **Example** Kode berikut ini akan menghapus `sample-subnet-group`. Untuk Linux, macOS, atau Unix: ``` aws docdb delete-db-subnet-group \ --db-subnet-group-name sample-subnet-group ``` Untuk Windows: ``` aws docdb delete-db-subnet-group ^ --db-subnet-group-name sample-subnet-group ``` Operasi ini tidak menghasilkan keluaran. ------ # Amazon DocumentDB Ketersediaan dan replikasi tinggi Anda dapat mencapai ketersediaan tinggi dan membaca penskalaan di Amazon DocumentDB (dengan kompatibilitas MongoDB) dengan menggunakan instans replika. Klaster Amazon DocumentDB tunggal mendukung instans primer tunggal dan hingga 15 instans replika. Instans tersebut dapat didistribusikan di seluruh Availability Zone di dalam Wilayah klaster. Instans primer menerima lalu lintas baca dan tulis, dan instans replika hanya menerima permintaan baca. Volume kluster dibuat dari beberapa salinan data untuk kluster. Namun demikian, data dalam volume klaster direpresentasikan sebagai volume tunggal yang logis ke instans primer dan replika Amazon DocumentDB dalam klaster. Instans replika pada akhirnya konsisten. Mereka mengembalikan hasil kueri dengan sedikit penundaan replika—biasanya kurang dari 100 milidetik setelah instans primer menulis pembaruan. Lag replika bervariasi bergantung pada laju perubahan basis data. Artinya, selama periode di mana sejumlah besar operasi tulis terjadi untuk basis data, Anda mungkin melihat peningkatan lag replika. ## Penskalaan baca Replika Amazon DocumentDB berfungsi dengan baik untuk penskalaan baca karena didedikasikan sepenuhnya untuk membaca operasi pada volume klaster Anda. Operasi tulis dikelola oleh instans primer. Volume klaster dibagikan di semua instans di klaster Anda. Oleh karena itu, Anda tidak perlu mereplikasi dan mempertahankan salinan data untuk setiap replika Amazon DocumentDB. ## Ketersediaan tinggi Saat Anda membuat klaster Amazon DocumentDB, bergantung pada jumlah Availability Zone dalam grup subnet (harus ada setidaknya dua), Amazon DocumentDB menyediakan instans di seluruh Availability Zone. Ketika Anda membuat instans dalam klaster, Amazon DocumentDB secara otomatis mendistribusikan instans di seluruh Availability Zone dalam grup subnet untuk menyeimbangkan klaster. Tindakan ini juga mencegah semua instans diletakkan di Availability Zone yang sama. **Contoh** Untuk mengilustrasikan intinya, pertimbangkan contoh di mana Anda membuat klaster yang memiliki grup subnet dengan tiga Availability Zones: *AZ1*, *AZ2*, dan. *AZ3* Ketika instans pertama dalam klaster dibuat, ini adalah instans primer dan terletak di salah satu Availability Zone. Dalam contoh ini, ada di *AZ1*. Instance kedua yang dibuat adalah instance replika dan terletak di salah satu dari dua Availability Zone lainnya, katakanlah *AZ2*. Instance ketiga yang dibuat adalah instance replika dan terletak di Availability Zone yang tersisa, *AZ3*. Jika Anda membuat lebih banyak instans, mereka didistribusikan di seluruh Availability Zone sehingga Anda mencapai keseimbangan dalam klaster. Jika kegagalan terjadi pada instance utama (AZ1), failover dipicu, dan salah satu replika yang ada dipromosikan ke primer. Ketika primer lama pulih, itu menjadi replika di Availability Zone yang sama di mana ia disediakan (). AZ1 Ketika Anda menyediakan tiga klaster instans, Amazon DocumentDB terus menjaga tiga instans klaster tersebut. Amazon DocumentDB secara otomatis menangani deteksi, failover, dan pemulihan kegagalan instans tanpa intervensi manual apa pun. Ketika Amazon DocumentDB melakukan failover dan memulihkan instans, instans yang dipulihkan tetap di Availability Zone di mana instans tersebut disediakan pada awalnya. Namun demikian, peran instans mungkin berubah dari primer ke replika. Melakukan hal ini akan mencegah skenario di mana serangkaian failover dapat mengakibatkan semua instans berada di Availability Zone yang sama. Anda dapat menentukan replika Amazon DocumentDB sebagai target failover. Artinya, jika instans primer gagal, replika Amazon DocumentDB yang ditentukan atau replika dari tingkat dipromosikan menjadi instans primer. Terdapat gangguan singkat selama permintaan baca dan tulis dibuat ke instans primer gagal dengan pengecualian. Jika klaster Amazon DocumentDB Anda tidak mencakup replika Amazon DocumentDB apa pun, ketika instans primer gagal, replika tersebut kembali dibuat. Mempromosikan replika Amazon DocumentDB jauh lebih cepat daripada membuat ulang instans primer. Untuk skenario dengan ketersediaan tinggi, kami sarankan Anda membuat satu atau lebih replika Amazon DocumentDB. Replika tersebut harus berasal dari kelas instans yang sama dengan instans primer dan dalam Availability Zone yang berbeda untuk klaster Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat berikut ini: + [Memahami toleransi kesalahan klaster Amazon DocumentDB](db-cluster-fault-tolerance.md) + [Failover Amazon DocumentDB](failover.md) + [Mengontrol target failover](failover.md#failover-target_control) ### Ketersediaan tinggi dengan cluster global Untuk ketersediaan tinggi di beberapa Wilayah AWS, Anda dapat mengatur klaster global [Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.html). Setiap cluster global mencakup beberapa wilayah, memungkinkan pembacaan global latensi rendah dan pemulihan bencana dari pemadaman di seluruh wilayah. Wilayah AWS Amazon DocumentDB secara otomatis menangani replikasi semua data dan pembaruan dari wilayah utama ke masing-masing wilayah sekunder. ## Menambahkan replika Instans pertama yang ditambahkan ke klaster adalah instans primer. Setiap instans yang ditambahkan setelah instans pertama adalah instans replika. Klaster dapat memiliki hingga 15 instans replika di samping instans primer. Ketika Anda membuat cluster menggunakan Konsol Manajemen AWS, instance utama secara otomatis dibuat pada saat yang sama. Untuk membuat replika pada saat yang sama seperti saat Anda membuat klaster dan instans primer, pilih **Membuat replika di zona yang berbeda**. Untuk informasi lebih lanjut, lihat langkah 4.d. di [Membuat cluster Amazon DocumentDB](db-cluster-create.md). Untuk menambahkan lebih banyak replika untuk klaster Amazon DocumentDB, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md). Saat menggunakan AWS CLI untuk membuat cluster Anda, Anda harus secara eksplisit membuat instance primer dan replika Anda. Untuk informasi lebih lanjut, lihat bagian “Menggunakan AWS CLI" dalam topik berikut: + [Membuat cluster Amazon DocumentDB](db-cluster-create.md) + [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) # Failover Amazon DocumentDB Dalam kasus tertentu, seperti jenis tertentu dari pemeliharaan yang direncanakan, atau peristiwa simpul primer yang tidak dimungkinkan node utama atau kegagalan Availability Zone, Amazon DocumentDB (dengan kompatibilitas MongoDB) mendeteksi kegagalan dan menggantikan simpul primer. Selama failover, penulisan waktu diminimalkan. Hal ini karena peran simpul primer tidak berhasil ke salah satu replika baca alih-alih harus membuat dan menyediakan simpul primer baru. Deteksi kegagalan dan promosi replika ini memastikan bahwa Anda dapat melanjutkan penulisan ke primer baru segera setelah promosi selesai. Agar failover berfungsi, klaster Anda harus memiliki setidaknya dua instans — primer dan setidaknya satu instans replika. **catatan** Topik ini hanya berlaku untuk cluster berbasis instans Amazon DocumentDB asli. Ini tidak berlaku untuk cluster elastis atau global. ## Mengontrol target failover Amazon DocumentDB menyediakan Anda dengan tingkatan failover sebagai sarana untuk mengontrol instans replika mana yang dipromosikan ke primer ketika terjadi failover. **Tingkatan Failover** Setiap instans replika berkaitan dengan tingkatan failover (0-15). Ketika failover terjadi akibat pemeliharaan atau kegagalan perangkat keras yang tidak dimungkinkan, instan utama tidak berhasil menjadi replika dengan prioritas tertinggi (tingkatan bernomor terendah). Jika beberapa replika memiliki tingkatan prioritas yang sama, primer tidak berhasil menjadi replika tingkatan tersebut yang paling dekat dalam ukuran primer sebelumnya. Dengan menetapkan tingkatan failover untuk grup pilih replika menjadi `0` (prioritas tertinggi), Anda dapat memastikan bahwa failover akan mempromosikan salah satu replika dalam grup tersebut. Anda dapat secara efektif mencegah replika spesifik yang dipromosikan ke primer dalam kasus failover dengan menetapkan tingkatan prioritas rendah (nomor tinggi) untuk replika tersebut. Hal ini berguna dalam kasus di mana replika spesifik menerima penggunaan berat oleh aplikasi dan ketidakberhasilan untuk salah satu dari mereka akan berdampak negatif pada aplikasi kritis. Anda dapat mengatur tingkatan failover instans ketika Anda membuatnya atau kemudian dengan memodifikasinya. Menetapkan tingkatan failover instans dengan memodifikasi instans tidak memicu failover. Untuk informasi selengkapnya lihat topik berikut: + [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) + [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md) Ketika secara manual menginisiasi failover, Anda memiliki dua cara untuk mengontrol instans replika yang dipromosikan ke primer: tingkatan failover seperti yang diuraiakn sebelumnya, dan parameter `--target-db-instance-identifier`. **--`target-db-instance-identifier`** Untuk pengujian, Anda dapat memaksa peristiwa failover menggunakan operasi `failover-db-cluster`. Anda dapat menggunakan parameter `--target-db-instance-identifier` untuk menentukan replika mana yang akan dipromosikan ke primer. Menggunakan parameter `--target-db-instance-identifier` akan menggantikan tingkatan prioritas failover. Jika Anda tidak menentukan parameter `--target-db-instance-identifier`, failover primer adalah sesuai dengan tingkatan prioritas failover. ## Apa yang terjadi selama failover Failover secara otomatis ditangani oleh Amazon DocumentDB sehingga aplikasi Anda dapat melanjutkan operasi basis data secepat mungkin tanpa intervensi administratif. + Jika Anda memiliki instans replika Amazon DocumentDB di Availability Zone yang sama atau berbeda ketika terjadi failover: Amazon DocumentDB membalik catatan nama kanonik (CNAME) untuk instans Anda untuk menunjuk pada replika sehat, yang, pada gilirannya, dipromosikan untuk menjadi primer baru. Failover biasanya selesai dalam waktu 30 detik dari awal sampai akhir. + Jika Anda tidak memiliki instans replika Amazon DocumentDB (sebagai contoh, klaster instans tunggal): Amazon DocumentDB akan mencoba untuk membuat instans baru di Availability Zone yang sama seperti instans asli. Penggantian instans asli ini dilakukan atas dasar upaya terbaik dan mungkin tidak berhasil jika, sebagai contoh, terdapat masalah yang secara luas memengaruhi Availability Zone. Aplikasi Anda harus mencoba kembali koneksi basis data dalam peristiwa kehilangan koneksi. ## Menguji failover Failover untuk klaster mempromosikan salah satu replika Amazon DocumentDB (instans baca-saja) di klaster menjadi instans primer (penulis klaster). Ketika instans primer gagal, Amazon DocumentDB secara otomatis melakukan failover ke replika Amazon DocumentDB, jika ada. Anda dapat memaksa failover saat Anda ingin menyimulasikan kegagalan instans primer untuk pengujian. Setiap instans dalam klaster memiliki alamat titik akhir sendiri. Oleh karena itu, Anda perlu membersihkan dan membentuk kembali koneksi yang sudah ada yang menggunakan titik akhir tersebut yang ditujukan saat failover selesai. Untuk memaksa failover, gunakan operasi `failover-db-cluster` dengan parameter tersebut. + `--db-cluster-identifier`—Wajib. Nama kluster yang akan di-failover. + `--target-db-instance-identifier`—Opsional. Nama instans yang akan dipromosikan ke instans primer. **Example** Operasi berikut ini memaksa failover kluster `sample-cluster`. Operasi tersebut tidak menentukan instans mana yang akan menjadi instans primer baru, sehingga Amazon DocumentDB memilih instans sesuai dengan prioritas tingkatan failover. Untuk Linux, macOS, atau Unix: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster ``` Untuk Windows: ``` aws docdb failover-db-cluster ^ --db-cluster-identifier sample-cluster ``` Operasi berikut ini memaksa failover klaster `sample-cluster`, yang menentukan bahwa `sample-cluster-instance` akan dipromosikan menjadi peran primer. (Perhatikan `"IsClusterWriter": true` dalam keluaran.) Untuk Linux, macOS, atau Unix: ``` aws docdb failover-db-cluster \ --db-cluster-identifier sample-cluster \ --target-db-instance-identifier sample-cluster-instance ``` Untuk Windows: ``` aws docdb failover-db-cluster ^ --db-cluster-identifier sample-cluster ^ --target-db-instance-identifier sample-cluster-instance ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBCluster": { "HostedZoneId": "Z2SUY0A1719RZT", "Port": 27017, "EngineVersion": "3.6.0", "PreferredMaintenanceWindow": "thu:04:05-thu:04:35", "BackupRetentionPeriod": 1, "ClusterCreateTime": "2018-06-28T18:53:29.455Z", "AssociatedRoles": [], "DBSubnetGroup": "default", "MasterUsername": "master-user", "Engine": "docdb", "ReadReplicaIdentifiers": [], "EarliestRestorableTime": "2018-08-21T00:04:10.546Z", "DBClusterIdentifier": "sample-cluster", "ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com", "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-cluster-instance", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": true }, { "DBInstanceIdentifier": "sample-cluster-instance-00", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": false }, { "DBInstanceIdentifier": "sample-cluster-instance-01", "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1, "IsClusterWriter": false } ], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "DBClusterParameterGroup": "default.docdb3.6", "Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com", "IAMDatabaseAuthenticationEnabled": false, "AllocatedStorage": 1, "LatestRestorableTime": "2018-08-22T21:57:33.904Z", "PreferredBackupWindow": "00:00-00:30", "StorageEncrypted": false, "MultiAZ": true, "Status": "available", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-12345678" } ], "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ" } } ``` ## Replikasi lag Lag replikasi biasanya 50ms atau kurang. Alasan paling umum untuk peningkatan lag replika adalah: + Tingkat tulis yang tinggi pada primer yang menyebabkan replika baca jatuh di belakang primer. + Pertikaian pada replika baca antara kueri yang berjalan lama (misalnya, pindaian sekuensial besar, kueri agregasi) dan replikasi tulis yang masuk. + Jumlah kueri bersamaan yang sangat besar pada replika baca. Untuk meminimalkan lag replikasi, cobalah teknik pemecahan masalah ini: + Jika Anda memiliki tingkat tulis tinggi atau utilisasi CPU yang tinggi, kami sarankan Anda meningkatkan instans di klaster Anda. + Jika terdapat kueri yang berjalan lama pada replika baca Anda, dan sangat sering terdapat pembaruan untuk dokumen yang dikuerikan, pertimbangkan mengubah kueri yang berjalan lama Anda, atau jalankan mereka terhadap replika primer/tulis untuk menghindari perdebatan pada replika baca. + Jika terdapat jumlah kueri bersamaan yang sangat besar atau utilisasi CPU yang tinggi hanya pada replika baca, pilihan lainnya adalah untuk menskalakan keluar jumlah replika baca untuk menyebarkan beban kerja. + Karena kelambatan replikasi adalah hasil dari throughput penulisan yang tinggi dan kueri yang berjalan lama, kami merekomendasikan pemecahan masalah lag replikasi dengan memanfaatkan metrik DBCluster ReplicaLagMaximum CW dalam kombinasi dengan logger kueri lambat dan metrik/. `WriteThroughput` `WriteIOPS` Secara umum, kami menyarankan bahwa semua replika Anda adalah dari tipe instans yang sama, sehingga failover klaster tidak akan menyebabkan penurunan performa. Jika Anda memilih antara menaikkan skala dan menskalakan keluar (misalnya enam instans yang lebih kecil vs tiga instans yang lebih besar), kami umumnya merekomendasikan untuk pertama-tama mencoba menaikkan skala (instans yang lebih besar) sebelum menskalakan keluar, karena Anda akan mendapatkan cache buffer yang lebih besar per instans DB. Secara proaktif, Anda harus mengatur alarm lag replikasi dan mengatur ambang batasnya untuk nilai yang Anda rasa merupakan batas atas untuk seberapa jauh dapat meninggalkan (atau “menahan”) data Anda pada instans replika sebelum mulai memengaruhi fungsionalitas aplikasi Anda. Secara umum, kami akan menyarankan bahwa ambang batas lag replikasi terlampaui untuk beberapa titik data sebelum menciptakan alarm, akibat beban kerja sementara. **catatan** Selain itu, kami sarankan Anda mengatur alarm lainnya untuk lag replikasi yang melebihi 10 detik. Jika Anda melampaui ambang batas ini untuk beberapa titik data, kami sarankan Anda menaikkan skala instans Anda atau mengurangi throughput tulis Anda pada instans primer. # Mengelola indeks Amazon DocumentDB **Topics** + [Pembuatan indeks Amazon DocumentDB](#index-creation) + [Mempertahankan indeks Amazon DocumentDB](#maintaining-indexes) ## Pembuatan indeks Amazon DocumentDB Membangun indeks di Amazon DocumentDB memerlukan sejumlah keputusan yang harus dibuat: + Seberapa cepat itu harus diselesaikan? + Bisakah koleksi tidak dapat diakses saat build sedang berlangsung? + Berapa banyak daya komputasi instans yang dapat dialokasikan ke build? + Jenis indeks apa yang harus dibuat? Bagian ini membantu Anda menjawab pertanyaan-pertanyaan ini dan memberikan perintah dan contoh pemantauan untuk membuat dan indeks Amazon DocumentDB pada koleksi cluster berbasis instans Anda. ### Pedoman Pedoman berikut mencakup batasan dasar dan pengorbanan konfigurasi saat membuat indeks baru: + Dukungan **versi Amazon DocumentDB** - Meskipun pengindeksan pekerja tunggal didukung di semua versi Amazon DocumentDB, beberapa pengindeksan pekerja hanya didukung di Amazon DocumentDB versi 4.0 dan 5.0. + **Trade-off kinerja** - Meningkatkan jumlah pekerja dalam proses pembuatan indeks meningkatkan pemanfaatan CPU dan membaca IO pada instance utama database Amazon DocumentDB Anda. Sumber daya yang dibutuhkan untuk membuat indeks baru tidak akan tersedia untuk beban kerja Anda yang sedang berjalan. + **Cluster elastis - Pengindeksan** paralel tidak didukung pada cluster elastis Amazon DocumentDB. + **Pekerja maksimum** - Jumlah maksimum pekerja yang dapat Anda konfigurasi tergantung pada ukuran instance utama Anda di cluster database Anda. Ini adalah setengah jumlah total v CPUs pada contoh utama cluster database Anda. Misalnya, Anda dapat menjalankan maksimal 32 pekerja pada instance db.r6g.16xlarge yang memiliki 64 v. CPUs **catatan** Pekerja paralel tidak didukung pada kelas instance 2xlarge dan lebih rendah. + **Pekerja minimum** - Jumlah minimum pekerja yang dapat Anda konfigurasi adalah satu. Pengaturan default untuk pembuatan indeks pada cluster berbasis instance adalah dua pekerja. Namun, Anda dapat mengurangi jumlah pekerja menjadi satu dengan menggunakan opsi “utas pekerja”. Ini akan menjalankan proses dengan satu pekerja. + **Kompresi indeks** - Amazon DocumentDB tidak mendukung kompresi indeks. Ukuran data untuk indeks mungkin lebih besar daripada saat Anda menggunakan opsi lain. + **Mengindeks beberapa koleksi** - Setengah v CPUs pada instance utama cluster database Anda dapat digunakan untuk pekerja yang dikonfigurasi yang melakukan pembuatan indeks pada beberapa koleksi. + **Jenis indeks** - Lihat [posting blog ini](https://aws.amazon.com/blogs/database/how-to-index-on-amazon-documentdb-with-mongodb-compatibility/) untuk penjelasan lengkap tentang jenis indeks yang didukung di Amazon DocumentDB. ### Memulai Untuk memulai pembuatan indeks pada koleksi, gunakan `createIndexes` perintah. Secara default, perintah akan menjalankan dua pekerja paralel yang meningkatkan kecepatan proses pembuatan indeks sebanyak dua kali. Misalnya, proses perintah berikut menunjukkan cara membuat indeks untuk bidang “user\$1name” dalam dokumen dan meningkatkan kecepatan proses pengindeksan menjadi empat pekerja: 1. Buat indeks menggunakan dua pekerja paralel di cluster: ``` db.runCommand({"createIndexes":"test","indexes":[{"key": {"user_name":1}, "name":"username_idx"}]}) ``` 1. Untuk mengoptimalkan kecepatan proses pembuatan indeks, Anda dapat menentukan jumlah pekerja dengan menggunakan opsi “thread pekerja” (`"workers":`) dalam `db.runCommand createIndexes` perintah. Tingkatkan kecepatan proses menjadi empat pekerja paralel: ``` db.runCommand({"createIndexes":"test","indexes":[{"key": {"user_name":1}, "name":"username_idx", "workers":4}]}) ``` **catatan** Semakin tinggi jumlah pekerja, semakin cepat pembuatan indeks berlangsung. Namun, semakin tinggi jumlah pekerja meningkat, semakin tinggi beban meningkat pada v CPUs dan membaca IO dari instance utama Anda. Pastikan klaster Anda cukup disediakan untuk menangani beban yang meningkat tanpa menurunkan beban kerja lainnya. ### Status kemajuan pengindeksan Proses pembuatan indeks bekerja dengan menginisialisasi, memindai koleksi, menyortir kunci, dan, akhirnya, memasukkan kunci melalui pembuat indeks. Prosesnya memiliki hingga enam tahap saat Anda menjalankannya di latar depan, dan hingga sembilan tahap saat Anda menjalankannya di latar belakang. Anda dapat melihat metrik status seperti penyelesaian persentase, jumlah total blok penyimpanan yang dipindai, kunci yang diurutkan, dan kunci yang disisipkan berdasarkan tahap demi tahap. Pantau kemajuan proses pengindeksan dengan menggunakan `db.currentOp()` perintah di shell mongo. Penyelesaian 100% dari tahap terakhir menunjukkan bahwa semua indeks telah berhasil dibuat: ``` db.currentOp({"command.createIndexes": { $exists : true } }) ``` **catatan** Melihat status kemajuan pengindeksan hanya didukung di Amazon DocumentDB 5.0. #### Jenis build indeks Empat jenis build indeks adalah: + **Foreground** — Build indeks latar depan memblokir semua operasi database lainnya hingga indeks dibuat. Build latar depan Amazon DocumentDB terdiri dari lima tahap. + **Foreground (unique)** - Build indeks latar depan dokumen tunggal (unik) memblokir operasi database lain seperti build latar depan biasa. Berbeda dengan build latar depan dasar, build unik menggunakan tahap tambahan (kunci pengurutan 2) untuk mencari kunci duplikat. Build latar depan (unik) terdiri dari enam tahap. + **Latar** Belakang - Build indeks latar belakang memungkinkan operasi database lainnya berjalan di latar depan saat indeks sedang dibuat. Build latar belakang Amazon DocumentDB terdiri dari delapan tahap. + **Latar Belakang (unik)** - Build indeks latar belakang dokumen tunggal (unik) memungkinkan operasi database lainnya berjalan di latar depan saat indeks sedang dibuat. Berbeda dengan build latar belakang dasar, build unik menggunakan tahap tambahan (kunci pengurutan 2) untuk mencari kunci duplikat. Build latar belakang (unik) terdiri dari sembilan tahap. #### Tahapan pembuatan indeks | Stage | Latar depan | Latar depan (unik) | Latar Belakang | Latar Belakang (unik) | | --- | --- | --- | --- | --- | | Inisialisasi | 1 | 1 | 1 | 1 | | indeks bangunan: menginisialisasi | 2 | 2 | 2 | 2 | | indeks bangunan: koleksi pemindaian | 3 | 3 | 3 | 3 | | indeks bangunan: kunci penyortiran 1 | 4 | 4 | 4 | 4 | | indeks bangunan: kunci penyortiran 2 | | 5 | | 5 | | indeks bangunan: memasukkan kunci | 5 | 6 | 5 | 6 | | memvalidasi: indeks pemindaian | | | 6 | 7 | | memvalidasi: menyortir tupel | | | 7 | 8 | | memvalidasi: koleksi pemindaian | | | 8 | 9 | + **inisialisasi** - createIndex sedang mempersiapkan pembuat indeks. Fase ini harus sangat singkat. + **indeks bangunan: menginisialisasi** - Pembangun indeks sedang mempersiapkan untuk membuat indeks. Fase ini harus sangat singkat. + **indeks bangunan: koleksi pemindaian** - Pembuat indeks melakukan pemindaian koleksi untuk mengumpulkan kunci indeks. Satuan ukuran adalah “blok”. **catatan** Jika lebih dari satu pekerja dikonfigurasi untuk build indeks, itu akan ditampilkan di tahap ini. Tahap “pengumpulan pemindaian” adalah satu-satunya tahap yang menggunakan banyak pekerja selama proses pembuatan indeks. Semua tahapan lainnya akan menampilkan satu pekerja. + **indeks bangunan: kunci penyortiran 1** - Pembuat indeks menyortir kunci indeks yang dikumpulkan. Satuan ukuran adalah “kunci”. + **indeks bangunan: kunci penyortiran 2** - Pembuat indeks menyortir kunci indeks yang dikumpulkan yang sesuai dengan tupel mati. Fase ini hanya ada untuk bangunan indeks yang unik. Satuan ukuran adalah “kunci”. + **indeks bangunan: memasukkan kunci** - Pembuat indeks memasukkan kunci indeks ke dalam indeks baru. Satuan ukuran adalah “kunci”. + **memvalidasi: indeks pemindaian** - createIndex memindai indeks untuk menemukan kunci yang perlu divalidasi. Satuan ukuran adalah “blok”. + **memvalidasi: menyortir tupel** - createIndex menyortir output dari fase pemindaian indeks. + **memvalidasi: koleksi pemindaian** - createIndex memindai koleksi untuk memvalidasi kunci indeks yang ditemukan dalam dua fase sebelumnya. Satuan ukuran adalah “blok”. #### Contoh keluaran pembuatan indeks Pada contoh keluaran di bawah ini (pembuatan indeks latar depan), status pembuatan indeks ditampilkan. Bidang “msg” merangkum kemajuan build dengan menunjukkan tahapan dan persentase penyelesaian build. Bidang “pekerja” menunjukkan jumlah pekerja yang digunakan selama tahap pembuatan indeks tersebut. Bidang “kemajuan” menunjukkan angka aktual yang digunakan untuk menghitung persentase penyelesaian. **catatan** Bidang “currentIndexBuildNama”, “msg”, dan “kemajuan” tidak didukung di Amazon DocumentDB versi 4.0. ``` { "inprog" : [{ … "command": { "createIndexes": "test", "indexes": [{ "v": 2, "key": { "user_name": 1 }, "name": "user_name_1" }], "lsid": { "id": UUID(“094d0fba-8f41-4373-82c3-7c4c7b5ff13b”) }, "$db": "test" }, "currentIndexBuildName": user_name_1, "msg": "Index Build: building index number_1, stage 6/6 building index: 656860/1003520 (keys) 65%", "workers": 1, "progress": { "done": 656861, "total": 1003520 }, … ], "ok" : 1 } ``` ## Mempertahankan indeks Amazon DocumentDB **Topics** + [Bloat indeks](#db-index-bloat) + [Pemeliharaan indeks menggunakan `reIndex`](#reIndex) ### Bloat indeks Amazon DocumentDB menggunakan Multi-Version Concurrency Concurrency Control (MVCC) untuk mengelola transaksi bersamaan. Ketika dokumen dihapus atau diperbarui, versi sebelumnya tetap dalam koleksi dan indeks sebagai versi “mati”. Proses pengumpulan sampah secara otomatis merebut kembali ruang dari versi mati ini untuk operasi masa depan. Index bloat terjadi ketika indeks koleksi menjadi lebih besar karena akumulasi entri indeks mati atau usang atau fragmentasi dalam halaman. Persentase yang dilaporkan mewakili jumlah ruang indeks yang dapat digunakan oleh entri indeks future. Bloat ini menghabiskan ruang di cache buffer dan penyimpanan. Jika Anda ingin menghapus kembung, Anda perlu membangun kembali indeks. **Example Contoh** Jalankan perintah berikut untuk menentukan penyimpanan yang tidak digunakan untuk indeks Anda: ``` db.coll.aggregate({$indexStats:{}}); ``` Hasilnya terlihat mirip dengan ini: ``` { "name" : "_id_", "key" : { "_id" : 1 }, "host" : "devbox-test.localhost.a2z.com:27317", "size" : NumberLong(827392), "accesses" : { "ops" : NumberLong(40000), "docsRead" : NumberLong(46049), "since" : ISODate("2025-04-03T21:44:51.251Z") }, "cacheStats" : { "blksRead" : NumberLong(264), "blksHit" : NumberLong(140190), "hitRatio" : 99.8121 }, "unusedStorageSize" : { "unusedSizeBytes" : 409600, "unusedSizePercent" : 49.51 } } ``` Anda dapat membangun kembali indeks tanpa downtime menggunakan `reIndex` perintah, yang memerlukan pemindaian seluruh koleksi. Lihat [Pemeliharaan indeks menggunakan `reIndex`](#reIndex). ### Pemeliharaan indeks menggunakan `reIndex` `reIndex`adalah perintah yang digunakan untuk membangun kembali indeks. Hal ini biasanya digunakan ketika indeks telah menjadi rusak atau tidak efisien. Seiring waktu, indeks dapat mengakumulasi ruang yang tidak terpakai karena banyak pembaruan, penyisipan, atau penghapusan, yang menyebabkan kinerja menurun. Pengindeksan ulang membantu menghilangkan ruang yang tidak terpakai dan mengembalikan efisiensi indeks. #### `reIndex`pedoman + `reIndex`hanya didukung di Amazon DocumentDB 5.0. + Amazon DocumentDB `reindex` mendukung indeks tunggal di latar belakang, memungkinkan untuk beberapa pekerja. Indeks lama dapat digunakan oleh kueri saat `reIndex` proses berjalan. + Amazon DocumentDB mendukung pengindeksan laporan kemajuan melalui. `currentOp` Anda dapat melihat tahapan pembuatan indeks yang mirip dengan yang [Tahapan pembuatan indeks](#index-build-stages) dilihat selama pembuatan indeks. Satu-satunya perbedaan adalah bahwa `reIndex` selalu memiliki delapan tahap, terlepas dari apakah itu unik atau tidak. Tidak ada tahap “indeks bangunan: kunci pengurutan 2". + `reIndex`dapat berjalan bersamaan dengan perintah apa pun kecuali perintah terkait indeks pada koleksi yang sama:`createIndexes`,,`dropIndexes`, `collMod` dan. `renameCollection` + `reIndex`saat ini tidak didukung untuk teks, geospasial, vektor, dan indeks sebagian. ##### `reIndex`membangun Gunakan perintah berikut untuk membangun kembali indeks Anda: ``` db.runCommand({ reIndex: "collection-name", index: "index-name"}) ``` Secara opsional, Anda juga dapat mengontrol jumlah pekerja yang ditugaskan untuk proses pembangunan kembali: ``` db.runCommand({ reIndex: "collection-name", index: "index-name", workers: number }) ``` # Mengelola kompresi dokumen tingkat koleksi Kompresi dokumen tingkat koleksi Amazon DocumentDB 5.0 memungkinkan Anda menurunkan biaya penyimpanan dan IO dengan mengompresi dokumen dalam koleksi Anda. Anda dapat mengaktifkan kompresi dokumen pada tingkat pengumpulan dan melihat metrik kompresi sesuai kebutuhan dengan mengukur keuntungan penyimpanan melalui metrik kompresi seperti ukuran penyimpanan dokumen terkompresi dan status kompresi. Amazon DocumentDB 5.0 menggunakan algoritma kompresi LZ4 untuk mengompres dokumen. Amazon DocumentDB mendukung kompresi dokumen yang dimulai dengan versi 5.0. Berikut ini adalah fungsi kompresi dokumen tingkat koleksi: + **Perilaku default** - Pengaturan kompresi default untuk koleksi baru pada klaster 5.0 ditentukan oleh parameter cluster`default_collection_compression`. Parameter ini diatur ke “dinonaktifkan” secara default. + **Mengompresi koleksi yang ada** - Pengaturan kompresi untuk koleksi yang ada dapat diubah menggunakan `collMod` perintah. + **Mengubah ambang kompresi - Ambang** kompresi default adalah 2KB. Nilai ini dapat ditentukan untuk koleksi baru menggunakan `createCollection` perintah, dan diubah untuk koleksi yang ada menggunakan `collMod` perintah. **catatan** Kompresi dokumen Amazon DocumentDB tidak didukung di Amazon DocumentDB versi 3.6 dan 4.0. **Topics** + [Mengelola kompresi dokumen](#manage-compression) + [Memantau kompresi dokumen](#monitoring-compression) ## Mengelola kompresi dokumen ### Mengaktifkan kompresi dokumen dalam koleksi Aktifkan kompresi dokumen saat membuat koleksi di Amazon DocumentDB 5.0 dengan menggunakan metode: `db.createCollection()` ``` db.createCollection( sample_collection,{ storageEngine : { documentDB: { compression:{enable: } } } }) ``` ### Mengaktifkan kompresi dokumen dalam sebuah cluster Kompresi dokumen dapat diaktifkan secara default untuk semua koleksi baru pada tingkat cluster dengan mengatur parameter cluster `default_collection_compression` ke “enabled”. Ketika parameter ini diatur ke “diaktifkan”, koleksi yang baru dibuat di cluster akan mengaktifkan kompresi secara default dengan ambang kompresi 2 KB. ### Mengompresi koleksi yang ada Anda juga dapat memodifikasi pengaturan kompresi untuk koleksi yang ada menggunakan `collMod` operasi dan menentukan `storageEngine` konfigurasi berikut. Harap dicatat bahwa perubahan yang dilakukan menggunakan perintah ini hanya akan berlaku untuk inserted/updated dokumen baru dan kompresi pada dokumen yang dimasukkan sebelumnya tidak akan berubah. ``` db.runCommand({ collMod: "orders", storageEngine: { documentDB: {compression: {enable: } } } }) ``` ### Mengatur ambang kompresi Secara default, ambang kompresi untuk koleksi terkompresi adalah 2032 byte. Nilai ambang batas ini dapat diatur dalam `createCollection` perintah saat membuat koleksi baru dengan kompresi diaktifkan: ``` db.createCollection( sample_collection, { storageEngine : { documentDB: { compression: { enable: true, threshold: <128 - 8000> } } } }) ``` Anda juga dapat memodifikasi ambang kompresi untuk koleksi terkompresi yang ada menggunakan `collMod` operasi dan menentukan konfigurasi berikut: `storageEngine` ``` db.runCommand({ collMod: "orders", storageEngine: { documentDB: { compression: { enable: true, threshold: <128 - 8000> } } } }) ``` Harap dicatat bahwa ambang kompresi hanya dapat diatur ke nilai antara 128 hingga 8000 byte. Selain itu, `enable` opsi perlu disetel ke “true” saat menentukan ambang kompresi. ## Memantau kompresi dokumen Anda dapat memeriksa apakah koleksi dikompresi dan menghitung rasio kompresi sebagai berikut. Lihat statistik kompresi dengan menjalankan `db.collection.stats()` perintah `db.printCollectionStats()` or dari shell mongo. Output menunjukkan ukuran asli dan ukuran terkompresi yang dapat Anda bandingkan untuk menganalisis keuntungan penyimpanan dari kompresi dokumen. Dalam contoh ini, statistik untuk koleksi bernama “sample\$1collection” ditunjukkan di bawah ini. Faktor penskalaan 1024\$1 1024 digunakan di bawah ini untuk menampilkan nilai dan dalam `size` MB. `storageSize` ``` db.sample_collection.stats(1024*1024) ``` Berikut ini adalah contoh output untuk perintah di atas: ``` { "ns" : "test.sample_collection", "count" : 1000000, "size" : 3906.3, "avgObjSize" : 4096, "storageSize" : 1953.1, compression:{"enabled" : true,"threshold" : 2032}, ... } ``` + **ukuran** - Ukuran asli dari koleksi dokumen. + **avgObjSize**- Ukuran dokumen rata-rata sebelum kompresi dibulatkan ke desimal pertama. Satuan ukuran adalah byte. + **StorageSize** - Ukuran penyimpanan koleksi setelah kompresi. Satuan ukuran adalah byte. + **diaktifkan** - Menunjukkan jika kompresi diaktifkan atau dinonaktifkan. Untuk menghitung rasio kompresi aktual, bagi ukuran koleksi dengan ukuran penyimpanan (Size/StorageSize). Untuk contoh di atas, perhitungannya adalah 3906.3/1953.1 yang diterjemahkan menjadi rasio kompresi 2:1. # Mengelola kompresi berbasis kamus di Amazon DocumentDB 8.0 Amazon DocumentDB 8.0 memperkenalkan algoritma kompresi dokumen baru, zstd, sebagai alternatif yang ditingkatkan untuk. LZ4 Saat Anda mengaktifkan kompresi kamus pada koleksi Amazon DocumentDB 8.0 dengan memilih Zstd sebagai algoritma kompresi, dokumen dari koleksi Anda diambil sampelnya untuk membuat kamus kompresi kustom. Dokumen baru dan yang diperbarui dikompresi menggunakan kamus ini dan algoritma zstd. Pendekatan ini biasanya mencapai rasio kompresi yang lebih tinggi daripada metode kompresi standar, terutama untuk koleksi dengan skema dokumen yang konsisten atau nama bidang berulang. Lz4 adalah algoritma yang dirancang untuk kompresi dan dekompresi cepat. Hal ini dikenal ringan pada CPU sambil mencapai kompresi yang nyata. Zstd adalah algoritma tujuan umum yang dengan pengaturan default menggunakan lebih banyak CPU tetapi mencapai rasio kompresi yang lebih baik daripada lz4. Penggunaan kamus meningkatkan kompresi lebih jauh untuk sebagian besar dokumen JSON. Beberapa manfaat dari algoritma Zstd adalah: + Mengurangi Biaya Penyimpanan: Rasio kompresi yang lebih tinggi berarti penggunaan penyimpanan yang lebih sedikit dan biaya yang lebih rendah. + Lebih rendahI/O: Compressed documents require less I/O, berpotensi meningkatkan kinerja. + Dioptimalkan untuk koleksi Anda: Kamus dilatih khusus untuk pola data koleksi Anda. **catatan** Kompresi berbasis kamus tidak didukung di Amazon DocumentDB versi 3.6, 4.0, dan 5.0. ## Pertimbangan Kinerja Kompresi Zstd melibatkan trade-off berikut: + Penyimpanan vs CPU: Kompresi Zstd mencapai rasio kompresi yang lebih baik tetapi mungkin menggunakan sumber daya CPU yang sedikit lebih banyak dibandingkan dengan kompresi. LZ4 + Kompresi Awal: Koleksi baru mungkin tidak mencapai kompresi optimal sampai cukup dokumen dimasukkan untuk melatih kamus yang efektif. Saat ini, kamus dilatih jika koleksi setidaknya 100 dokumen. + Jenis Beban Kerja: Beban kerja intensif baca di mana seluruh data masuk ke dalam cache buffer mungkin mengalami peningkatan latensi dan penggunaan CPU karena overhead dekompresi. Kompresi Zstd sangat efektif untuk koleksi dengan dokumen kecil, array dokumen dan nama bidang berulang. ## Mengaktifkan kompresi berbasis kamus Untuk koleksi baru Anda dapat menggunakan perintah di bawah ini untuk mengaktifkan kompresi Zstd: ``` db.createCollection("myCollection", { storageEngine: { documentDB: { compression: { enable: true, algorithm: "zstd" } } } } ) ``` Anda juga dapat mengaktifkan atau memodifikasi kompresi pada koleksi yang ada: ``` db.runCommand({ collMod: "myCollection", storageEngine: { documentDB: { compression: { enable: true, algorithm: "zstd" } } } }) ``` Untuk mengaktifkan algoritma Zstd di semua koleksi di cluster Anda, Anda dapat memodifikasi grup parameter cluster untuk memilih “zstd” sebagai nilai untuk parameter “default\$1collection\$1compression”. ## Memulai Amazon DocumentDB 8.0 hadir dengan kompresi Zstd diaktifkan secara default. Anda selalu dapat mematikannya dengan menyetel nilai 'default\$1compression' menjadi dinonaktifkan di grup parameter cluster Anda. Perlu dicatat bahwa dimulai dengan Amazon DocumentDB 8.0, 'enabled' bukan lagi pilihan yang valid untuk default\$1compression, dan Anda harus memilih dari Zstd dan. LZ4 ## Memantau Anda dapat melihat informasi kompresi untuk koleksi menggunakan salah satu perintah berikut: + db.runCommand (\$1collStats: “myCollection”\$1) ATAU + db.collection.stats () Perintah ini mengembalikan statistik kunci yang dapat Anda gunakan untuk menghitung rasio kompresi: + compression.algorithm: Algoritma yang digunakan (“lz4" atau “zstd”) + StorageSize: Penyimpanan aktual yang digunakan oleh koleksi, setelah kompresi. Perhatikan bahwa nomor ini mencakup fragmentasi (yaitu, ruang yang tidak digunakan di halaman database) + avgObjSize: Ukuran logis rata-rata dari dokumen koleksi, didekompresi. Perhatikan bahwa jika koleksi Anda memiliki lebih dari 20k dokumen, nomor ini akan menjadi perkiraan berdasarkan sampel 20k dokumen. + ukuran: Ukuran logis dari koleksi tanpa kompresi. Jumlah ini diperoleh dengan mengalikan avgObjSize dengan jumlah total dokumen dalam koleksi, jadi jika avgObjSize merupakan perkiraan, angka ini juga akan menjadi perkiraan. + hitung: Jumlah dokumen dalam koleksi CloudWatch Metrik berikut dapat membantu saat mengevaluasi kompresi berbasis kamus: + CPUUtilization + FreeableMemory + VolumeBytesUsed + VolumeReadIOPs + VolumeWriteIOPs Metrik CollStats: + storageSize + ukuran Selain itu, dapat berguna untuk melacak metrik khusus untuk aplikasi Anda, seperti latensi dan throughput per jenis kueri atau API. # Mengelola acara Amazon DocumentDB Amazon DocumentDB (dengan kompabilitas MongoDB) menyimpan catatan peristiwa yang terkait dengan klaster, instans, snapshot, grup keamanan, dan grup parameter klaster Anda. Informasi ini mencakup tanggal dan waktu acara, nama sumber dan jenis sumber acara, dan pesan yang terkait dengan acara tersebut. **penting** Untuk fitur pengelolaan tertentu, Amazon DocumentDB menggunakan teknologi operasional yang dibagi dengan Amazon RDS dan Amazon Neptune. Batas wilayah, batas yang diatur di tingkat Wilayah, dibagi antara Amazon DocumentDB, Amazon RDS, dan Amazon Neptune. Untuk informasi selengkapnya, lihat [Kuota regional](limits.md#limits-regional_quotas). **Topics** + [Melihat kategori acara Amazon DocumentDB](#viewing-event-categories) + [Melihat acara Amazon DocumentDB](#viewing-events) ## Melihat kategori acara Amazon DocumentDB Setiap jenis sumber daya Amazon DocumentDB memiliki jenis kejadian tertentu yang dapat dikaitkan dengannya. Anda dapat menggunakan AWS CLI `describe-event-categories` operasi untuk melihat pemetaan antara jenis peristiwa dan jenis sumber daya Amazon DocumentDB. **Parameter** + **--source-type**—Opsional. Gunakan parameter `--source-type` untuk melihat kategori kejadian pada jenis sumber tertentu. Nilai berikut diizinkan: + `db-cluster` + `db-instance` + `db-parameter-group` + `db-security-group` + `db-cluster-snapshot` + **--filters**—Opsional. Untuk menampilkan kategori peristiwa hanya untuk Amazon DocumentDB, gunakan filter `--filter Name=engine,Values=docdb`. **Example** Kode berikut mencantumkan kategori peristiwa yang terkait dengan klaster. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-event-categories \ --filter Name=engine,Values=docdb \ --source-type db-cluster ``` Untuk Windows: ``` aws docdb describe-event-categories ^ --filter Name=engine,Values=docdb ^ --source-type db-cluster ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "EventCategoriesMapList": [ { "EventCategories": [ "notification", "failure", "maintenance", "failover" ], "SourceType": "db-cluster" } ] } ``` Kode berikut mencantumkan kategori peristiwa yang terkait dengan setiap jenis sumber Amazon DocumentDB. ``` aws docdb describe-event-categories ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "EventCategoriesMapList": [ { "SourceType": "db-instance", "EventCategories": [ "notification", "failure", "creation", "maintenance", "deletion", "recovery", "restoration", "configuration change", "read replica", "backtrack", "low storage", "backup", "availability", "failover" ] }, { "SourceType": "db-security-group", "EventCategories": [ "configuration change", "failure" ] }, { "SourceType": "db-parameter-group", "EventCategories": [ "configuration change" ] }, { "SourceType": "db-cluster", "EventCategories": [ "notification", "failure", "maintenance", "failover" ] }, { "SourceType": "db-cluster-snapshot", "EventCategories": [ "backup" ] } ] } ``` ## Melihat acara Amazon DocumentDB Anda dapat mengambil kejadian untuk sumber daya Amazon DocumentDB Anda melalui konsol Amazon DocumentDB, yang menampilkan kejadian selama 24 jam terakhir. Anda juga dapat mengambil peristiwa untuk resource Amazon DocumentDB Anda dengan [menggunakan](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) AWS CLI perintah describe-events, atau [DescribeEvents](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeEvents.html)operasi Amazon DocumentDB API. Jika Anda menggunakan AWS CLI atau Amazon DocumentDB API untuk melihat peristiwa, Anda dapat mengambil peristiwa hingga 14 hari terakhir. ------ #### [ Using the Konsol Manajemen AWS ] **Untuk menampilkan semua acara instans Amazon DocumentDB selama 24 jam terakhir** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Peristiwa**. Peristiwa yang tersedia akan muncul dalam daftar. 1. Gunakan daftar **Filter** untuk menyelekasi peristiwa menurut jenisnya. Masukkan suatu istilah dalam kotak teks untuk menyeleksi hasil Anda lebih lanjut. Misalnya, cuplikan layar berikut menunjukkan pemfilteran semua peristiwa Amazon DocumentDB untuk peristiwa *snapshot*. ![\[Bagian cuplikan layar peristiwa yang menampilkan filter peristiwa untuk snapshot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/events-filtering.png) ------ #### [ Using the AWS CLI ] **Untuk menampilkan semua peristiwa instans Amazon DocumentDB selama 7 hari terakhir** Anda dapat melihat semua kejadian instans Amazon DocumentDB selama 7 hari terakhir dengan menjalankan operasi AWS CLI deskripsi-peristiwa dengan parameter disetel [ke](https://docs.aws.amazon.com/cli/latest/reference/docdb/describe-events.html) (10.080 `--duration` menit). `10080` ``` aws docdb describe-events --duration 10080 ``` **Pemfilteran untuk Acara Amazon DocumentDB** Untuk menampilkan peristiwa Amazon DocumentDB tertentu, gunakan operasi `describe-events` dengan parameter berikut. **Parameter** + **--filter**—Diperlukan untuk membatasi nilai yang ditampilkan ke peristiwa Amazon DocumentDB. Gunakan **Name=engine,Values=docdb** untuk memfilter semua peristiwa untuk Amazon DocumentDB saja. + **--source-identifier**—Opsional. Pengidentifikasi sumber peristiwa yang akan menerima peristiwa tersebut. Jika dihilangkan, peristiwa dari semua sumber disertakan ke dalam hasilnya. + **--source-type**—Opsional, jika `--source-identifier` tidak disediakan, maka ini diperlukan. Jika `--source-identifier` disediakan, `--source-type` harus setuju dengan jenis `--source-identifier`. Nilai berikut diizinkan: + `db-cluster` + `db-instance` + `db-parameter-group` + `db-security-group` + `db-cluster-snapshot` Contoh berikut mencantumkan semua persitiwa Amazon DocumentDB Anda. ``` aws docdb describe-events --filters Name=engine,Values=docdb ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "Events": [ { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3", "Message": "instance created", "SourceType": "db-instance", "Date": "2018-12-11T21:17:40.023Z", "SourceIdentifier": "sample-cluster-instance3", "EventCategories": [ "creation" ] }, { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23", "Message": "instance shutdown", "SourceType": "db-instance", "Date": "2018-12-11T21:25:01.245Z", "SourceIdentifier": "docdb-2018-12-11-21-08-23", "EventCategories": [ "availability" ] }, { "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23", "Message": "instance restarted", "SourceType": "db-instance", "Date": "2018-12-11T21:25:11.441Z", "SourceIdentifier": "docdb-2018-12-11-21-08-23", "EventCategories": [ "availability" ] } ] } ``` ------ Untuk informasi selengkapnya, lihat [Mengaudit acara Amazon DocumentDB](event-auditing.md). # Memilih wilayah dan zona ketersediaan Sumber daya komputasi cloud Amazon di-host di beberapa lokasi di seluruh dunia. Lokasi ini terdiri dari Wilayah AWS dan Availability Zones. Setiap *Wilayah AWS* adalah wilayah geografis yang terpisah. Setiap Wilayah memiliki beberapa lokasi terisolasi yang dikenal sebagai *Availability Zone*. Amazon DocumentDB memberi Anda kemampuan untuk menempatkan sumber daya, seperti instans, dan data di beberapa lokasi. Sumber daya tidak direplikasi Wilayah AWS kecuali Anda melakukannya secara khusus. Amazon mengoperasikan pusat data yang canggih dan sangat tersedia. Meskipun jarang terjadi, kegagalan dapat terjadi yang memengaruhi ketersediaan instans yang berada di lokasi yang sama. Jika Anda menghosting semua instans Anda di satu lokasi yang terpengaruh oleh kegagalan tersebut, tidak ada instans Anda yang akan tersedia. Diagram berikut menunjukkan Wilayah AWS dengan tiga Availability Zones. ![\[Diagram Wilayah yang berisi tiga Availability Zone a, b, dan c.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/RegionsAndAZs.png) Penting untuk diingat bahwa setiap Wilayah adalah independen. Aktivitas Amazon DocumentDB apa pun yang Anda mulai (misalnya, membuat instans atau membuat daftar instans yang tersedia) hanya berjalan di Wilayah AWS default Anda saat ini. Anda dapat mengubah Wilayah default di konsol tersebut dengan mengatur variabel lingkungan `EC2_REGION`. Atau Anda dapat menimpanya dengan menggunakan parameter `--region` di AWS CLI. Untuk informasi selengkapnya, lihat [Mengkonfigurasi AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html), secara khusus, bagian tentang variabel lingkungan dan opsi baris perintah. Saat Anda membuat klaster menggunakan konsol Amazon DocumentDB, dan Anda memilih untuk membuat replika di Availability Zone yang berbeda, Amazon DocumentDB membuat dua instans. Ini membuat instans primer di satu Availability Zone dan instans replika di Availability Zone yang berbeda. Volume klaster selalu direplikasi di tiga Availability Zone. Untuk membuat atau bekerja dengan instans Amazon DocumentDB secara Wilayah AWS spesifik, gunakan titik akhir layanan regional yang sesuai. ## Ketersediaan wilayah Amazon DocumentDB tersedia di Wilayah berikut. AWS **Wilayah yang didukung oleh Amazon DocumentDB** | Nama Wilayah | Region | Availability Zone (penghitungan) | | --- | --- | --- | | AS Timur (Ohio) | `us-east-2` | 3 | | AS Timur (Virginia Utara) | `us-east-1` | 6 | | AS Barat (Oregon) | `us-west-2` | 4 | | Africa (Cape Town) | `af-south-1` | 3 | | Amerika Selatan (Sao Paulo) | `sa-east-1` | 3 | | Asia Pasifik (Hong Kong) | `ap-east-1` | 3 | | Asia Pasifik (Hyderabad) | `ap-south-2` | 3 | | Asia Pasifik (Malaysia) | `ap-southeast-5` | 3 | | Asia Pasifik (Mumbai) | `ap-south-1` | 3 | | Asia Pasifik (Osaka) | `ap-northeast-3` | 3 | | Asia Pasifik (Seoul) | `ap-northeast-2` | 4 | | Asia Pasifik (Singapura) | `ap-southeast-1` | 3 | | Asia Pasifik (Sydney) | `ap-southeast-2` | 3 | | Asia Pasifik (Jakarta) | `ap-southeast-3` | 3 | | Asia Pacific (Melbourne) | `ap-southeast-4` | 3 | | Asia Pasifik (Thailand) | `ap-southeast-7` | 3 | | Asia Pasifik (Tokyo) | `ap-northeast-1` | 3 | | Kanada (Pusat) | `ca-central-1` | 3 | | Wilayah Tiongkok (Beijing) | `cn-north-1` | 3 | | Tiongkok (Ningxia) | `cn-northwest-1` | 3 | | Eropa (Frankfurt) | `eu-central-1` | 3 | | Europe (Zurich) | `eu-central-2` | 3 | | Eropa (Irlandia) | `eu-west-1` | 3 | | Eropa (London) | `eu-west-2` | 3 | | Europe (Milan) | `eu-south-1` | 3 | | Eropa (Paris) | `eu-west-3` | 3 | | Eropa (Spanyol) | `eu-south-2` | 3 | | Eropa (Stockholm) | `eu-north-1` | 3 | | Meksiko (Tengah) | `mx-central-1` | 3 | | Timur Tengah (UAE) | `me-central-1` | 3 | | Israel (Tel Aviv) | `il-central-1` | 3 | | AWS GovCloud (AS-Barat) | `us-gov-west-1` | 3 | | AWS GovCloud (AS-Timur) | `us-gov-east-1` | 3 | Secara default, zona waktu untuk klaster Amazon DocumentDB adalah Universal Time Coordinated (UTC). Untuk informasi tentang menemukan titik akhir koneksi untuk klaster dan instans di wilayah tertentu, lihat [Memahami titik akhir Amazon DocumentDB](endpoints.md). # Mengelola grup parameter cluster Amazon DocumentDB Anda dapat mengelola konfigurasi mesin Amazon DocumentDB dengan menggunakan parameter dalam grup parameter klaster. *Grup parameter klaster* adalah kumpulan nilai konfigurasi Amazon DocumentDB yang mempermudah pengelolaan parameter klaster Amazon DocumentDB Anda. Grup parameter klaster bertindak sebagai kontainer untuk nilai konfigurasi mesin yang diterapkan ke semua instans dalam klaster. Bagian ini menjelaskan cara membuat, melihat, dan mengubah grup parameter klaster. Ini juga menunjukkan bagaimana Anda dapat menentukan grup parameter klaster mana yang dikaitkan dengan klaster tertentu. **Topics** + [Menjelaskan kelompok parameter cluster](cluster_parameter_groups-describe.md) + [Membuat kelompok parameter cluster](cluster_parameter_groups-create.md) + [Memodifikasi kelompok parameter cluster](cluster_parameter_groups-modify.md) + [Memodifikasi cluster untuk menggunakan kelompok parameter cluster yang disesuaikan](cluster_parameter_groups-modify_clusters.md) + [Menyalin kelompok parameter cluster](cluster_parameter_groups-copy.md) + [Menyetel ulang kelompok parameter cluster](cluster_parameter_groups-reset.md) + [Menghapus grup parameter cluster](cluster_parameter_groups-delete.md) + [Referensi parameter cluster](cluster_parameter_groups-list_of_parameters.md) # Menjelaskan grup parameter cluster Amazon DocumentDB Grup parameter `default` cluster dibuat secara otomatis saat Anda membuat klaster Amazon DocumentDB pertama di wilayah baru atau menggunakan mesin baru. Cluster berikutnya, yang dibuat di wilayah yang sama dan memiliki versi mesin yang sama, dibuat dengan grup parameter `default` cluster. **Topics** + [Menjelaskan rincian kelompok parameter cluster](#cluster_parameter_groups-describe_details) + [Menentukan kelompok parameter cluster](#cluster_parameter_groups-determine) + [Menentukan cluster dan instance yang terkait dengan grup parameter cluster](#cluster_parameter_groups-count) ## Menjelaskan detail grup parameter cluster Amazon DocumentDB Untuk menjelaskan rincian kelompok parameter cluster yang diberikan, selesaikan langkah-langkah berikut menggunakan Konsol Manajemen AWS atau AWS Command Line Interface (AWS CLI). ------ #### [ Using the Konsol Manajemen AWS ] **** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. **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. 1. Di panel **Grup parameter klaster** , pilih nama grup parameter yang ingin Anda lihat detailnya. 1. Halaman yang dihasilkan menunjukkan parameter grup parameter, aktivitas terbaru, dan tag. + Di bawah **Parameter klaster**, Anda dapat melihat nama parameter, nilai saat ini, nilai yang diizinkan, apakah parameter dapat dimodifikasi, jenis penerapannya, tipe data, dan deskripsinya. Anda dapat mengubah parameter individual dengan memilih parameter lalu memilih **Edit** di bagian **Parameter klaster**. Untuk informasi selengkapnya, lihat [Memodifikasi parameter cluster Amazon DocumentDB](cluster_parameter_groups-parameters.md). + Di bawah **Peristiwa terbaru**, Anda dapat melihat peristiwa terbaru untuk grup parameter ini. Anda dapat memfilter acara ini menggunakan bar pencarian di bagian ini. Untuk informasi selengkapnya, lihat [Mengelola acara Amazon DocumentDB](managing-events.md). + Di bawah **Tag**, Anda dapat melihat tag yang ada di grup parameter klaster ini. Anda dapat menambah atau menghapus tag dengan memilih **Edit** di bagian **Tag**. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon DocumentDB](tagging.md). ------ #### [ Using the AWS CLI ] Anda dapat menggunakan `describe-db-cluster-parameter-groups` AWS CLI perintah untuk melihat Amazon Resource Name (ARN), keluarga, deskripsi, dan nama grup parameter cluster tunggal atau semua grup parameter cluster yang Anda miliki untuk Amazon DocumentDB. Anda juga dapat menggunakan `describe-db-cluster-parameters` AWS CLI perintah untuk melihat parameter dan detailnya di dalam grup parameter cluster tunggal. + **--describe-db-cluster-parameter-groups** — Untuk melihat daftar semua grup parameter klaster dan detailnya. + **--db-cluster-parameter-group-name** – Opsional. Nama grup parameter klaster yang ingin Anda jelaskan. Jika parameter ini dihilangkan, semua grup parameter klaster akan dijelaskan. + **--describe-db-cluster-parameters** — Untuk membuat daftar semua parameter di dalam grup parameter dan nilainya. + **--db-cluster-parameter-group name** — Diperlukan. Nama grup parameter klaster yang ingin Anda jelaskan. **Example** Kode berikut mencantumkan hingga 100 grup parameter klaster dan ARN, keluarga, deskripsi, dan namanya. ``` aws docdb describe-db-cluster-parameter-groups ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0", "DBParameterGroupFamily": "docdb4.0", "Description": "Default cluster parameter group for docdb4.0", "DBClusterParameterGroupName": "default.docdb4.0" }, { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group", "DBParameterGroupFamily": "docdb4.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupName": "sample-parameter-group" } ] } ``` **Example** Kode berikut mencantumkan ARN, keluarga, deskripsi, dan nama untuk `sample-parameter-group`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name sample-parameter-group ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroups": [ { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group", "Description": "Custom docdb4.0 parameter group", "DBParameterGroupFamily": "docdb4.0", "DBClusterParameterGroupName": "sample-parameter-group" } ] } ``` **Example** Kode berikut mencantumkan nilai parameter dalam `sample-parameter-group`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "change_stream_log_retention_duration", "ParameterValue": "17777", "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.", "Source": "user", "ApplyType": "dynamic", "DataType": "integer", "AllowedValues": "3600-86400", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ ## Menentukan grup parameter cluster Amazon DocumentDB Untuk menentukan kelompok parameter mana yang terkait dengan cluster tertentu, selesaikan langkah-langkah berikut menggunakan Konsol Manajemen AWS atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi kiri, pilih **Klaster**. 1. Dalam daftar klaster, pilih nama klaster yang Anda minati. 1. Halaman yang dihasilkan menunjukkan detail klaster yang Anda pilih. Gulir ke bawah ke **Detail klaster**. Di bagian bawah bagian tersebut, temukan nama grup parameter di bawah **Grup parameter klaster**. ![\[Tangkapan layar: Menampilkan grup parameter klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png) ------ #### [ Using the AWS CLI ] AWS CLI Kode berikut menentukan kelompok parameter mana yang mengatur cluster`sample-cluster`. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]' ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` [ [ "sample-cluster", "sample-parameter-group" ] ] ``` ------ ## Menentukan cluster dan instance yang terkait dengan grup parameter cluster Amazon DocumentDB Untuk menentukan berapa banyak cluster dan instance yang terkait dengan setiap grup parameter, selesaikan langkah-langkah berikut menggunakan. AWS CLI ------ #### [ Using the AWS CLI ] AWS CLI Kode berikut menentukan berapa banyak cluster dan instance yang terkait dengannya. `sample-parameter-group` Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \ --output json | \ jq -r 'group_by(.[0]) | map({ parameter_group_name: .[0][0], total_clusters: length, total_instances: map(.[2] | length) | add // 0 }) | .[]' ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^ --output json | ^ jq -r 'group_by(.[0]) | map({ parameter_group_name: .[0][0], total_clusters: length, total_instances: map(.[2] | length) | add // 0 }) | .[]' ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "parameter_group_name": "sample-parameter-group", "total_clusters": 50, "total_instances": 150 } ``` ------ # Membuat grup parameter cluster Amazon DocumentDB Grup parameter cluster default seperti`default.docdb5.0`,`default.docdb4.0`, atau`default.docdb3.6`, dibuat saat Anda membuat klaster dengan versi mesin baru dan di wilayah baru. Cluster berikutnya dibuat di wilayah ini dan dengan versi mesin yang sama mewarisi grup parameter `default` cluster. Setelah dibuat, grup `default` parameter tidak dapat dihapus atau diganti namanya. Anda dapat memodifikasi perilaku engine instance cluster dengan membuat grup parameter kustom dengan nilai parameter pilihan dan melampirkannya ke cluster Amazon DocumentDB Anda. Prosedur berikut memandu Anda melalui pembuatan grup parameter cluster kustom. Anda kemudian dapat [mengubah parameter dalam grup parameter tersebut](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-modify.html). **catatan** Setelah Anda membuat grup parameter klaster, Anda harus menunggu setidaknya 5 menit sebelum menggunakan grup parameter tersebut. Ini memungkinkan Amazon DocumentDB untuk menyelesaikan tindakan `create` sepenuhnya sebelum grup parameter klaster digunakan untuk klaster baru. Anda dapat menggunakan Konsol Manajemen AWS atau `describe-db-cluster-parameter-groups` AWS CLI operasi untuk memverifikasi bahwa grup parameter cluster Anda telah dibuat. Untuk informasi selengkapnya, lihat [Menjelaskan grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-describe.md). ------ #### [ Using the Konsol Manajemen AWS ] **Untuk membuat grup parameter klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. **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. 1. Di panel **Grup parameter klaster**, pilih **Buat**. 1. Di panel **Buat grup parameter klaster**, masukkan berikut ini: 1. **Nama grup parameter cluster baru** - Masukkan nama untuk grup parameter cluster. Misalnya, `sample-parameter-group`. Grup parameter klaster memiliki batasan penamaan berikut: + Panjangnya [1–255] karakter alfanumerik. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. 1. **Keluarga** - Pilih versi DocumentDB yang ingin Anda gunakan untuk cluster Anda. 1. **Deskripsi** — Memberikan deskripsi untuk grup parameter klaster ini. 1. Untuk membuat grup parameter klaster, pilih **Buat**. Untuk membatalkan operasi, pilih **Batal**. 1. Setelah Anda memilih **Buat**, teks berikut akan muncul di bagian atas halaman untuk memverifikasi bahwa grup parameter klaster Anda telah berhasil dibuat: ``` Successfully created cluster parameter group 'sample-parameter-group'. ``` ------ #### [ Using the AWS CLI ] Untuk membuat grup parameter cluster baru untuk cluster Amazon DocumentDB 4.0, gunakan operasi AWS CLI `create-db-cluster-parameter-group` dengan parameter berikut: + **--db-cluster-parameter-group-name** — Nama grup parameter klaster kustom. Misalnya, `sample-parameter-group`. + **--db-cluster-parameter-group-family** — Keluarga grup parameter klaster yang digunakan sebagai templat untuk grup parameter klaster kustom. + **--description** — Deskripsi yang diberikan pengguna untuk grup parameter klaster ini. Contoh berikut menggunakan "`Custom docdb4.0 parameter group`”. Untuk Linux, macOS, atau Unix: **Example** ``` aws docdb create-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --db-parameter-group-family docdb5.0 \ --description "Custom docdb5.0 parameter group" ``` Untuk Windows: ``` aws docdb create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --db-parameter-group-family docdb5.0 ^ --description "Custom docdb5.0 parameter group" ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupName": "sample-parameter-group", "DBParameterGroupFamily": "docdb5.0", "Description": "Custom docdb4.0 parameter group", "DBClusterParameterGroupArn": "sample-parameter-group-arn" } } ``` ------ # Memodifikasi grup parameter cluster Amazon DocumentDB Bagian ini menjelaskan cara memodifikasi grup parameter Amazon DocumentDB *kustom*. Di Amazon DocumentDB, Anda tidak dapat memodifikasi `default` grup parameter cluster yang dibuat saat pertama kali membuat klaster dengan versi engine baru di wilayah baru. Jika klaster Amazon DocumentDB Anda menggunakan grup parameter klaster default dan Anda ingin mengubah nilai di dalamnya, Anda harus terlebih dahulu [ membuat grup parameter baru](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) atau [ menyalin grup parameter yang ada](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), memodifikasinya, lalu menerapkan grup parameter yang dimodifikasi ke klaster Anda. Selesaikan langkah-langkah berikut untuk memodifikasi grup parameter cluster kustom. Memodifikasi tindakan bisa memakan waktu beberapa saat untuk disebarkan. Harap tunggu grup paramater cluster yang dimodifikasi tersedia sebelum melampirkannya ke cluster Anda. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI `describe-db-cluster-parameters` operasi untuk memverifikasi bahwa grup parameter cluster Anda telah dimodifikasi. Untuk informasi selengkapnya, lihat [Menjelaskan kelompok parameter cluster](cluster_parameter_groups-describe.md). ------ #### [ Using the Konsol Manajemen AWS ] Ikuti langkah-langkah ini untuk mengubah grup parameter Amazon DocumentDB kustom. Anda tidak dapat mengubah grup parameter `default`. Jika Anda ingin mengubah nilai dalam grup parameter `default`, Anda dapat [menyalin grup parameter klaster default](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-copy.html), memodifikasinya, lalu menerapkan grup parameter yang dimodifikasi ke klaster Anda. Untuk informasi selengkapnya tentang menerapkan grup parameter ke klaster Anda, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). **Untuk mengubah grup parameter klaster kustom** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi di sisi kiri konsol tersebut, pilih **Grup parameter**. Dalam daftar grup parameter, pilih nama grup parameter yang ingin Anda ubah. **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. 1. Untuk setiap parameter dalam grup parameter yang ingin Anda ubah, lakukan hal berikut: 1. Temukan parameter yang ingin Anda ubah, dan verifikasi bahwa parameter tersebut dapat dimodifikasi dengan memeriksa apakah parameter tersebut terdaftar sebagai `true` di bawah kolom yang **Dapat dimodifikasi**. 1. Jika dapat dimodifikasi, pilih parameter dan pilih **Edit** dari kanan atas halaman konsol tersebut. 1. Dalam kotak dialog **Modifikasi ``**, buat perubahan yang Anda inginkan. Kemudian pilih **Ubah parameter klaster**, atau pilih **Batal** untuk membuang perubahan. ------ #### [ Using the AWS CLI ] Anda dapat memodifikasi `ParameterValue`, `Description`, atau `ApplyMethod` dari parameter apa pun yang dapat dimodifikasi di dalam grup parameter klaster Amazon DocumentDB kustom menggunakan AWS CLI. Anda tidak dapat membuat modifikasi langsung ke grup parameter klaster default. Untuk mengubah parameter grup parameter klaster kustom, gunakan operasi `modify-db-cluster-parameter-group` dengan parameter berikut. + **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda modifikasi. + **--parameters** — Diperlukan. Parameter yang Anda modifikasi. Untuk daftar parameter yang berlaku untuk semua instans di klaster Amazon DocumentDB, lihat [Referensi parameter cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). Setiap entri parameter harus menyertakan hal berikut: + **ParameterName** — Nama parameter yang Anda ubah. + **ParameterValue** — Nilai baru untuk parameter ini. + **ApplyMethod** — Bagaimana Anda ingin perubahan pada parameter ini diterapkan. Nilai yang diizinkan adalah `immediate` dan `pending-reboot`. **catatan** Parameter dengan `ApplyType` dari `static` harus memiliki `ApplyMethod` dari `pending-reboot`. **Example - Memodifikasi nilai parameter** Dalam contoh ini, Anda mencantumkan nilai parameter `sample-parameter-group` dan memodifikasi parameter `tls`. Kemudian, setelah menunggu 5 menit, Anda kembali mencantumkan nilai parameter `sample-parameter-group` untuk melihat nilai parameter yang diubah. 1. Buat daftar parameter dan nilai `sample-parameter-group` mereka. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] } ``` 1. Ubah parameter `tls` sehingga nilainya menjadi `disabled` . Anda tidak dapat mengubah `ApplyMethod` karena `ApplyType` adalah `static`. Untuk Linux, macOS, atau Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot ``` Untuk Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName"=tls,"ParameterValue"=disabled,"ApplyMethod"=pending-reboot ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. Tunggu paling tidak 5 menit. 1. Buat daftar nilai parameter `sample-parameter-group` untuk memverifikasi bahwa parameter `tls` telah dimodifikasi. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "Parameters": [ { "ParameterValue": "false", "ParameterName": "enable_audit_logs", "ApplyType": "dynamic", "DataType": "string", "Description": "Enables auditing on cluster.", "AllowedValues": "true,false", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterValue": "disabled", "ParameterName": "tls", "ApplyType": "static", "DataType": "string", "Description": "Config to enable/disable TLS", "AllowedValues": "disabled,enabled", "Source": "system", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ # Memodifikasi cluster Amazon DocumentDB untuk menggunakan grup parameter cluster kustom Saat Anda membuat klaster Amazon DocumentDB, grup parameter `default.docdb4.0` secara otomatis dibuat untuk klaster tersebut. Anda tidak dapat mengubah grup parameter klaster `default`. Sebagai gantinya, Anda dapat memodifikasi klaster Amazon DocumentDB untuk mengaitkan grup parameter baru yang disesuaikan dengan itu. Bagian ini menjelaskan cara memodifikasi klaster Amazon DocumentDB yang ada untuk menggunakan grup parameter cluster kustom menggunakan Konsol Manajemen AWS dan AWS Command Line Interface ().AWS CLI ------ #### [ Using the Konsol Manajemen AWS ] **Untuk memodifikasi klaster Amazon DocumentDB untuk menggunakan grup parameter klaster bukan-default yang baru** 1. Sebelum Anda mulai, pastikan Anda telah membuat klaster Amazon DocumentDB dan grup parameter klaster. Lihat [Membuat cluster Amazon DocumentDB](db-cluster-create.md) dan [Membuat grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-create.md) untuk instruksi lebih lanjut. 1. Setelah membuat grup parameter klaster Anda, buka konsol Amazon DocumentDB di [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb). Di panel navigasi, pilih **Klaster** untuk menambahkan grup parameter baru Anda ke sebuah klaster. 1. Pilih klaster yang ingin Anda kaitkan dengan grup parameter Anda. Pilih **Tindakan**, lalu pilih **Ubah** untuk mengubah klaster Anda. 1. Di bawah **Opsi klaster**, pilih grup parameter baru yang ingin Anda kaitkan dengan klaster Anda. 1. Pilih **Lanjutkan** untuk melihat ringkasan dari modifikasi Anda. 1. Setelah memverifikasi perubahan Anda, Anda dapat menerapkannya segera atau selama jendela pemeliharaan berikutnya di bawah **Penjadwalan modifikasi**. 1. Pilih **Ubah klaster** untuk memperbarui klaster Anda dengan grup parameter baru Anda. ------ #### [ Using the AWS CLI ] Sebelum Anda memulai, pastikan Anda telah membuat klaster Amazon DocumentDB dan grup parameter klaster. Anda dapat [membuat cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/db-cluster-create.html) menggunakan operasi. AWS CLI `create-db-cluster` Anda dapat [membuat grup parameter cluster](https://docs.aws.amazon.com//documentdb/latest/developerguide/cluster_parameter_groups-create.html) menggunakan AWS CLI `create-db-cluster-parameter-group` operasi. Untuk menambahkan grup parameter cluster baru Anda ke cluster Anda, gunakan AWS CLI `modify-db-cluster` operasi dengan parameter berikut. + **-- db-cluster-identifier** — Nama cluster Anda (misalnya,`sample-cluster`). + **-- db-cluster-parameter-group -name** — Nama grup parameter yang ingin Anda kaitkan dengan cluster Anda (misalnya,`sample-parameter-group`). **Example** ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --db-cluster-parameter-group-name sample-parameter-group ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` "DBCluster": { "AvailabilityZones": [ "us-west-2c", "us-west-2b", "us-west-2a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", ... } ``` ------ # Menyalin grup parameter cluster Amazon DocumentDB Anda dapat membuat salinan grup parameter cluster di Amazon DocumentDB menggunakan Konsol Manajemen AWS atau AWS Command Line Interface ().AWS CLI ------ #### [ Using the Konsol Manajemen AWS ] Prosedur berikut memandu Anda membuat grup parameter klaster baru dengan membuat salinan grup parameter klaster yang ada. **Untuk menyalin grup parameter klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. 1. Di panel **Grup parameter klaster**, pilih nama grup parameter klaster yang ingin Anda salin. 1. Pilih **Tindakan**, lalu pilih **Salin** untuk menyalin grup parameter tersebut. 1. Di bawah **Opsi salin**, masukkan nama dan deskripsi untuk grup parameter klaster baru. Kemudian pilih **Salin** untuk menyimpan perubahan Anda. ------ #### [ Using the AWS CLI ] Untuk membuat salinan grup parameter klaster, gunakan operasi `copy-db-cluster-parameter-group` dengan parameter berikut. + **--source-db-cluster-parameter-group-identifier** — Diperlukan. Nama atau Amazon Resource Name (ARN) dari grup parameter klaster yang ingin Anda buat salinannya. Jika kelompok parameter cluster sumber dan target sama Wilayah AWS, pengenal dapat berupa nama atau ARN. Jika kelompok parameter cluster sumber dan target berbeda Wilayah AWS, pengenal harus ARN. + **--target-db-cluster-parameter-group-identifier** — Diperlukan. Nama atau ARN salinan grup parameter klaster. Batas: + Tidak dapat berupa null, kosong, atau blank. + Harus berisi 1-255 huruf, angka, atau tanda hubung. + Karakter pertama harus berupa huruf. + Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan. + **--target-db-cluster-parameter-group-description** — Diperlukan. Deskripsi yang diberikan pengguna untuk salinan grup parameter klaster. **Example** Kode berikut membuat salinan `sample-parameter-group`, menamai salinan `sample-parameter-group-copy`. Untuk Linux, macOS, atau Unix: ``` aws docdb copy-db-cluster-parameter-group \ --source-db-cluster-parameter-group-identifier sample-parameter-group \ --target-db-cluster-parameter-group-identifier sample-parameter-group-copy \ --target-db-cluster-parameter-group-description "Copy of sample-parameter-group" ``` Untuk Windows: ``` aws docdb copy-db-cluster-parameter-group ^ --source-db-cluster-parameter-group-identifier sample-parameter-group ^ --target-db-cluster-parameter-group-identifier sample-parameter-group-copy ^ --target-db-cluster-parameter-group-description "Copy of sample-parameter-group" ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroup": { "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group-copy", "DBClusterParameterGroupName": "sample-parameter-group-copy", "DBParameterGroupFamily": "docdb4.0", "Description": "Copy of sample-parameter-group" } } ``` ------ # Menyetel ulang grup parameter cluster Amazon DocumentDB Anda dapat mengatur ulang beberapa atau semua nilai parameter grup parameter klaster Amazon DocumentDB ke nilai defaultnya dengan menggunakan Konsol Manajemen AWS atau AWS Command Line Interface AWS CLI() untuk mengatur ulang grup parameter cluster. ------ #### [ Using the Konsol Manajemen AWS ] Ikuti langkah-langkah ini untuk mengatur ulang beberapa atau semua nilai parameter grup parameter klaster ke nilai defaultnya. **Untuk mengatur ulang nilai parameter grup parameter klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi di sisi kiri konsol tersebut, pilih **Grup parameter**. 1. Di panel **Grup parameter klaster**, pilih nama grup parameter klaster yang ingin Anda atur ulang. 1. Pilih **Tindakan**, lalu pilih **Atur Ulang** untuk mengatur ulang grup parameter tersebut. 1. Pada halaman **Konfirmasi reset grup parameter klaster** yang dihasilkan, konfirmasi bahwa Anda ingin mengatur ulang semua parameter klaster untuk grup parameter tersebut ke defaultnya. Kemudian pilih **Atur ulang** untuk mengatur ulang grup parameter Anda. Anda juga dapat memilih **Batal** untuk membuang perubahan Anda. ------ #### [ Using the AWS CLI ] Untuk mereset beberapa atau semua nilai parameter grup parameter klaster ke nilai defaultnya, gunakan operasi `reset-db-cluster-parameter-group` dengan parameter berikut. + **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang akan diatur ulang. + **--parameters** – Opsional. Daftar `ParameterName` dan `ApplyMethod` dalam grup parameter klaster untuk diatur ulang ke nilai defaultnya. Parameter statis harus disetel ke `pending-reboot` agar berlaku pada mulai ulang instans atau permintaan `reboot-db-instance` berikutnya. Anda harus memanggil `reboot-db-instance` untuk setiap instans di klaster yang Anda inginkan untuk menerapkan parameter statis yang diperbarui. Parameter ini dan `--reset-all-parameters` saling eksklusif: Anda dapat menggunakan salah satunya tetapi tidak keduanya. + **--reset-all-parameters** atau **--no-reset-all-parameters** — Opsional. Menentukan apakah akan mengatur ulang semua parameter (`--reset-all-parameters` atau hanya beberapa parameter (`--no-reset-all-parameters`) ke nilai defaultnya. Parameter `--reset-all-parameters` dan `--parameters` saling eksklusif: Anda dapat menggunakan salah satunya tetapi tidak keduanya. Saat Anda mengatur ulang seluruh grup, parameter dinamis segera diperbarui. Parameter statis diatur ke `pending-reboot` untuk diterapkan pada mulai ulang instans atau permintaan `reboot-db-instance` berikutnya. Anda harus memanggil `reboot-db-instance` untuk setiap instans di klaster yang Anda inginkan untuk menerapkan parameter statis yang diperbarui. **Example** **Contoh 1: Mengatur ulang semua parameter ke nilai defaultnya** Kode berikut mengatur ulang semua parameter di grup parameter klaster `sample-parameter-group` nilai defaultnya. Untuk Linux, macOS, atau Unix: ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --reset-all-parameters ``` Untuk Windows: ``` aws docdb reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --reset-all-parameters ``` **Contoh 2: Mengatur ulang parameter yang ditentukan ke nilai defaultnya** Kode berikut mengatur ulang parameter `tls` di grup parameter klaster `sample-parameter-group` ke nilai defaultnya. Untuk Linux, macOS, atau Unix: ``` aws docdb reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --no-reset-all-parameters \ --parameters ParameterName=tls,ApplyMethod=pending-reboot ``` Untuk Windows: ``` aws docdb reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --no-reset-all-parameters ^ --parameters ParameterName=tls,ApplyMethod=pending-reboot ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` **Melakukan reboot instans klaster** Sebelum nilai parameter statis diubah, instans klaster harus di-boot ulang. Reboot setiap instans di klaster Anda yang Anda inginkan untuk menerapkan parameter statis yang diperbarui. Untuk Linux, macOS, atau Unix: ``` aws docdb reboot-db-instance \ --db-instance-identifier sample-cluster-instance ``` Untuk Windows: ``` aws docdb reboot-db-instance ^ --db-instance-identifier sample-cluster-instance ``` ------ # Menghapus grup parameter cluster Amazon DocumentDB Anda dapat menghapus grup parameter cluster Amazon DocumentDB kustom menggunakan Konsol Manajemen AWS atau AWS Command Line Interface ().AWS CLI Anda tidak dapat menghapus grup parameter klaster `default.docdb4.0`. ------ #### [ Using the Konsol Manajemen AWS ] **Untuk menghapus grup parameter klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. **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. 1. Di panel **Grup parameter**, pilih tombol radio di sebelah kiri grup parameter klaster yang ingin Anda hapus. 1. Pilih **Tindakan**, lalu pilih **Hapus**. 1. Di panel konfirmasi **Hapus**, pilih **Hapus** untuk menghapus grup parameter klaster. Untuk mempertahankan grup parameter klaster, pilih **Batal**. ------ #### [ Using the AWS CLI ] Untuk menghapus grup parameter klaster, gunakan operasi `delete-db-cluster-parameter-group` dengan parameter berikut. + **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang akan dihapus. Ini harus menjadi grup parameter klaster yang sudah ada. *Anda tidak dapat menghapus grup parameter `default.docdb4.0` cluster.* **Example - Menghapus grup parameter klaster** Contoh berikut memandu Anda menjalani tiga langkah untuk menghapus grup parameter klaster: 1. Menemukan nama grup parameter klaster yang ingin Anda hapus. 1. Menghapus grup parameter klaster yang ditentukan. 1. Memverifikasi bahwa grup parameter klaster telah dihapus. **1. Temukan nama grup parameter klaster yang ingin Anda hapus.** Kode berikut mencantumkan nama semua grup parameter klaster. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Output dari operasi sebelumnya adalah daftar nama grup parameter klaster yang mirip dengan berikut ini (format JSON). ``` [ [ "default.docdb4.0" ], [ "sample-parameter-group" ], [ "sample-parameter-group-copy" ] ] ``` **2. Menghapus grup parameter klaster tertentu.** Kode berikut menghapus grup parameter klaster `sample-parameter-group-copy`. Untuk Linux, macOS, atau Unix: ``` aws docdb delete-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group-copy ``` Untuk Windows: ``` aws docdb delete-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group-copy ``` Tidak ada output dari operasi ini. **3. Verifikasi bahwa grup parameter klaster yang ditentukan telah dihapus.** Kode berikut mencantumkan nama semua grup parameter klaster yang tersisa. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].[DBClusterParameterGroupName]' ``` Output dari operasi sebelumnya adalah daftar grup parameter klaster yang mirip dengan berikut ini (format JSON). Grup parameter klaster yang baru saja Anda hapus tidak boleh ada dalam daftar. Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "default.docdb4.0" ], [ "sample-parameter-group" ] ] ``` ------ # Referensi parameter cluster Amazon DocumentDB Saat Anda mengubah parameter dinamis dan menyimpan grup parameter klaster, perubahan akan segera diterapkan terlepas dari pengaturan *Terapkan segera*. Saat Anda mengubah parameter statis dan menyimpan grup parameter klaster, perubahan parameter akan berlaku setelah Anda melakukan reboot instans secara manual. Anda dapat melakukan reboot instans menggunakan konsol Amazon DocumentDB atau dengan memanggil `reboot-db-instance` secara eksplisit. Tabel berikut menunjukkan parameter yang berlaku untuk semua instans di klaster Amazon DocumentDB. **Parameter tingkat klaster Amazon DocumentDB** | Parameter | Nilai default | Nilai valid | Dapat diubah | Tipe Penerapan | Tipe data | Deskripsi | | --- | --- | --- | --- | --- | --- | --- | | audit\$1logs | dinonaktifkan | diaktifkan, dinonaktifkan, ddl, dml\$1read, dml\$1write, semua, tidak ada | Ya | Dinamis | String | Menentukan apakah log CloudWatch audit Amazon diaktifkan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | change\$1stream\$1log\$1retention\$1duration | 10800 | 3600-604800 | Ya | Dinamis | Bilangan Bulat | Menentukan durasi waktu (dalam detik) bahwa log aliran perubahan dipertahankan dan dapat digunakan. | | default\$1collection\$1compression | dinonaktifkan | diaktifkan, dinonaktifkan (Amazon DocumentDB 5.0) /zstd, lz4, tidak ada (Dokumen Amazon .0) DB8 | Ya | Dinamis | String | Mendefinisikan pengaturan kompresi default untuk koleksi baru dalam sebuah cluster [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | profiler | dinonaktifkan | diaktifkan, dinonaktifkan | Ya | Dinamis | String | Mengaktifkan pembuatan profil untuk operasi yang lambat. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | profiler\$1sampling\$1rate | 1.0 | 0,0-1,0 | Ya | Dinamis | Desimal | Menentukan laju pengambilan sampel untuk operasi yang dicatat. | | profiler\$1threshold\$1ms | 100 | 50-2147483646 | Ya | Dinamis | Bilangan Bulat | Mendefinisikan ambang batas untuk profiler. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | planner\$1version | 3.0 | 1.0, 2.0, 3.0 | Ya | Dinamis | Desimal | Mendefinisikan versi perencana kueri yang akan digunakan untuk kueri.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | tls | diaktifkan | diaktifkan, dinonaktifkan, fips-140-3, tls1.2 \$1, tls1.3 \$1 | Ya | Statis | String | Menentukan apakah koneksi Transport Layer Security (TLS) diperlukan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | | ttl\$1monitor | diaktifkan | diaktifkan, dinonaktifkan | Ya | Dinamis | String | Menentukan apakah pemantauan Time to Live (TTL) diaktifkan untuk klaster. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/cluster_parameter_groups-list_of_parameters.html) | # Memodifikasi parameter cluster Amazon DocumentDB Di Amazon DocumentDB, *grup parameter klaster* terdiri dari *parameter* yang berlaku untuk semua instans yang Anda buat di klaster. Untuk grup parameter klaster kustom, Anda dapat mengubah nilai parameter kapan saja atau mengatur ulang semua nilai parameter ke default untuk grup parameter yang Anda buat. Bagian ini menjelaskan cara melihat parameter yang membentuk grup parameter klaster Amazon DocumentDB dan nilainya, dan bagaimana Anda dapat mengubah atau memperbarui nilai ini. Parameter bisa *dinamis* atau *statis*. Saat Anda mengubah parameter dinamis dan menyimpan grup parameter klaster, perubahan akan segera diterapkan terlepas dari pengaturan `Apply Immediately`. Saat Anda mengubah parameter statis dan menyimpan grup parameter klaster, perubahan parameter hanya berlaku setelah Anda melakukan reboot instans secara manual. ## Melihat parameter grup parameter cluster Amazon DocumentDB Anda dapat melihat parameter cluster Amazon DocumentDB dan nilainya menggunakan atau. Konsol Manajemen AWS AWS CLI ------ #### [ Using the Konsol Manajemen AWS ] **Untuk melihat detail grup parameter klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. **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. 1. Di panel **Grup parameter**, pilih nama grup parameter klaster yang ingin Anda lihat detailnya. 1. Halaman yang dihasilkan menunjukkan nilai berikut untuk setiap parameter: nama parameter, nilai saat ini, nilai yang diizinkan, apakah parameter dapat dimodifikasi, jenis penerapan, tipe data, dan deskripsi. ![\[Tangkapan layar: Nama dan nilai parameter.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/docdb-determine-parameter-value.png) ------ #### [ Using the AWS CLI ] Untuk melihat parameter grup parameter klaster dan nilainya, gunakan operasi `describe-db-cluster-parameters` dengan parameter berikut. + **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda inginkan daftar parameternya secara mendetail. + **--source** – Opsional. Jika disediakan, mengembalikan hanya parameter untuk sumber tertentu. Sumber parameter dapat berupa `engine-default`, `system`, atau `user`. **Example** Kode berikut mencantumkan parameter dan nilainya untuk grup parameter `custom3-6-param-grp`. Untuk informasi lebih lanjut tentang grup parameter, hilangkan garis `--query`. Untuk informasi tentang semua grup parameter, hilangkan garis `--db-cluster-parameter-group-name`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name custom3-6-param-grp \ --query 'Parameters[*].[ParameterName,ParameterValue]' ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name custom3-6-param-grp ^ --query 'Parameters[*].[ParameterName,ParameterValue]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "audit_logs", "disabled" ], [ "tls", "enabled" ], [ "ttl_monitor", "enabled" ] ] ``` ------ ## Memodifikasi parameter grup parameter cluster Amazon DocumentDB Anda dapat memodifikasi parameter grup parameter menggunakan Konsol Manajemen AWS atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] **Untuk memperbarui parameter grup parameter klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. **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. 1. Di panel **Grup parameter**, pilih grup parameter klaster yang ingin Anda perbarui parameternya. 1. Halaman yang dihasilkan menunjukkan parameter dan detail yang sesuai untuk grup parameter klaster ini. Pilih parameter untuk diperbarui. 1. Di kanan atas halaman, pilih **Edit** untuk mengubah nilai parameter. Untuk informasi selengkapnya tentang tipe parameter klaster, lihat [Referensi parameter cluster Amazon DocumentDB](cluster_parameter_groups-list_of_parameters.md). 1. Buat perubahan Anda, lalu pilih **Ubah parameter klaster** untuk menyimpan perubahan. Untuk membuang perubahan Anda, pilih **Batal**. ------ #### [ Using the AWS CLI ] Untuk mengubah parameter grup parameter klaster, gunakan operasi `modify-db-cluster-parameter-group` dengan parameter berikut: + **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda modifikasi. + **--parameters** — Diperlukan. Parameter atau parameter yang Anda modifikasi. Setiap entri parameter harus menyertakan hal berikut: + **ParameterName** — Nama parameter yang Anda ubah. + **ParameterValue** — Nilai baru untuk parameter ini. + **ApplyMethod** — Bagaimana Anda ingin perubahan pada parameter ini diterapkan. Nilai yang diizinkan adalah `immediate` dan `pending-reboot`. **catatan** Parameter dengan `ApplyType` dari `static` harus memiliki `ApplyMethod` dari `pending-reboot`. **Untuk mengubah nilai parameter grup parameter klaster (AWS CLI)** Contoh berikut mengubah parameter `tls`. 1. **Buat daftar parameter dan nilainya `sample-parameter-group`** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "Parameters": [ { "Source": "system", "ApplyType": "static", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "tls", "IsModifiable": true, "Description": "Config to enable/disable TLS" }, { "Source": "user", "ApplyType": "dynamic", "AllowedValues": "disabled,enabled", "ParameterValue": "enabled", "ApplyMethod": "pending-reboot", "DataType": "string", "ParameterName": "ttl_monitor", "IsModifiable": true, "Description": "Enables TTL Monitoring" } ] } ``` 1. **Ubah parameter `tls` sehingga nilainya menjadi `disabled`**. Anda tidak dapat mengubah `ApplyMethod` karena `ApplyType` adalah `static`. Untuk Linux, macOS, atau Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot" ``` Untuk Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot" ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. **Tunggu setidaknya 5 menit.** 1. **Buat daftar nilai parameter dari`sample-parameter-group`.** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "tls", "ParameterValue": "disabled", "Description": "Config to enable/disable TLS", "Source": "user", "ApplyType": "static", "DataType": "string", "AllowedValues": "disabled,enabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" } ] } ``` ------ # Memahami titik akhir Amazon DocumentDB Anda dapat menggunakan titik akhir Amazon DocumentDB (dengan kompatibilitas MongoDB) untuk terhubung ke klaster atau instans. Amazon DocumentDB memiliki tiga jenis titik akhir yang berbeda, masing-masing dengan tujuannya sendiri. **Topics** + [Menemukan titik akhir klaster](db-cluster-endpoints-find.md) + [Menemukan titik akhir instance](db-instance-endpoint-find.md) + [Menghubungkan ke titik akhir](endpoints-connecting.md) **Titik akhir klaster** Titik akhir klaster adalah titik akhir untuk klaster Amazon DocumentDB yang tersambung ke instans utama saat ini untuk klaster tersebut. Setiap klaster Amazon DocumentDB memiliki titik akhir klaster tunggal dan satu instans utama. Jika terjadi failover, titik akhir klaster dipetakan ulang ke instans utama baru. **Reader endpoint** Reader endpoint adalah titik akhir untuk klaster Amazon DocumentDB yang terhubung ke salah satu replika yang tersedia untuk klaster tersebut. Setiap klaster Amazon DocumentDB memiliki reader endpoint. Jika ada lebih dari satu replika, reader endpoint mengarahkan setiap permintaan koneksi ke salah satu replika Amazon DocumentDB. **Titik akhir instans** Titik akhir instans adalah titik akhir yang terhubung ke instans tertentu. Setiap instans dalam sebuah klaster, terlepas dari apakah itu instans primer atau replika, memiliki titik akhir instans uniknya sendiri. Yang terbaik adalah tidak menggunakan titik akhir instans di aplikasi Anda. Ini karena mereka dapat mengubah peran jika terjadi failover, sehingga memerlukan perubahan kode dalam aplikasi Anda. # Menemukan titik akhir klaster Anda dapat menemukan titik akhir klaster dan reader endpoint pada suatu klaster dengan menggunakan konsol Amazon DocumentDB atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] **Untuk menemukan titik akhir cluster menggunakan konsol:** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Dari daftar klaster, pilih nama klaster yang Anda minati. 1. Pada halaman detail cluster, pilih tab **Konfigurasi**. Di bagian **Konfigurasi dan status**, Anda akan menemukan **titik akhir Cluster dan titik akhir** **Pembaca**. ![\[Bagian konfigurasi dan status yang menunjukkan titik akhir cluster dan pembaca.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-endpoints.png) 1. Untuk terhubung ke cluster ini, pilih tab **Konektivitas & keamanan**. Temukan string koneksi untuk `mongo` shell dan string koneksi yang dapat digunakan dalam kode aplikasi untuk terhubung ke cluster Anda. ![\[Bagian Connect menunjukkan string untuk terhubung ke instance dengan shell mongo dan string untuk terhubung ke cluster dengan aplikasi.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-connection-strings.png) ------ #### [ Using the AWS CLI ] Untuk menemukan titik akhir cluster dan pembaca untuk cluster Anda menggunakan AWS CLI, jalankan `describe-db-clusters` perintah dengan parameter ini. **Parameter** + **--db-cluster-identifier**—Opsional. Menentukan klaster untuk mengembalikan titik akhir. Jika dihilangkan, menampilkan titik akhir hingga 100 klaster Anda. + **--query**—Opsional. Menentukan bidang yang akan menampilkan. Bermanfaat dengan mengurangi jumlah data yang Anda butuhkan untuk melihat serta menemukan titik akhir. Jika dihilangkan, semua informasi tentang klaster dikembalikan. + **--region**—Opsional. Gunakan parameter `--region` untuk menentukan Wilayah tempat Anda ingin menerapkan perintah. Jika dihilangkan, Wilayah default Anda digunakan. **Example** Contoh berikut mengembalikan `DBClusterIdentifier`, titik akhir (titik akhir klaster), dan `ReaderEndpoint` untuk `sample-cluster`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --region us-east-1 \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]' ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --region us-east-1 ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "sample-cluster", 27017, "sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com", "sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com" ] ] ``` Sekarang setelah Anda memiliki titik akhir klaster, Anda dapat terhubung ke klaster menggunakan salah satu `mongo` atau `mongodb`. Untuk informasi selengkapnya, lihat [Menghubungkan ke titik akhir](endpoints-connecting.md). ------ # Menemukan titik akhir instance Anda dapat menemukan titik akhir untuk instans dengan menggunakan konsol Amazon DocumentDB atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] **Untuk menemukan titik akhir instans dengan menggunakan konsol** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Klaster**. **Tip** Jika Anda tidak melihat panel navigasi pada sisi kiri layar Anda, 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 sudut kiri atas halaman. 1. Di kotak navigasi Klaster, Anda akan melihat kolom **Pengidentifikasi klaster**. Instans Anda tercantum di bawah klaster, mirip dengan tangkapan layar di bawah. ![\[Tabel cluster menunjukkan daftar cluster di bawah kolom pengenal Cluster, dengan instance bersarang di dalam cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/choose-clusters.png) 1. Centang kotak di sebelah kiri instans yang Anda minati. 1. Gulir ke bawah ke bagian **Detail** lalu temukan titik akhir instans. ![\[Cuplikan layar konsol yang menampilkan halaman detail dengan titik akhir instans yang disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-instance-endpoint.png) 1. Untuk terhubung ke instans ini, gulir ke atas ke bagian **Koneksi**. Temukan string koneksi untuk shell `mongo` dan string koneksi yang dapat digunakan dalam kode aplikasi Anda untuk terhubung ke instans Anda. ![\[Tangkapan layar konsol yang menunjukkan bagian Connect dengan shell mongo dan string koneksi aplikasi disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/instance-connection-strings.png) ------ #### [ Using the AWS CLI ] Untuk menemukan titik akhir instance menggunakan AWS CLI, jalankan perintah berikut dengan argumen ini. **Pendapat** + **--db-instance-identifier**—Opsional. Menentukan instans untuk menampilkan titik akhir. Jika dihilangkan, mengembalikan titik akhir hingga 100 instans Anda. + **--query**—Opsional. Menentukan bidang yang akan menampilkan. Bermanfaat dengan mengurangi jumlah data yang Anda butuhkan untuk melihat serta menemukan titik akhir. Jika dihilangkan, semua informasi pada sebuah instans dikembalikan. Bidang `Endpoint` memiliki tiga anggota, jadi mencantumkannya dalam kueri seperti pada contoh berikut mengembalikan ketiga anggota. Jika Anda hanya tertarik pada beberapa anggota `Endpoint`, ganti `Endpoint` pada kueri dengan anggota yang Anda minati, seperti pada contoh kedua. + **--region**—Opsional. Gunakan parameter `--region` untuk menentukan Wilayah tempat Anda ingin menerapkan perintah. Jika dihilangkan, Wilayah default Anda digunakan. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --region us-east-1 \ --db-instance-identifier sample-cluster-instance \ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]' ``` Untuk Windows: ``` aws docdb describe-db-instances ^ --region us-east-1 ^ --db-instance-identifier sample-cluster-instance ^ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "sample-cluster-instance", { "Port": 27017, "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com", "HostedZoneId": "Z2R2ITUGPM61AM" } ] ] ``` Mengurangi output untuk menghilangkan `HostedZoneId` pada titik akhir, Anda dapat memodifikasi kueri Anda dengan menentukan `Endpoint.Port` dan `Endpoint.Address`. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --region us-east-1 \ --db-instance-identifier sample-cluster-instance \ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]' ``` Untuk Windows: ``` aws docdb describe-db-instances ^ --region us-east-1 ^ --db-instance-identifier sample-cluster-instance ^ --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ [ "sample-cluster-instance", 27017, "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com" ] ] ``` Sekarang setelah Anda memiliki titik akhir instans, Anda dapat terhubung ke instans dengan menggunakan `mongo` atau `mongodb`. Untuk informasi selengkapnya, lihat [Menghubungkan ke titik akhir](endpoints-connecting.md). ------ # Menghubungkan ke titik akhir Setelah Anda memiliki titik akhir, baik klaster atau instans, Anda dapat menghubungkannya dengan menggunakan shell `mongo` atau string koneksi. ## Menghubungkan menggunakan cangkang mongo Gunakan struktur berikut untuk membuat string yang perlu Anda sambungkan ke klaster atau instans Anda dengan menggunakan shell `mongo`: ``` mongo \ --ssl \ --host Endpoint:Port \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` **Contoh shell `mongo`** Sambungkan ke klaster: ``` mongo \ --ssl \ --host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` Sambungkan ke instans: ``` mongo \ --ssl \ --host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \ --sslCAFile global-bundle.pem \ --username UserName \ --password Password ``` ## Menghubungkan menggunakan string koneksi Gunakan struktur berikut untuk membuat string koneksi yang Anda perlukan untuk terhubung ke klater atau instans Anda. ``` mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ``` **Contoh string koneksi** Sambungkan ke klaster: ``` mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ``` Sambungkan ke instans: ``` mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem ```   # Memahami Nama Sumber Daya Amazon DocumentDB Amazon () ARNs Sumber daya yang Anda buat masing-masing AWS diidentifikasi secara unik dengan Nama Sumber Daya Amazon (ARN). Untuk operasi Amazon DocumentDB (dengan kompatibilitas MongoDB) tertentu, Anda harus secara unik mengidentifikasi sumber daya Amazon DocumentDB dengan menentukan ARN-nya. Misalnya, saat Anda menambahkan tag ke sumber daya, Anda harus menyediakan ARN sumber daya. **Topics** + [Membuat konsep ARN](#documentdb-arns-constructing) + [Menemukan ARN](#documentdb-arns-find) ## Membangun ARN untuk sumber daya Amazon DocumentDB Anda dapat membangun ARN untuk sumber daya Amazon DocumentDB menggunakan sintaks berikut. Amazon DocumentDB membagikan format Amazon Relational Database Service (Amazon RDS). ARNs Amazon ARNs DocumentDB `rds` berisi dan tidak. `docdb` `arn:aws:rds:region:account_number:resource_type:resource_id` | Nama Wilayah | Region | Availability Zone (penghitungan) | | --- | --- | --- | | AS Timur (Ohio) | `us-east-2` | 3 | | AS Timur (Virginia Utara) | `us-east-1` | 6 | | AS Barat (Oregon) | `us-west-2` | 4 | | Africa (Cape Town) | `af-south-1` | 3 | | Amerika Selatan (Sao Paulo) | `sa-east-1` | 3 | | Asia Pasifik (Hong Kong) | `ap-east-1` | 3 | | Asia Pasifik (Hyderabad) | `ap-south-2` | 3 | | Asia Pasifik (Malaysia) | `ap-southeast-5` | 3 | | Asia Pasifik (Mumbai) | `ap-south-1` | 3 | | Asia Pasifik (Osaka) | `ap-northeast-3` | 3 | | Asia Pasifik (Seoul) | `ap-northeast-2` | 4 | | Asia Pasifik (Singapura) | `ap-southeast-1` | 3 | | Asia Pasifik (Sydney) | `ap-southeast-2` | 3 | | Asia Pasifik (Jakarta) | `ap-southeast-3` | 3 | | Asia Pacific (Melbourne) | `ap-southeast-4` | 3 | | Asia Pasifik (Thailand) | `ap-southeast-7` | 3 | | Asia Pasifik (Tokyo) | `ap-northeast-1` | 3 | | Kanada (Pusat) | `ca-central-1` | 3 | | Wilayah Tiongkok (Beijing) | `cn-north-1` | 3 | | Tiongkok (Ningxia) | `cn-northwest-1` | 3 | | Eropa (Frankfurt) | `eu-central-1` | 3 | | Europe (Zurich) | `eu-central-2` | 3 | | Eropa (Irlandia) | `eu-west-1` | 3 | | Eropa (London) | `eu-west-2` | 3 | | Europe (Milan) | `eu-south-1` | 3 | | Eropa (Paris) | `eu-west-3` | 3 | | Eropa (Spanyol) | `eu-south-2` | 3 | | Eropa (Stockholm) | `eu-north-1` | 3 | | Meksiko (Tengah) | `mx-central-1` | 3 | | Timur Tengah (UAE) | `me-central-1` | 3 | | Israel (Tel Aviv) | `il-central-1` | 3 | | AWS GovCloud (AS-Barat) | `us-gov-west-1` | 3 | | AWS GovCloud (AS-Timur) | `us-gov-east-1` | 3 | **catatan** Arsitektur Amazon DocumentDB memisahkan penyimpanan dan komputasi. Untuk lapisan penyimpanan, Amazon DocumentDB mereplikasi enam salinan data Anda di AWS tiga Availability Zones (). AZs Yang AZs tercantum dalam tabel di atas adalah jumlah AZs yang dapat Anda gunakan di wilayah tertentu untuk menyediakan instance komputasi. Sebagai contoh, jika Anda meluncurkan cluster Amazon DocumentDB di ap-northeast-1, penyimpanan Anda akan direplikasi enam cara di tiga tetapi instans komputasi Anda hanya akan tersedia dalam dua. AZs AZs Tabel berikut menunjukkan format yang harus Anda gunakan saat membangun ARN untuk jenis sumber daya Amazon DocumentDB tertentu. Amazon DocumentDB membagikan format Amazon RDS. ARNs Amazon ARNs DocumentDB `rds` berisi dan tidak. `docdb` | Jenis Sumber Daya | Format/Contoh ARN | | --- | --- | | Contoh (`db`) | `arn:aws:rds:region:account_number:db:resource_id` 
arn:aws:rds:us-east-1:1234567890:db:sample-db-instance
| | Klaster (`cluster`) | `arn:aws:rds:region:account_number:cluster:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster:sample-db-cluster
| | Grup parameter klaster (`cluster-pg`) | `arn:aws:rds:region:account_number:cluster-pg:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster-pg:sample-db-cluster-parameter-group
| | Grup keamanan (`secgrp`) | `arn:aws:rds:region:account_number:secgrp:resource_id` 
arn:aws:rds:us-east-1:1234567890:secgrp:sample-public-secgrp
| | Snapshot klaster (`cluster-snapshot`) | `arn:aws:rds:region:account_number:cluster-snapshot:resource_id` 
arn:aws:rds:us-east-1:1234567890:cluster-snapshot:sample-db-cluster-snapshot
| | Grup subnet (`subgrp`) | `arn:aws:rds:region:account_number:subgrp:resource_id` 
arn:aws:rds:us-east-1:1234567890:subgrp:sample-subnet-10
| ## Menemukan ARN sumber daya Amazon DocumentDB Anda dapat menemukan ARN dari sumber daya Amazon DocumentDB menggunakan atau file. Konsol Manajemen AWS AWS CLI ------ #### [ Using the Konsol Manajemen AWS ] Untuk menemukan ARN dengan menggunakan konsol, arahkan navigasi ke sumber daya yang Anda inginkan untuk ARN, dan lihat detail untuk sumber daya tersebut. Misalnya, Anda bisa mendapatkan ARN untuk klaster dengan memilih tab **Konfigurasi** pada halaman detail cluster. ARN dapat ditemukan di bagian **Konfigurasi dan status**, seperti yang ditunjukkan pada gambar berikut. ![\[Cuplikan layar konsol yang menampilkan ARN di bagian konfigurasi dan status pada panel detail.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/documentdb-arn.png) ------ #### [ Using the AWS CLI ] Untuk mendapatkan ARN menggunakan sumber daya Amazon DocumentDB tertentu, gunakan `describe` operasi AWS CLI untuk sumber daya tersebut. Tabel berikut menunjukkan setiap AWS CLI operasi dan properti ARN yang digunakan dengan operasi untuk mendapatkan ARN. | AWS CLI Perintah | Properti ARN | | --- | --- | | `describe-db-instances` | `DBInstanceArn` | | `describe-db-clusters` | `DBClusterArn` | | `describe-db-parameter-groups` | `DBParameterGroupArn` | | `describe-db-cluster-parameter-groups` | `DBClusterParameterGroupArn` | | `describe-db-security-groups` | `DBSecurityGroupArn` | | `describe-db-snapshots` | `DBSnapshotArn` | | `describe-db-cluster-snapshots` | `DBClusterSnapshotArn` | | `describe-db-subnet-groups` | `DBSubnetGroupArn` | **Example - Menemukan ARN untuk klaster** AWS CLI Operasi berikut menemukan ARN untuk cluster. `sample-cluster` Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterArn' ``` Untuk Windows: ``` aws docdb describe-db-clusters ^ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterArn' ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` [ "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster" ] ``` **Example - Menemukan ARNs beberapa grup parameter** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameter-groups \ --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn' ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameter-groups ^ --query 'DBClusterParameterGroups[*].DBClusterParameterGroupArn' ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` [ "arn:aws:rds:us-east-1:123456789012:cluster-pg:custom3-6-param-grp", "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6", "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.docdb3.6" ] ``` ------ # Menandai sumber daya Amazon DocumentDB Anda dapat menggunakan tanda Amazon DocumentDB (dengan kompatibilitas MongoDB) untuk menambahkan metadata ke sumber daya Amazon DocumentDB Anda. Tag ini dapat digunakan dengan kebijakan AWS Identity and Access Management (IAM) untuk mengelola akses ke sumber daya Amazon DocumentDB dan untuk mengontrol tindakan apa yang dapat diterapkan ke sumber daya. Anda juga dapat menggunakan tanda untuk melacak biaya dengan mengelompokkan pengeluaran untuk sumber daya serupa yang ditandai. Anda dapat menandai pada sumber Amazon DocumentDB berikut ini: + Klaster + Instans + Snapshot + Snapshot klaster + Grup parameter + Grup parameter klaster + Grup keamanan + Grup subnet ## Ikhtisar tag sumber daya Amazon DocumentDB Tanda Amazon DocumentDB adalah pasangan nama dan nilai yang Anda tentukan dan berkaitan dengan sumber daya Amazon DocumentDB. Nama ini disebut sebagai *kunci*. Memberikan nilai untuk kunci bersifat opsional. Anda dapat menggunakan tanda untuk menetapkan informasi tambahan ke sumber daya Amazon DocumentDB. Anda dapat menggunakan kunci tag, misalnya, untuk menentukan kategori, dan nilai tag mungkin merupakan item dalam kategori tersebut. Sebagai contoh, Anda dapat menentukan kunci tanda `project` dan nilai tanda `Salix`, yang menunjukkan bahwa sumber daya Amazon DocumentDB ditugaskan ke proyek Salix. Anda juga bisa menggunakan tanda untuk menunjuk domain Amazon DocumentDB agar digunakan untuk uji atau produksi dengan menggunakan kunci seperti `environment=test` atau `environment=production`. Kami menyarankan Anda untuk menggunakan kumpulan kunci tanda yang konsisten guna mempermudah untuk melacak metadata yang berkaitan dengan sumber daya Amazon DocumentDB. Anda dapat menggunakan tag untuk mengatur AWS tagihan Anda untuk mencerminkan struktur biaya Anda sendiri. Untuk melakukan ini, daftar untuk mendapatkan Akun AWS tagihan Anda dengan nilai kunci tag disertakan. Kemudian, untuk melihat biaya sumber daya gabungan, atur informasi penagihan Anda sesuai dengan sumber daya Anda dengan nilai kunci tag yang sama. Misalnya, Anda dapat memberikan tag pada beberapa sumber daya dengan nama aplikasi tertentu, kemudian mengatur informasi penagihan untuk melihat biaya total aplikasi tersebut pada beberapa layanan. Untuk informasi selengkapnya, lihat [Menggunakan Tanda Alokasi Biaya](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dalam *Panduan Pengguna Manajemen Penagihan dan Biaya AWS *. Setiap sumber daya Amazon DocumentDB memiliki satu rangkaian tanda, yang berisi semua tanda yang ditetapkan ke sumber daya tersebut. Rangkaian tanda dapat berisi 10 tanda, atau dapat kosong. Jika Anda menambahkan tanda ke sumber daya Amazon DocumentDB yang memiliki kunci yang sama dengan tanda yang ada pada sumber daya, nilai lama akan ditimpa dengan nilai baru. AWS tidak menerapkan makna semantik apa pun pada tag Anda; tag ditafsirkan secara ketat sebagai string karakter. Amazon DocumentDB dapat menetapkan tanda pada instans atau sumber daya Amazon DocumentDB lainnya, bergantung pada pengaturan yang Anda gunakan saat Anda membuat sumber daya. Sebagai contoh, Amazon DocumentDB dapat menambahkan tanda yang menunjukkan bahwa instans digunakan untuk produksi atau untuk pengujian. Anda dapat menambahkan tanda ke snapshot, namun tagihan Anda tidak akan mencerminkan pengelompokan ini. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk menambah, mencantumkan, dan menghapus tag di sumber daya Amazon DocumentDB. Saat menggunakan AWS CLI, Anda harus memberikan Nama Sumber Daya Amazon (ARN) untuk sumber daya yang ingin Anda gunakan. Untuk informasi selengkapnya tentang Amazon ARNs DocumentDB, lihat. [Memahami Nama Sumber Daya Amazon DocumentDB Amazon () ARNs](documentdb-arns.md) ## Kendala tag Kendala berikut ini berlaku untuk tanda Amazon DocumentDB: + Jumlah maksimum tanda per sumber daya - 10 + Panjang **Kunci** maksimum – 128 karakter Unicode + Panjang **Nilai** maksimum – 256 karakter Unicode + Karakter valid untuk **Kunci** dan **Nilai** - huruf besar dan huruf kecil dalam set karakter UTF-8, digit, spasi, dan karakter berikut ini: `_ . : / = + -` dan `@` (Java regex: `"^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$"`) + Kunci dan nilai tanda peka huruf besar-kecil. + Awalan `aws:` tidak dapat digunakan untuk kunci atau nilai tanda; awalan tersebut disediakan untuk AWS. ## Menambahkan dan memperbarui tag pada sumber daya Amazon DocumentDB Anda dapat menambahkan hingga 10 tag ke sumber daya menggunakan Konsol Manajemen AWS atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] Proses untuk menambahkan tanda ke sumber daya serupa terlepas dari sumber daya apa yang Anda tambahkan tanda. Dalam contoh ini, Anda menambahkan tanda ke klaster. **Untuk menambah atau memperbarui tanda ke klaster menggunakan konsol** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Dari panel navigasi, pilih **klaster**. 1. Pilih nama klaster yang ingin Anda tambahkan tanda. 1. Gulir ke bawah ke bagian **Tanda**, dan kemudian pilih **Edit**. 1. Untuk setiap tanda yang ingin Anda tambahkan ke sumber daya ini, lakukan hal berikut ini: 1. Untuk menambahkan tanda baru, masukkan nama tanda di kotak **Kunci**. Untuk mengubah nilai tanda, temukan nama tanda di kolom **Kunci**. 1. Untuk memberikan nilai baru atau nilai yang diperbarui pada tanda, masukkan nilai untuk tanda di kotak **Nilai**. 1. Jika Anda memiliki lebih banyak tanda untuk ditambahkan, pilih **Tambahkan**. Jika tidak, saat selesai, pilih **Simpan**. ------ #### [ Using the AWS CLI ] Proses untuk menambahkan tanda ke sumber daya serupa terlepas dari apa sumber daya yang Anda tambahkan tanda. Dalam contoh ini, Anda menambahkan tiga tanda ke klaster. Tanda kedua, `key2`, tidak memiliki nilai. Gunakan AWS CLI operasi `add-tags-to-resource` dengan parameter ini. **Parameter** + **--resource-name**—ARN dari sumber daya Amazon DocumentDB yang ingin Anda tambahkan tanda. + **--tags**—Daftar tanda (pasangan kunci-nilai) yang ingin Anda tambahkan ke sumber daya ini dalam format `Key=key-name,Value=tag-value`. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb add-tags-to-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` Untuk Windows: ``` aws docdb add-tags-to-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3 ``` Operasi `add-tags-to-resource` tidak menghasilkan keluaran. Untuk melihat hasil operasi, gunakan operasi `list-tags-for-resource`. ------ ## Listing tag pada sumber daya Amazon DocumentDB Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk mendapatkan daftar tag untuk sumber daya Amazon DocumentDB. ------ #### [ Using the Konsol Manajemen AWS ] Proses untuk mencantumkan tanda pada sumber daya serupa terlepas dari sumber daya yang Anda tambahkan tanda. Dalam contoh ini, Anda mencantumkan tanda untuk klaster. **Untuk mencantumkan tanda pada klaster menggunakan konsol** 1. [Buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Dari panel navigasi, pilih **klaster**. 1. Pilih nama klaster yang ingin Anda cantumkan tanda. 1. Untuk melihat daftar tanda pada sumber daya ini, gulir ke bawah ke bagian **Tanda**. ------ #### [ Using the AWS CLI ] Proses untuk mencantumkan tanda pada sumber daya serupa terlepas dari sumber daya yang Anda cantumkan tanda. Dalam contoh ini, Anda mencantumkan tanda pada klaster. Gunakan AWS CLI operasi `list-tags-for-resource` dengan parameter ini. **Parameter** + **--resource-name**—Wajib. ARN dari sumber daya Amazon DocumentDB yang ingin Anda cantumkan tanda. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb list-tags-for-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` Untuk Windows: ``` aws docdb list-tags-for-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "TagList": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "" }, { "Key": "key3", "Value": "value3" } ] } ``` ------ ## Menghapus tag dari sumber daya Amazon DocumentDB Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk menghapus tag dari sumber daya Amazon DocumentDB. ------ #### [ Using the Konsol Manajemen AWS ] Proses untuk menghapus tanda dari sumber daya serupa terlepas dari sumber daya apa yang Anda tambahkan tanda. Dalam contoh ini, Anda menghapus tanda dari klaster. **Untuk menghapus tanda dari klaster menggunakan konsol** 1. [Buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Dari panel navigasi, pilih **klaster**. 1. Pilih nama klaster yang ingin Anda hapus tandanya. 1. Gulir ke bawah ke bagian **Tanda**, dan kemudian pilih **Edit**. 1. Jika Anda ingin menghapus semua tanda dari sumber daya ini, pilih **Hapus semua**. Jika tidak, untuk setiap tanda yang ingin Anda hapus dari sumber daya ini, lakukan hal berikut ini: 1. Cari nama tanda di kolom **Kunci**. 1. Pilih **Hapus** pada baris yang sama dengan kunci tanda. 1. Setelah selesai, pilih **Simpan**. ------ #### [ Using the AWS CLI ] Proses untuk menghapus tanda dari sumber daya serupa terlepas dari sumber daya apa yang Anda hapus tandanya. Dalam contoh ini, Anda menghapus tanda dari klaster. Gunakan AWS CLI operasi `remove-tags-from-resource` dengan parameter ini. + **--resource-name**—Wajib. ARN dari sumber daya Amazon DocumentDB yang ingin Anda hapus tandanya. + **--tag-keys**—Wajib. Daftar kunci tanda yang ingin Anda hapus dari sumber daya ini. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb remove-tags-from-resource \ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` Untuk Windows: ``` aws docdb remove-tags-from-resource ^ --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \ --tag-keys key1 key3 ``` Operasi `removed-tags-from-resource` tidak menghasilkan keluaran. Untuk melihat hasil operasi, gunakan operasi `list-tags-for-resource`. ------ # Memelihara Amazon DocumentDB Secara berkala, Amazon DocumentDB melakukan pemeliharaan pada sumber daya Amazon DocumentDB. Pemeliharaan paling sering melibatkan pembaruan ke mesin basis data (pemeliharaan klaster) atau sistem operasi (OS) yang mendasari instans (pemeliharaan instans). Pembaruan mesin database adalah tambalan yang diperlukan dan mencakup perbaikan keamanan, perbaikan bug, dan penyempurnaan pada mesin database. Meskipun sebagian besar tambalan sistem operasi bersifat opsional, jika Anda tidak menerapkannya untuk sementara waktu, tambalan mungkin diperlukan dan diterapkan secara otomatis untuk menjaga postur keamanan Anda. Jadi, kami menyarankan Anda menerapkan pembaruan sistem operasi ke instans Amazon DocumentDB Anda segera setelah tersedia. Patch mesin database mengharuskan Anda membuat cluster Amazon DocumentDB offline untuk waktu yang singkat. Setelah tersedia, tambalan ini secara otomatis dijadwalkan untuk diterapkan selama jendela pemeliharaan terjadwal yang akan datang dari cluster Amazon DocumentDB Anda. Pemeliharaan klaster dan instans memiliki jendela pemeliharaan masing-masing. Modifikasi cluster dan instance yang telah Anda pilih untuk tidak segera diterapkan, juga diterapkan selama jendela pemeliharaan. Secara default, saat Anda membuat klaster, Amazon DocumentDB menetapkan jendela pemeliharaan untuk klaster dan setiap instans tunggal. Anda dapat memilih jendela pemeliharaan saat membuat klaster atau instans. Anda juga dapat mengubah jendela pemeliharaan kapan saja agar sesuai dengan jadwal atau praktik bisnis Anda. Umumnya disarankan untuk memilih jendela pemeliharaan yang meminimalkan dampak pemeliharaan pada aplikasi Anda (misalnya, pada malam hari atau akhir pekan). **Topics** + [Pemberitahuan untuk patch mesin Amazon DocumentDB](#patch-notifications) + [Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda](#view-pending-maintenance) + [Pembaruan mesin Amazon DocumentDB](#db-instance-updates-apply) + [Pembaruan yang diprakarsai pengguna](#user-initiated-updates) + [Mengelola jendela pemeliharaan Amazon DocumentDB Anda](#maintenance-window) + [Pembaruan sistem operasi Amazon DocumentDB](#os-system-updates) ## Pemberitahuan untuk patch mesin Amazon DocumentDB Anda akan menerima pemberitahuan pemeliharaan untuk patch mesin database yang diperlukan melalui acara kesehatan di Dasbor Health (AHD) di AWS konsol dan melalui email. Ketika patch pemeliharaan mesin Amazon DocumentDB tersedia di wilayah AWS tertentu, semua akun pengguna Amazon DocumentDB yang terkena dampak di wilayah tersebut akan menerima pemberitahuan AHD dan email untuk setiap versi Amazon DocumentDB yang terpengaruh oleh tambalan. Anda dapat melihat pemberitahuan ini di bawah bagian **Perubahan terjadwal** AHD di AWS konsol. Pemberitahuan akan memiliki detail tentang waktu ketersediaan patch, jadwal penerapan otomatis, daftar cluster yang terkena dampak, dan catatan rilis. Pemberitahuan ini juga akan dikirimkan melalui e-mail ke alamat email pengguna root AWS akun. ![\[Konsol Amazon DocumentDB menampilkan tab Perubahan terjadwal untuk peningkatan patch mesin.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/scheduled-changes.png) Setelah Anda menerima pemberitahuan ini, Anda dapat memilih untuk menerapkan sendiri patch mesin ini ke cluster Amazon DocumentDB Anda sebelum tanggal penerapan otomatis yang dijadwalkan. Atau Anda dapat menunggu patch mesin diterapkan secara otomatis selama jendela pemeliharaan yang akan datang (opsi default). **catatan** **Status** untuk notifikasi di AHD akan diatur ke 'Sedang Berlangsung' hingga patch mesin Amazon DocumentDB baru dengan versi patch mesin baru dirilis. Setelah patch mesin diterapkan ke cluster Amazon DocumentDB Anda, versi patch mesin cluster akan diperbarui untuk mencerminkan versi dalam notifikasi. Anda dapat menjalankan `db.runCommand({getEngineVersion: 1})` perintah untuk memverifikasi pembaruan ini. AWS Health juga terintegrasi dengan Amazon EventBridge yang menggunakan peristiwa untuk membangun aplikasi berbasis peristiwa yang dapat diskalakan dan terintegrasi dengan lebih dari 20 target, termasuk, Amazon Simple Queue Service (SQS) AWS Lambda, dan lainnya. Anda dapat menggunakan kode `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` acara untuk mengatur Amazon EventBridge sebelum tambalan mesin tersedia. Anda dapat mengatur EventBridge untuk menanggapi peristiwa dan melakukan tindakan otomatis seperti menangkap informasi peristiwa, memulai acara tambahan, mengirim pemberitahuan melalui saluran tambahan seperti pemberitahuan push ke, dan mengambil tindakan korektif atau tindakan lainnya AWS Console Mobile Application, ketika patch mesin Amazon DocumentDB tersedia di wilayah Anda. Dalam skenario langka Amazon DocumentDB membatalkan patch mesin, Anda akan menerima pemberitahuan AHD serta email yang memberi tahu Anda tentang pembatalan. Dengan demikian, Anda dapat menggunakan kode `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` acara untuk mengatur Amazon EventBridge untuk menanggapi acara ini. Lihat *Panduan EventBridge Pengguna Amazon* untuk mempelajari lebih lanjut tentang menggunakan [ EventBridge aturan Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html). ## Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda Anda dapat melihat apakah pembaruan pemeliharaan tersedia untuk klaster Anda dengan menggunakan Konsol Manajemen AWS atau file AWS CLI. Jika pembaruan tersedia, Anda dapat melakukan salah satu hal berikut: + Tunda tindakan pemeliharaan yang saat ini dijadwalkan untuk jendela pemeliharaan berikutnya (hanya untuk patch OS). + Terapkan tindakan pemeliharaan segera. + Jadwalkan tindakan pemeliharaan untuk dimulai selama periode pemeliharaan berikutnya. **catatan** Jika Anda tidak mengambil tindakan, tindakan pemeliharaan yang diperlukan seperti tambalan engine akan diterapkan secara otomatis di jendela pemeliharaan terjadwal yang akan datang. Jendela pemeliharaan menentukan kapan operasi yang tertunda dimulai, tetapi tidak membatasi total waktu pelaksanaan operasi ini. ------ #### [ Using the Konsol Manajemen AWS ] 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Jika pembaruan tersedia, ini ditunjukkan dengan kata **Tersedia**, **Diperlukan**, atau **Jendela Berikutnya** di kolom **Pemeliharaan** untuk cluster di konsol Amazon DocumentDB, seperti yang ditunjukkan di sini: ![\[Konsol Amazon DocumentDB menampilkan kolom Pemeliharaan untuk klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/db-cluster-maintenance-updates-status.png) 1. Untuk mengambil tindakan, pilih cluster untuk menampilkan detailnya, lalu pilih **Maintenance & backup**. Item **Pemeliharaan Tertunda** muncul. ![\[Konsol Amazon DocumentDB menampilkan jendela Pemeliharaan cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/cluster-maint-3.png) ------ #### [ Using the AWS CLI ] Gunakan AWS CLI operasi berikut untuk menentukan tindakan pemeliharaan apa yang tertunda. Output di sini menunjukkan tidak ada tindakan pemeliharaan yang tertunda. ``` aws docdb describe-pending-maintenance-actions ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "PendingMaintenanceActions": [] } ``` ------ ## Pembaruan mesin Amazon DocumentDB Dengan Amazon DocumentDB, Anda dapat memilih kapan menerapkan operasi pemeliharaan. Anda dapat memutuskan kapan Amazon DocumentDB menerapkan pembaruan menggunakan atau. Konsol Manajemen AWS AWS CLI Gunakan prosedur dalam topik ini untuk segera meningkatkan atau menjadwalkan peningkatan untuk klaster Anda. ------ #### [ Using the Konsol Manajemen AWS ] Anda dapat menggunakan konsol untuk mengelola pembaruan untuk cluster Amazon DocumentDB Anda. **Untuk mengelola pembaruan untuk klaster** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Pada panel navigasi, silakan pilih **Klaster**. 1. Dalam daftar klaster, pilih tombol di samping nama klaster yang ingin Anda terapkan operasi pemeliharaannya. 1. Pada menu **Tindakan**, pilih salah satu dari berikut ini: + **Perbarui sekarang** untuk segera melakukan tugas pemeliharaan yang tertunda. + **Perbarui di jendela berikutnya** untuk melakukan tugas pemeliharaan yang tertunda selama jendela pemeliharaan klaster berikutnya. Atau, Anda dapat mengklik **Terapkan sekarang** atau **Terapkan di jendela pemeliharaan berikutnya** di bagian Pemeliharaan Tertunda pada tab **Pemeliharaan & pencadangan** cluster (lihat **Menggunakan Konsol Manajemen AWS di** bagian sebelumnya). **catatan** Jika tidak ada tugas pemeliharaan yang tertunda, semua opsi sebelumnya tidak aktif. ------ #### [ Using the AWS CLI ] Untuk menerapkan pembaruan yang tertunda ke cluster, gunakan `apply-pending-maintenance-action` AWS CLI operasi. **Parameter** + **--resource-identifier**—Amazon DocumentDB Amazon Resource Name (ARN) dari sumber daya tempat tindakan pemeliharaan tertunda diterapkan. + **--apply-action**—Tindakan pemeliharaan yang tertunda untuk diterapkan ke sumber daya ini. Nilai yang valid: `system-update` dan `db-upgrade`. + **--opt-in-type**—Nilai yang menentukan jenis permintaan keikutsertaan, atau membatalkan permintaan keikutsertaan. Permintaan keikutsertaan tipe `immediate` tidak dapat diurungkan. Nilai valid: + `immediate`—Terapkan tindakan pemeliharaan segera. + `next-maintenance`—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya untuk sumber daya. + `undo-opt-in`—Membatalkan permintaan keikutsertaan `next-maintenance` yang ada. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \ --apply-action system-update \ --opt-in-type immediate ``` Untuk Windows: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^ --apply-action system-update ^ --opt-in-type immediate ``` Untuk mengembalikan daftar sumber daya yang memiliki setidaknya satu pembaruan yang tertunda, gunakan `describe-pending-maintenance-actions` AWS CLI perintah. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb ``` Untuk Windows: ``` aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2019-01-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2019-01-18T03:01:00Z", "AutoAppliedAfterDate": "2019-01-11T03:01:00Z" } ] } ] } ``` Anda juga dapat mengembalikan daftar sumber daya untuk cluster dengan menentukan `--filters` parameter `describe-pending-maintenance-actions` AWS CLI operasi. Format untuk operasi `--filters` adalah `Name=filter-name,Values=resource-id,...`. `db-cluster-id`adalah nilai yang dapat diterima untuk `Name` parameter filter. Nilai ini menerima daftar pengidentifikasi cluster atau. ARNs Daftar yang dikembalikan hanya mencakup tindakan pemeliharaan tertunda untuk kluster yang diidentifikasi oleh pengidentifikasi ini atau. ARNs Contoh berikut mengembalikan tindakan pemeliharaan tertunda untuk klaster `sample-cluster1` dan `sample-cluster2`. **Example** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-pending-maintenance-actions \ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2 ``` Untuk Windows: ``` aws docdb describe-pending-maintenance-actions ^ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2 ``` ------ ### Terapkan tanggal Setiap tindakan pemeliharaan memiliki tanggal penerapan masing-masing yang dapat Anda temukan saat menjelaskan tindakan pemeliharaan yang tertunda. Saat Anda membaca output tindakan pemeliharaan yang tertunda dari AWS CLI, tiga tanggal dicantumkan. Nilai tanggal ini adalah `null` saat pemeliharaan bersifat opsional. Nilai terisi setelah tindakan pemeliharaan yang sesuai dijadwalkan atau diterapkan. + **CurrentApplyDate**—Tanggal tindakan pemeliharaan akan diterapkan baik segera atau selama jendela pemeliharaan berikutnya. + **ForcedApplyDate**—Tanggal saat pemeliharaan akan diterapkan secara otomatis, terlepas dari jangka waktu pemeliharaan Anda. + **AutoAppliedAfterDate**—Tanggal setelah pemeliharaan akan diterapkan selama jendela pemeliharaan klaster. ## Pembaruan yang diprakarsai pengguna Sebagai pengguna Amazon DocumentDB, Anda dapat memulai pembaruan untuk klaster atau instans Anda. Misalnya, Anda dapat mengubah kelas instans menjadi kelas dengan memori lebih banyak atau lebih sedikit, atau Anda dapat mengubah grup parameter klaster. Amazon DocumentDB melihat perubahan ini secara berbeda dari pembaruan yang dimulai Amazon DocumentDB. Untuk informasi selengkapnya tentang memodifikasi klaster atau instans, lihat berikut ini: + [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md) + [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md) Untuk melihat daftar modifikasi yang dimulai oleh pengguna yang tertunda, jalankan perintah berikut. **Example** **Untuk melihat perubahan yang dimulai oleh pengguna yang tertunda untuk instans Anda** Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]' ``` Untuk Windows: ``` aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]' ``` Output dari operasi ini terlihat seperti berikut (format JSON). Dalam hal ini, `sample-cluster-instance` memiliki perubahan yang tertunda ke kelas instans `db.r5.xlarge`, sedangkan `sample-cluster-instance-2` tidak memiliki perubahan yang tertunda. ``` [ [ "sample-cluster", "sample-cluster-instance", { "DBInstanceClass": "db.r5.xlarge" } ], [ "sample-cluster", "sample-cluster-instance-2", {} ] ] ``` ## Mengelola jendela pemeliharaan Amazon DocumentDB Anda Setiap instans dan klaster memiliki jendela pemeliharaan mingguan selama perubahan yang tertunda diterapkan. Jendela pemeliharaan adalah kesempatan untuk mengendalikan kapan modifikasi dan patch perangkat lunak terjadi, jika diminta atau diperlukan. Jika peristiwa pemeliharaan dijadwalkan untuk minggu tertentu, itu dilakukan selama periode pemeliharaan 30 menit yang Anda identifikasi. Sebagian besar peristiwa pemeliharaan juga selesai selama jendela pemeliharaan 30 menit, meskipun peristiwa pemeliharaan yang lebih besar mungkin memerlukan waktu lebih dari 30 menit untuk diselesaikan. Jendela pemeliharaan 30 menit dipilih secara acak dari blok waktu 8 jam per Wilayah. Jika Anda tidak menentukan jendela pemeliharaan pilihan saat membuat instans atau klaster, Amazon DocumentDB menugaskan jendela pemeliharaan 30 menit pada hari yang dipilih secara acak dalam seminggu. Tabel berikut mencantumkan blok waktu untuk setiap Wilayah dari mana jendela pemeliharaan default ditugaskan. | Nama Wilayah | Region | Blok Waktu UTC | | --- | --- | --- | | AS Timur (Ohio) | us-east-2 | 03:00-11:00 | | US East (Northern Virginia) | us-east-1 | 03:00-11:00 | | AS Barat (Oregon) | us-west-2 | 06:00-14:00 | | Africa (Cape Town) | af-south-1 | 03:00 — 11:00 | | Asia Pasifik (Hong Kong) | ap-east-1 | 06:00-14:00 | | Asia Pasifik (Hyderabad) | ap-south-2 | 06:30 — 14:30 | | Asia Pasifik (Malaysia) | ap-southeast-5 | 13:00-21:00 | | Asia Pasifik (Mumbai) | ap-south-1 | 06:00-14:00 | | Asia Pacific (Osaka) | ap-northeast-3 | 12:00-20:00 | | Asia Pasifik (Seoul) | ap-northeast-2 | 13:00-21:00 | | Asia Pasifik (Singapura) | ap-southeast-1 | 14:00-22:00 | | Asia Pasifik (Sydney) | ap-southeast-2 | 12:00-20:00 | | Asia Pasifik (Jakarta) | ap-southeast-3 | 08:00-16:00 | | Asia Pacific (Melbourne) | ap-southeast-4 | 11:00-19:00 | | Asia Pasifik (Thailand) | ap-tenggara 7 | 15:00-23:00 | | Asia Pasifik (Tokyo) | ap-northeast-1 | 13:00-21:00 | | Kanada (Pusat) | ca-central-1 | 03:00-11:00 | | Tiongkok (Beijing) | cn-north-1 | 06:00-14:00 | | Tiongkok (Ningxia) | cn-northwest-1 | 06:00-14:00 | | Eropa (Frankfurt) | eu-central-1 | 21:00-05:00 | | Europe (Zurich) | eu-central-2 | 02:00-10:00 | | Eropa (Irlandia) | eu-west-1 | 22:00-06:00 | | Eropa (London) | eu-west-2 | 22:00-06:00 | | Europe (Milan) | eu-south-1 | 02:00-10:00 | | Eropa (Paris) | eu-west-3 | 23:59-07:29 | | Eropa (Spanyol) | eu-south-2 | 02:00 — 10:00 | | Eropa (Stockholm) | eu-north-1 | 04:00 — 12:00 | | Meksiko (Tengah) | mx-pusat-1 | 03:00-11:00 | | Timur Tengah (UAE) | me-central-1 | 05:00 — 13:00 | | Amerika Selatan (Sao Paulo) | sa-east-1 | 00:00-08:00 | | Israel (Tel Aviv) | il-central-1 | 04:00-12:00 | | AWS GovCloud (AS-Timur) | us-gov-east-1 | 17:00-01:00 | | AWS GovCloud (AS-Barat) | us-gov-west-1 | 06:00-14:00 | ### Mengubah jendela pemeliharaan Amazon DocumentDB Anda Waktu pemeliharaan harus jatuh pada saat penggunaan terendah dan dengan demikian mungkin perlu diubah dari waktu ke waktu. Klaster atau instans Anda tidak tersedia selama waktu ini hanya jika perubahan sistem (seperti operasi penyimpanan skala atau perubahan kelas instans) sedang diterapkan dan memerlukan penghentian. Dan kemudian itu tidak tersedia hanya untuk jumlah waktu minimum yang diperlukan untuk membuat perubahan yang diperlukan. Untuk pembaruan ke mesin basis data, Amazon DocumentDB menggunakan jendela pemeliharaan pilihan klaster dan bukan jendela pemeliharaan untuk instans individual. **Mengubah waktu pemeliharaan** + Untuk sebuah klaster, lihat [Memodifikasi cluster Amazon DocumentDB](db-cluster-modify.md). + Untuk sebuah instans, lihat [Memodifikasi instance Amazon DocumentDB](db-instance-modify.md). ## Pembaruan sistem operasi Amazon DocumentDB Instans di cluster Amazon DocumentDB terkadang memerlukan pembaruan sistem operasi. Amazon DocumentDB meningkatkan sistem operasi ke versi yang lebih baru untuk meningkatkan kinerja database dan postur keamanan pelanggan secara keseluruhan. Pembaruan sistem operasi tidak mengubah versi mesin cluster atau kelas instans dari instans Amazon DocumentDB. Sebaiknya Anda memperbarui instance pembaca di klaster terlebih dahulu, lalu instance penulis untuk memaksimalkan ketersediaan klaster Anda. Kami tidak menyarankan untuk memperbarui instance pembaca dan penulis secara bersamaan, karena Anda mungkin mengalami downtime yang lebih lama jika terjadi failover. Sebagian besar pembaruan sistem operasi untuk Amazon DocumentDB bersifat opsional dan tidak memiliki tanggal yang ditetapkan untuk menerapkannya. Namun, jika Anda tidak menerapkan pembaruan ini untuk sementara waktu, pembaruan tersebut pada akhirnya mungkin diperlukan dan diterapkan secara otomatis selama jendela pemeliharaan instans Anda. Ini untuk membantu menjaga postur keamanan database Anda. Untuk menghindari waktu henti yang tidak terduga, sebaiknya Anda menerapkan pembaruan sistem operasi ke instans Amazon DocumentDB Anda segera setelah tersedia dan mengatur jendela pemeliharaan instans Anda pada saat yang sesuai dengan kebutuhan bisnis Anda. Untuk diberi tahu saat pembaruan opsional baru tersedia, Anda dapat berlangganan RDS-EVENT-0230 dalam kategori acara penambalan keamanan. Untuk informasi tentang berlangganan acara Amazon DocumentDB, lihat Berlangganan [Langganan Acara Amazon](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-subscriptions.subscribe.html) DocumentDB. Anda harus mengharapkan bahwa ketika pemeliharaan dilakukan pada klaster atau instans Anda, jika instans adalah instans primer, itu akan gagal. Untuk meningkatkan ketersediaan, sebaiknya gunakan lebih dari satu instans untuk klaster Amazon DocumentDB Anda. Untuk informasi selengkapnya, lihat [Failover Amazon DocumentDB](failover.md). **catatan** Untuk fitur pengelolaan tertentu, Amazon DocumentDB menggunakan teknologi operasional yang dibagi dengan Amazon Relational Database Service (Amazon RDS). **penting** Instans Amazon DocumentDB Anda akan offline selama peningkatan sistem operasi. Anda dapat meminimalkan waktu henti klaster dengan memiliki klaster multi-instance. Jika Anda tidak memiliki klaster multi-instance maka Anda dapat memilih untuk membuatnya sementara dengan menambahkan instance sekunder untuk melakukan pemeliharaan ini, lalu menghapus instance pembaca tambahan setelah pemeliharaan selesai (biaya reguler untuk instance sekunder akan berlaku). **catatan** Tetap mengikuti semua pembaruan opsional dan wajib mungkin diperlukan untuk memenuhi berbagai kewajiban kepatuhan. Kami menyarankan Anda menerapkan semua pembaruan yang disediakan oleh Amazon DocumentDB secara rutin selama jendela pemeliharaan Anda. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk menentukan apakah pembaruan tersedia. ------ #### [ Using the Konsol Manajemen AWS ] Untuk menentukan apakah pembaruan tersedia menggunakan Konsol Manajemen AWS: 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Clusters**, lalu pilih instance. 1. Pilih **Pemeliharaan**. 1. Di bagian **Pending Maintenance**, temukan pembaruan sistem operasi. ![\[Konsol Amazon DocumentDB menampilkan kolom Pemeliharaan untuk klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/maintenance-available-1.png) Anda dapat memilih pembaruan sistem operasi dan klik **Terapkan sekarang** atau **Terapkan di jendela pemeliharaan berikutnya** di bagian **Pemeliharaan Tertunda**. Jika nilai pemeliharaan adalah **jendela berikutnya**, tunda item pemeliharaan dengan memilih **Defer upgrade**. Anda tidak dapat menunda tindakan pemeliharaan jika sudah dimulai. **Atau, Anda dapat memilih instance dari daftar cluster dengan mengklik **Cluster** di panel navigasi dan pilih **Terapkan sekarang atau Terapkan** **di jendela pemeliharaan berikutnya** dari menu Tindakan.** ------ #### [ Using the AWS CLI ] Untuk menentukan apakah pembaruan tersedia menggunakan AWS CLI, panggil `describe-pending-maintenance-actions` perintah: ``` aws docdb describe-pending-maintenance-actions ``` ``` { "ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "New Operating System update is available" } ] } ``` ------ Pembaruan sistem operasi khusus untuk versi mesin Amazon DocumentDB dan kelas instance. Oleh karena itu, instans Amazon DocumentDB menerima atau memerlukan pembaruan pada waktu yang berbeda. Ketika pembaruan sistem operasi tersedia untuk instans Anda berdasarkan versi mesin dan kelas instans, pembaruan muncul di konsol. Hal ini juga dapat dilihat dengan menjalankan AWS CLI `describe-pending-maintenance-actions` perintah atau dengan memanggil operasi `DescribePendingMaintenanceActions` API. Jika Anda tidak menjalankan rilis patch cluster terbaru dari mesin Amazon DocumentDB Anda, Anda mungkin tidak melihat pembaruan sistem operasi terdaftar sebagai pemeliharaan yang tersedia. Untuk melihat dan mengelola pembaruan sistem operasi, Anda harus terlebih dahulu meningkatkan ke versi patch mesin terbaru. # Memahami peran terkait layanan Amazon DocumentDB (dengan kompatibilitas MongoDB) menggunakan peran terkait layanan (IAM). AWS Identity and Access Management [Peran tertaut layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) adalah jenis IAM role unik yang tertaut secara langsung ke Amazon DocumentDB. Peran terkait layanan telah ditentukan sebelumnya oleh Amazon DocumentDB dan menyertakan semua izin yang diperlukan layanan untuk memanggil layanan lain atas nama Anda. AWS Peran tertaut layanan membuat penggunaan Amazon DocumentDB lebih mudah karena Anda tidak perlu menambahkan izin yang diperlukan secara manual. Amazon DocumentDB menentukan izin peran tertaut layanannya, dan kecuali ditentukan lain, hanya Amazon DocumentDB yang dapat menjalankan perannya. Izin yang ditentukan mencakup kebijakan kepercayaan dan kebijakan izin, serta bahwa kebijakan izin tidak dapat dilampirkan ke entitas IAM lainnya. Anda dapat menghapus peran hanya setelah terlebih dahulu menghapus sumber daya terkaitnya. Ini melindungi sumber daya Amazon DocumentDB karena Anda tidak dapat secara tidak sengaja menghapus izin untuk mengakses sumber daya. Untuk informasi tentang layanan lain yang mendukung peran terkait layanan, lihat [Layanan AWS yang bisa digunakan dengan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dan carilah layanan yang memiliki opsi **Ya** di kolom **Peran Terkait Layanan**. Pilih **Ya** dengan sebuah tautan untuk melihat dokumentasi peran terkait layanan untuk layanan tersebut. ## Izin peran terkait layanan Amazon DocumentDB Amazon DocumentDB (dengan kompatibilitas MongoDB) menggunakan peran terkait layanan **AWSServiceRoleForbernama** RDS untuk memungkinkan Amazon DocumentDB memanggil layanan atas nama kluster Anda. AWS Peran terkait layanan AWSService RoleFor RDS mempercayai layanan berikut untuk mengambil peran: + `docdb.amazonaws.com` Kebijakan izin peran mengizinkan Amazon DocumentDB untuk menyelesaikan tindakan berikut ini pada sumber daya yang ditentukan: + Tindakan pada `ec2`: + `AssignPrivateIpAddresses` + `AuthorizeSecurityGroupIngress` + `CreateNetworkInterface` + `CreateSecurityGroup` + `DeleteNetworkInterface` + `DeleteSecurityGroup` + `DescribeAvailabilityZones` + `DescribeInternetGateways` + `DescribeSecurityGroups` + `DescribeSubnets` + `DescribeVpcAttribute` + `DescribeVpcs` + `ModifyNetworkInterfaceAttribute` + `RevokeSecurityGroupIngress` + `UnassignPrivateIpAddresses` + Tindakan pada `sns`: + `ListTopic` + `Publish` + Tindakan pada `cloudwatch`: + `PutMetricData` + `GetMetricData` + `CreateLogStream` + `PullLogEvents` + `DescribeLogStreams` + `CreateLogGroup` **catatan** Anda harus mengonfigurasi izin agar entitas IAM (seperti pengguna, grup, atau peran) dapat membuat, mengedit, atau menghapus peran terkait layanan. Anda mungkin menemukan pesan kesalahan berikut ini: **Tidak dapat membuat sumber daya. Verifikasi bahwa Anda memiliki izin untuk membuat peran terkait layanan. Jika tidak, tunggu dan coba lagi nanti.** Jika Anda melihat kesalahan ini, pastikan Anda mengaktifkan izin berikut ini: ``` { "Action": "iam:CreateServiceLinkedRole", "Effect": "Allow", "Resource": "arn:aws:iam::*:role/aws-service-role/rds.amazonaws.com/AWSServiceRoleForRDS", "Condition": { "StringLike": { "iam:AWSServiceName":"rds.amazonaws.com" } } } ``` Untuk informasi selengkapnya, silakan lihat [Izin Peran Tertaut Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) di *Panduan Pengguna IAM*. ## Membuat peran terkait layanan Amazon DocumentDB Anda tidak perlu membuat peran terkait layanan secara manual. Saat Anda membuat klaster, Amazon DocumentDB membuat peran tertaut layanan untuk Anda. Jika Anda menghapus peran tertaut layanan ini dan ingin membuatnya lagi, Anda dapat mengulangi proses yang sama untuk membuat kembali peran tersebut di akun Anda. Saat Anda membuat klaster, Amazon DocumentDB membuat peran tertaut layanan untuk Anda. ## Memodifikasi peran terkait layanan Amazon DocumentDB Amazon DocumentDB tidak mengizinkan Anda memodifikasi peran terkait layanan RDS AWSServiceRoleFor. Setelah membuat peran terkait layanan, Anda tidak dapat mengubah nama peran karena berbagai entitas mungkin merujuk peran tersebut. Namun demikian, Anda dapat memodifikasi penjelasan peran menggunakan IAM. Untuk informasi selengkapnya, lihat [Mengedit Peran Tertaut Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) dalam *Panduan Pengguna IAM*. ## Menghapus peran terkait layanan Amazon DocumentDB Jika Anda tidak lagi perlu menggunakan fitur atau layanan yang memerlukan peran tertaut layanan, sebaiknya hapus peran tersebut. Dengan begitu, Anda tidak perlu lagi memantau atau memelihara entitas yang tidak digunakan. Namun demikian, Anda harus menghapus semua klaster Anda sebelum Anda dapat menghapus peran tertaut layanan. ### Membersihkan peran terkait layanan Amazon DocumentDB Sebelum dapat menggunakan IAM untuk menghapus peran tertaut layanan, Anda harus mengonfirmasi terlebih dahulu bahwa peran tersebut tidak memiliki sesi aktif dan menghapus sumber daya yang digunakan oleh peran tersebut. **Untuk memeriksa apakah peran tertaut layanan memiliki sesi aktif menggunakan konsol** 1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Di panel navigasi konsol IAM, pilih **Peran, lalu pilih nama (bukan kotak centang) peran AWSService** **RoleForRDS**. 1. Di halaman **Ringkasan** untuk peran yang dipilih, pilih tab **Penasihat Akses**. 1. Di tab **Penasihat Akses**, ‍tinjau aktivitas terbaru untuk peran tertaut layanan. **catatan** Jika Anda tidak yakin apakah Amazon DocumentDB AWSService RoleFor menggunakan peran RDS, Anda dapat mencoba menghapus peran tersebut. Jika layanan ini menggunakan peran tersebut, peran tidak dapat dihapus dan Anda dapat melihat Wilayah tempat peran tersebut digunakan. Jika peran tersebut sedang digunakan, Anda harus menunggu hingga sesi ini berakhir sebelum dapat menghapus peran tersebut. Anda tidak dapat mencabut sesi untuk peran terkait layanan. Jika Anda ingin menghapus peran AWSService RoleFor RDS, Anda harus terlebih dahulu menghapus *semua* instance dan cluster Anda. Untuk informasi tentang menghapus instans dan klaster, lihat topik berikut ini: + [Menghapus instans Amazon DocumentDB](db-instance-delete.md) + [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md) ## Wilayah yang didukung untuk peran terkait layanan Amazon DocumentDB Amazon DocumentDB mendukung menggunakan peran tertaut layanan di semua Wilayah tempat layanan tersedia. Lihat informasi yang lebih lengkap di [https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability](https://docs.aws.amazon.com/documentdb/latest/developerguide/regions-and-azs.html#regions-and-azs-availability).   # Menggunakan aliran perubahan dengan Amazon DocumentDB Fitur aliran perubahan di Amazon DocumentDB (dengan kompatibilitas MongoDB) menyediakan urutan waktu peristiwa perubahan yang terjadi dalam koleksi klaster Anda. Anda dapat membaca peristiwa dari aliran perubahan untuk menerapkan banyak kasus penggunaan yang berbeda, termasuk yang berikut: + Notifikasi perubahan + Pencarian teks lengkap dengan Amazon OpenSearch Service (OpenSearch Layanan) + Analitik dengan Amazon Redshift Aplikasi dapat menggunakan aliran perubahan untuk berlangganan perubahan data pada koleksi individu. Peristiwa aliran perubahan diurutkan saat terjadi di klaster dan disimpan selama 3 jam (secara default) setelah peristiwa dicatat. Periode retensi dapat diperpanjang hingga 7 hari menggunakan parameter `change_stream_log_retention_duration`. Untuk mengubah periode retensi aliran perubahan, lihat [Memodifikasi Durasi Retensi Log Aliran Perubahan](https://docs.aws.amazon.com/documentdb/latest/developerguide/change_streams.html#change_streams-modifying_log_retention). **Topics** + [Operasi yang didukung](#change_streams-supported_ops) + [Penagihan](#change_streams-billing) + [Batasan](#change_streams-limitations) + [Mengaktifkan aliran perubahan](#change_streams-enabling) + [Contoh: menggunakan aliran perubahan dengan Python](#change_streams-using_example) + [Pencarian dokumen lengkap](#change_streams-lookup) + [Melanjutkan aliran perubahan](#change_streams-resuming) + [Melanjutkan aliran perubahan dengan `startAtOperationTime`](#change_streams-startAtOperation) + [Melanjutkan aliran perubahan dengan `postBatchResumeToken`](#change_streams-postBatchResumeToken) + [Transaksi di aliran perubahan](#change_streams-transactions) + [Memodifikasi durasi retensi log aliran perubahan](#change_streams-modifying_log_retention) + [Menggunakan aliran perubahan pada instance sekunder](#change-streams-secondary-instances) ## Operasi yang didukung Amazon DocumentDB mendukung operasi berikut untuk aliran perubahan: + Semua peristiwa perubahan didukung di API `db.collection.watch()`, `db.watch()` dan `client.watch()` MongoDB. + Pencarian dokumen lengkap untuk pembaruan. + Tahap agregasi: `$match`, `$project`, `$redact`, serta `$addFields` dan `$replaceRoot`. + Melanjutkan aliran perubahan dari token resume + Melanjutkan aliran perubahan dari stempel waktu menggunakan `startAtOperation` (berlaku untuk Amazon DocumentDB 4.0\$1) ## Penagihan Fitur aliran perubahan Amazon DocumentDB dinonaktifkan secara default dan tidak dikenakan biaya tambahan apa pun hingga fitur tersebut diaktifkan. Menggunakan aliran perubahan dalam cluster menimbulkan biaya baca dan tulis IOs dan penyimpanan tambahan. Anda dapat menggunakan operasi API `modifyChangeStreams` untuk mengaktifkan fitur ini untuk klaster Anda. Untuk informasi selengkapnya tentang penentuan harga, lihat [Penentuan harga Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/). ## Batasan Aliran perubahan memiliki batasan berikut di Amazon DocumentDB: + Di Amazon DocumentDB 3.6. dan Amazon DocumentDB 4.0, aliran perubahan hanya dapat dibuka dari koneksi ke instance utama cluster Amazon DocumentDB. Membaca dari aliran perubahan pada instance replika tidak didukung di Amazon DocumentDB 3.6. dan Amazon DocumentDB 4.0. Ketika memanggil operasi API `watch()`, Anda harus menentukan preferensi baca `primary` untuk memastikan bahwa semua pembacaan diarahkan ke instans primer (lihat bagian [Contoh](#change_streams-using_example)). + Di Amazon DocumentDB 5.0, aliran perubahan dapat dibuka dari instans primer dan instance sekunder, termasuk klaster global. Anda dapat menentukan preferensi baca sekunder untuk mengarahkan aliran perubahan ke instance sekunder. Lihat [Menggunakan aliran perubahan pada instance sekunder](#change-streams-secondary-instances) untuk praktik dan batasan terbaik tambahan. + Peristiwa yang ditulis ke aliran perubahan untuk koleksi tersedia hingga 7 hari (defaultnya adalah 3 jam). Data aliran perubahan dihapus setelah jendela durasi retensi log, meskipun tidak ada perubahan baru yang terjadi. + Operasi tulis yang berjalan lama pada koleksi seperti `updateMany` atau `deleteMany` dapat menghentikan sementara penulisan peristiwa aliran perubahan hingga operasi tulis yang berjalan lama selesai. + Amazon DocumentDB tidak mendukung log operasi MongoDB (`oplog`). + Dengan Amazon DocumentDB, Anda harus secara eksplisit mengaktifkan aliran perubahan pada koleksi tertentu. + Jika ukuran total peristiwa aliran perubahan (termasuk data perubahan dan dokumen lengkap, jika diminta) lebih besar dari `16 MB`, klien akan mengalami kegagalan baca pada aliran perubahan. + Driver Ruby saat ini tidak didukung saat menggunakan `db.watch()` dan `client.watch()` dengan Amazon DocumentDB 3.6. + Output dari `updateDescription` perintah dalam aliran perubahan berbeda di Amazon DocumentDB daripada di MongoDB ketika nilai bidang yang diperbarui sama dengan yang sebelumnya: + Amazon DocumentDB tidak mengembalikan bidang dalam `updateDescription` output jika bidang yang disediakan ditentukan dalam `$set` perintah dan nilai targetnya sudah sama dengan nilai sumber. + MongoDB mengembalikan bidang dalam output, bahkan jika nilai yang ditentukan sama dengan nilai saat ini. ## Mengaktifkan aliran perubahan Anda dapat mengaktifkan aliran perubahan Amazon DocumentDB untuk semua koleksi dalam basis data tertentu, atau hanya untuk koleksi yang dipilih. Berikut ini adalah contoh cara mengaktifkan aliran perubahan untuk kasus penggunaan yang berbeda menggunakan shell mongo. String kosong diperlakukan sebagai wildcard ketika menentukan nama basis data dan koleksi. ``` //Enable change streams for the collection "foo" in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "foo", enable: true}); ``` ``` //Disable change streams on collection "foo" in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "foo", enable: false}); ``` ``` //Enable change streams for all collections in database "bar" db.adminCommand({modifyChangeStreams: 1, database: "bar", collection: "", enable: true}); ``` ``` //Enable change streams for all collections in all databases in a cluster db.adminCommand({modifyChangeStreams: 1, database: "", collection: "", enable: true}); ``` Aliran perubahan akan diaktifkan untuk koleksi jika apa pun dari berikut ini benar: + Baik basis data dan koleksi diaktifkan secara eksplisit. + Basis data yang berisi koleksi diaktifkan. + Semua basis data diaktifkan. Menjatuhkan koleksi dari basis data tidak menonaktifkan aliran perubahan untuk koleksi tersebut jika basis data induk juga mengaktifkan aliran perubahan, atau jika semua basis data di klaster diaktifkan. Jika koleksi baru dibuat dengan nama yang sama dengan koleksi yang dihapus, aliran perubahan akan diaktifkan untuk koleksi tersebut. Anda dapat membuat daftar semua aliran perubahan yang diaktifkan klaster Anda dengan menggunakan tahap alur agregasi `$listChangeStreams`. Semua tahapan agregasi yang didukung oleh Amazon DocumentDB dapat digunakan dalam alur untuk pemrosesan tambahan. Jika koleksi yang sebelumnya diaktifkan telah dinonaktifkan, koleksi tersebut tidak akan muncul di output `$listChangeStreams`. ``` //List all databases and collections with change streams enabled cursor = new DBCommandCursor(db, db.runCommand( {aggregate: 1, pipeline: [{$listChangeStreams: 1}], cursor:{}})); ``` ``` //List of all databases and collections with change streams enabled { "database" : "test", "collection" : "foo" } { "database" : "bar", "collection" : "" } { "database" : "", "collection" : "" } ``` ``` //Determine if the database “bar” or collection “bar.foo” have change streams enabled cursor = new DBCommandCursor(db, db.runCommand( {aggregate: 1, pipeline: [{$listChangeStreams: 1}, {$match: {$or: [{database: "bar", collection: "foo"}, {database: "bar", collection: ""}, {database: "", collection: ""}]}} ], cursor:{}})); ``` ## Contoh: menggunakan aliran perubahan dengan Python Berikut ini adalah contoh penggunaan aliran perubahan Amazon DocumentDB dengan Python di tingkat koleksi. ``` import os import sys from pymongo import MongoClient, ReadPreference username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] #While ‘Primary’ is the default read preference, here we give an example of #how to specify the required read preference when reading the change streams coll = db.get_collection('foo', read_preference=ReadPreference.PRIMARY) #Create a stream object stream = coll.watch() #Write a new document to the collection to generate a change event coll.insert_one({'x': 1}) #Read the next change event from the stream (if any) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'insert'} """ #A subsequent attempt to read the next change event returns nothing, as there are no new changes print(stream.try_next()) """ Expected Output: None """ #Generate a new change event by updating a document result = coll.update_one({'x': 1}, {'$set': {'x': 2}}) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf99d400000001010000000100009025'}, 'clusterTime': Timestamp(1571789268, 1), 'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'update', 'updateDescription': {'removedFields': [], 'updatedFields': {'x': 2}}} """ ``` Berikut ini adalah contoh penggunaan aliran perubahan Amazon DocumentDB dengan Python di tingkat basis data. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] #Create a stream object stream = db.watch() coll = db.get_collection('foo') #Write a new document to the collection foo to generate a change event coll.insert_one({'x': 1}) #Read the next change event from the stream (if any) print(stream.try_next()) """ Expected Output: {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'insert'} """ #A subsequent attempt to read the next change event returns nothing, as there are no new changes print(stream.try_next()) """ Expected Output: None """ coll = db.get_collection('foo1') #Write a new document to another collection to generate a change event coll.insert_one({'x': 1}) print(stream.try_next()) """ Expected Output: Since the change stream cursor was the database level you can see change events from different collections in the same database {'_id': {'_data': '015daf94f600000002010000000200009025'}, 'clusterTime': Timestamp(1571788022, 2), 'documentKey': {'_id': ObjectId('5daf94f6ea258751778163d6')}, 'fullDocument': {'_id': ObjectId('5daf94f6ea258751778163d6'), 'x': 1}, 'ns': {'coll': 'foo1', 'db': 'bar'}, 'operationType': 'insert'} """ ``` ## Pencarian dokumen lengkap Peristiwa perubahan pembaruan tidak menyertakan dokumen lengkap; itu mencakup hanya perubahan yang telah dibuat. Jika kasus penggunaan Anda memerlukan dokumen lengkap yang terpengaruh oleh pembaruan, Anda dapat mengaktifkan pencarian dokumen lengkap saat membuka aliran. Dokumen `fullDocument` untuk peristiwa aliran perubahan pembaruan mewakili versi terbaru dari dokumen yang diperbarui pada saat pencarian dokumen. Jika terjadi perubahan antara operasi pembaruan dan pencarian `fullDocument`, dokumen `fullDocument` mungkin tidak mewakili status dokumen pada waktu pembaruan. Untuk membuat objek streaming dengan pencarian pembaruan diaktifkan, gunakan contoh ini: ``` stream = coll.watch(full_document='updateLookup') #Generate a new change event by updating a document result = coll.update_one({'x': 2}, {'$set': {'x': 3}}) stream.try_next() ``` Output dari objek stream akan terlihat seperti ini: ``` {'_id': {'_data': '015daf9b7c00000001010000000100009025'}, 'clusterTime': Timestamp(1571789692, 1), 'documentKey': {'_id': ObjectId('5daf9502ea258751778163d7')}, 'fullDocument': {'_id': ObjectId('5daf9502ea258751778163d7'), 'x': 3}, 'ns': {'coll': 'foo', 'db': 'bar'}, 'operationType': 'update', 'updateDescription': {'removedFields': [], 'updatedFields': {'x': 3}}} ``` ## Melanjutkan aliran perubahan Anda dapat melanjutkan aliran perubahan nanti dengan menggunakan token resume, yang sama dengan bidang `_id` dari dokumen peristiwa perubahan yang terakhir diambil. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem', retryWrites='false') db = client['bar'] coll = db.get_collection('foo') #Create a stream object stream = db.watch() coll.update_one({'x': 1}, {'$set': {'x': 4}}) event = stream.try_next() token = event['_id'] print(token) """ Output: This is the resume token that we will later us to resume the change stream {'_data': '015daf9c5b00000001010000000100009025'} """ #Python provides a nice shortcut for getting a stream’s resume token print(stream.resume_token) """ Output {'_data': '015daf9c5b00000001010000000100009025'} """ #Generate a new change event by updating a document result = coll.update_one({'x': 4}, {'$set': {'x': 5}}) #Generate another change event by inserting a document result = coll.insert_one({'y': 5}) #Open a stream starting after the selected resume token stream = db.watch(full_document='updateLookup', resume_after=token) #Our first change event is the update with the specified _id print(stream.try_next()) """ #Output: Since we are resuming the change stream from the resume token, we will see all events after the first update operation. In our case, the change stream will resume from the update operation {x:5} {'_id': {'_data': '015f7e8f0c000000060100000006000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602129676, 6), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2')}, 'fullDocument': {'_id': ObjectId('5f7e8f0ac423bafbfd9adba2'), 'x': 5}, 'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}} """ #Followed by the insert print(stream.try_next()) """ #Output: {'_id': {'_data': '015f7e8f0c000000070100000007000fe038'}, 'operationType': 'insert', 'clusterTime': Timestamp(1602129676, 7), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94')}, 'fullDocument': {'_id': ObjectId('5f7e8f0cbf8c233ed577eb94'), 'y': 5}} """ ``` ## Melanjutkan aliran perubahan dengan `startAtOperationTime` Anda dapat melanjutkan aliran perubahan nanti dari stempel waktu tertentu dengan menggunakan `startAtOperationTime`. **catatan** Kemampuan untuk menggunakan `startAtOperationTime` tersedia di Amazon DocumentDB 4.0\$1. Saat menggunakan `startAtOperationTime`, kursor aliran perubahan hanya akan mengembalikan perubahan yang terjadi pada atau setelah Stempel Waktu yang ditentukan. Perintah `startAtOperationTime` dan `resumeAfter` saling eksklusif dan karenanya tidak dapat digunakan bersama. ``` import os import sys from pymongo import MongoClient username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint” client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='rds-root-ca-2020.pem',retryWrites='false') db = client['bar'] coll = db.get_collection('foo') #Create a stream object stream = db.watch() coll.update_one({'x': 1}, {'$set': {'x': 4}}) event = stream.try_next() timestamp = event['clusterTime'] print(timestamp) """ Output Timestamp(1602129114, 4) """ #Generate a new change event by updating a document result = coll.update_one({'x': 4}, {'$set': {'x': 5}}) result = coll.insert_one({'y': 5}) #Generate another change event by inserting a document #Open a stream starting after specified time stamp stream = db.watch(start_at_operation_time=timestamp) print(stream.try_next()) """ #Output: Since we are resuming the change stream at the time stamp of our first update operation (x:4), the change stream cursor will point to that event {'_id': {'_data': '015f7e941a000000030100000003000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602130970, 3), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e9417c423bafbfd9adbb1')}, 'updateDescription': {'updatedFields': {'x': 4}, 'removedFields': []}} """ print(stream.try_next()) """ #Output: The second event will be the subsequent update operation (x:5) {'_id': {'_data': '015f7e9502000000050100000005000fe038'}, 'operationType': 'update', 'clusterTime': Timestamp(1602131202, 5), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e94ffc423bafbfd9adbb2')}, 'updateDescription': {'updatedFields': {'x': 5}, 'removedFields': []}} """ print(stream.try_next()) """ #Output: And finally the last event will be the insert operation (y:5) {'_id': {'_data': '015f7e9502000000060100000006000fe038'}, 'operationType': 'insert', 'clusterTime': Timestamp(1602131202, 6), 'ns': {'db': 'bar', 'coll': 'foo'}, 'documentKey': {'_id': ObjectId('5f7e95025c4a569e0f6dde92')}, 'fullDocument': {'_id': ObjectId('5f7e95025c4a569e0f6dde92'), 'y': 5}} """ ``` ## Melanjutkan aliran perubahan dengan `postBatchResumeToken` Aliran perubahan Amazon DocumentDB sekarang mengembalikan bidang tambahan yang disebut. `postBatchResumeToken` Bidang ini dikembalikan dari `$changestream` perintah dan `getMore` perintah. Contoh `$changestream` perintah di Python: ``` db.command({"aggregate": "sales", "pipeline": [{ "$changeStream": {}}], "cursor": {"batchSize": 1}}) ``` Keluaran yang diharapkan ``` cursor" : { "firstBatch" : [ ], "postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"}, "id" : NumberLong("9660788144470"), "ns" : "test.sales" } ``` Contoh `getMore` perintah di Python: ``` db.command({"getMore": NumberLong(), "collection": "sales", "batchSize": 1 }) ``` Output yang diharapkan ``` cursor" : { "nextBatch" : [ ], "postBatchResumeToken" : {"_data" : "0167c8cbe60000000004"}, "id" : NumberLong("9660788144470"), "ns" : "test.sales" } ``` `postBatchResumeToken`Bidang ini dapat digunakan untuk membuka kursor aliran perubahan baru di `resumeAfter` lapangan, mirip dengan cara token resume digunakan. Buka aliran mulai setelah dipilih`postBatchResumeToken`: ``` post_batch_resume_token = output['cursor']['postBatchResumeToken'] stream = db.watch(full_document='updateLookup', resume_after=post_batch_resume_token) ``` Tidak seperti token resume biasa yang selalu sesuai dengan entri log operasi (oplog) yang mencerminkan peristiwa aktual, `postBatchResumeToken` sesuai dengan entri oplog yang telah dipindai aliran perubahan di server, yang belum tentu merupakan perubahan yang cocok. Mencoba melanjutkan dengan token resume reguler lama akan memaksa database untuk memindai semua entri oplog antara stempel waktu yang ditentukan dan waktu saat ini. Ini dapat menghasilkan banyak kueri secara internal dengan setiap pemindaian sub-kueri untuk jangka waktu yang singkat. Ini akan menyebabkan lonjakan penggunaan CPU dan menurunkan kinerja database. Melanjutkan dengan yang terakhir `postBatchResumeToken` melewatkan pemindaian entri oplog yang tak tertandingi. ## Transaksi di aliran perubahan Peristiwa aliran perubahan tidak akan berisi peristiwa dari transaksi yang and/or dibatalkan tanpa komitmen. Misalnya, jika Anda memulai transaksi dengan satu `INSERT` operasi dan satu `UPDATE` operasi, dan jika `INSERT` operasi Anda berhasil, tetapi `UPDATE` operasi gagal, transaksi akan dibatalkan. Karena transaksi ini digulung kembali, aliran perubahan Anda tidak akan berisi peristiwa apa pun untuk transaksi ini. ## Memodifikasi durasi retensi log aliran perubahan Anda dapat mengubah durasi retensi log aliran perubahan menjadi antara 1 jam dan 7 hari menggunakan Konsol Manajemen AWS atau AWS CLI. ------ #### [ Using the Konsol Manajemen AWS ] **Untuk memodifikasi durasi retensi log aliran perubahan** 1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb) 1. Di panel navigasi, pilih **Grup parameter**. **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. 1. Di panel **Grup parameter**, pilih grup parameter klaster yang terkait dengan klaster Anda. Untuk mengidentifikasi grup parameter klaster yang terkait dengan klaster Anda, lihat [Menentukan grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine). 1. Halaman yang dihasilkan menunjukkan parameter dan detailnya yang sesuai untuk grup parameter klaster Anda. Pilih parameter `change_stream_log_retention_duration`. 1. Di kanan atas halaman, pilih **Edit** untuk mengubah nilai parameter. `change_stream_log_retention_duration`Parameter dapat dimodifikasi menjadi antara 1 jam dan 7 hari. 1. Buat perubahan Anda, lalu pilih **Modifikasi parameter klaster** untuk menyimpan perubahan. Untuk membuang perubahan Anda, pilih **Batal**. ------ #### [ Using the AWS CLI ] Untuk mengubah parameter `change_stream_log_retention_duration` grup parameter klaster Anda, gunakan operasi `modify-db-cluster-parameter-group` dengan parameter berikut: + **--db-cluster-parameter-group-name** — Diperlukan. Nama grup parameter klaster yang Anda modifikasi. Untuk mengidentifikasi grup parameter klaster yang terkait dengan klaster Anda, lihat [Menentukan grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-describe.md#cluster_parameter_groups-determine). + **--parameters** — Diperlukan. Parameter yang Anda modifikasi. Setiap entri parameter harus menyertakan hal berikut: + **ParameterName** — Nama parameter yang Anda modifikasi. Dalam hal ini, itu adalah `change_stream_log_retention_duration` + **ParameterValue** — Nilai baru untuk parameter ini. + **ApplyMethod** — Bagaimana Anda ingin perubahan pada parameter ini diterapkan. Nilai yang diizinkan adalah `immediate` dan `pending-reboot`. **catatan** Parameter dengan `ApplyType` dari `static` harus memiliki `ApplyMethod` dari `pending-reboot`. 1. Untuk mengubah nilai parameter `change_stream_log_retention_duration`, jalankan perintah berikut dan ganti `parameter-value` dengan nilai yang ingin Anda modifikasi parameternya. Untuk Linux, macOS, atau Unix: ``` aws docdb modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name sample-parameter-group \ --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate" ``` Untuk Windows: ``` aws docdb modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name sample-parameter-group ^ --parameters "ParameterName=change_stream_log_retention_duration,ParameterValue=,ApplyMethod=immediate" ``` Output dari operasi ini terlihat seperti berikut (format JSON). ``` { "DBClusterParameterGroupName": "sample-parameter-group" } ``` 1. Tunggu paling tidak 5 menit. 1. Daftar nilai parameter dari `sample-parameter-group` untuk memastikan bahwa perubahan Anda telah dibuat. Untuk Linux, macOS, atau Unix: ``` aws docdb describe-db-cluster-parameters \ --db-cluster-parameter-group-name sample-parameter-group ``` Untuk Windows: ``` aws docdb describe-db-cluster-parameters ^ --db-cluster-parameter-group-name sample-parameter-group ``` Keluaran dari operasi ini terlihat seperti berikut ini (format JSON). ``` { "Parameters": [ { "ParameterName": "audit_logs", "ParameterValue": "disabled", "Description": "Enables auditing on cluster.", "Source": "system", "ApplyType": "dynamic", "DataType": "string", "AllowedValues": "enabled,disabled", "IsModifiable": true, "ApplyMethod": "pending-reboot" }, { "ParameterName": "change_stream_log_retention_duration", "ParameterValue": "12345", "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.", "Source": "user", "ApplyType": "dynamic", "DataType": "integer", "AllowedValues": "3600-86400", "IsModifiable": true, "ApplyMethod": "immediate" } ] } ``` ------ **catatan** Mengubah retensi log aliran tidak akan menghapus log yang lebih lama dari `change_stream_log_retention_duration` nilai yang dikonfigurasi hingga ukuran log lebih besar dari (>) 51.200MB. ## Menggunakan aliran perubahan pada instance sekunder Untuk memulai menggunakan aliran perubahan pada instance sekunder, buka kursor aliran ubah dengan `readPreference` sebagai sekunder. Anda dapat membuka kursor aliran perubahan untuk melihat peristiwa perubahan pada koleksi tertentu atau semua koleksi dalam cluster atau database. Anda dapat membuka kursor aliran perubahan pada instans Amazon DocumentDB apa pun dan mengambil dokumen aliran perubahan dari instance penulis dan pembaca. Anda dapat membagikan token aliran perubahan (seperti `resumeToken` atau`startOperationTime`) di berbagai kursor aliran perubahan yang dibuka pada instance penulis dan pembaca. **Contoh** ``` import os import sys from pymongo import MongoClient, ReadPreference username = "DocumentDBusername" password = clusterendpoint = "DocumentDBClusterEndpoint" client = MongoClient(clusterendpoint, username=username, password=password, tls='true', tlsCAFile='global-bundle.pem') db = client['bar'] # Make sure to use SECONDARY to redirect cursor reads from secondary instances coll = db.get_collection('foo', read_preference=ReadPreference.SECONDARY) # Create a stream object on RO. The token needs to generated from PRIMARY. stream = coll.watch(resumeAfter=token) for event in stream: print(event) ``` **Pedoman dan batasan untuk aliran perubahan pada instance sekunder** + Peristiwa aliran perubahan perlu direplikasi dari instance primer ke instance sekunder. Anda dapat memantau lag dari `DBInstanceReplicaLag` metrik di Amazon CloudWatch. + Stempel waktu pada instance sekunder mungkin tidak selalu sinkron dengan instance utama. Dalam hal ini, harapkan penundaan pada stempel waktu instance sekunder sehingga dapat mengejar ketinggalan. Sebagai praktik terbaik, kami sarankan `resumeToken` untuk menggunakan `startAtOperationTime` atau memulai jam tangan pada instance sekunder. + Anda mungkin mengalami throughput yang lebih rendah pada instance sekunder dibandingkan dengan instance utama jika ukuran dokumen Anda besar, Anda melakukannya`fullDocumentLookup`, dan ada beban kerja penulisan bersamaan yang tinggi pada instance utama. Sebagai praktik terbaik, kami sarankan Anda memantau rasio hit cache buffer Anda di sekunder dan memastikan bahwa rasio hit cache buffer tinggi. # Menggunakan Collation di Amazon DocumentDB 8.0 Amazon DocumentDB 8.0 sekarang mendukung pemeriksaan. Collation memungkinkan Anda mengonfigurasi aturan khusus bahasa untuk perbandingan string. Dengan pemeriksaan, Anda dapat menentukan aturan untuk perbandingan peka huruf besar/kecil, atau menentukan bahasa lokal. Collation dapat dikonfigurasi pada tingkat koleksi atau tingkat indeks di DocumentDB 8.0. Saat Anda menggunakan pemeriksaan di DocumentDB, secara internal dokumen pemeriksaan dibuat dengan parameter berikut. ``` { locale: string, caseLevel: boolean, caseFirst: string, strength: int, numericOrdering: boolean, alternate: string, maxVariable: string, backwards: boolean, normalization: boolean } ``` ## Batasan Collation memiliki batasan berikut di Amazon DocumentDB: + Collation kompatibel dengan planner v3 yang tersedia di Amazon DocumentDB 8.0. Beralih ke plannerv2 atau plannerv1 dapat menyebabkan perilaku yang tidak konsisten, termasuk kesalahan “Indeks tidak ditemukan”. + Karena perbedaan pustaka yang melekat, jika koleksi mongodb dengan pemeriksaan diekspor, Anda perlu memperbarui file metadata.bson dan mengubah versinya dari 57.1 menjadi 60.2 sebelum migrasi. + Dalam kasus yang jarang terjadi, pengaturan pemeriksaan Anda dapat melanggar batas internal jumlah karakter, menyebabkan kesalahan di bawah ini. “Kesalahan: Dokumen pemeriksaan memiliki atribut non-default lebih dari yang didukung. Tolong kurangi jumlah opsi.” Dalam hal ini, cobalah untuk mengurangi opsi yang Anda berikan dalam dokumen pemeriksaan, atau sebagai alternatif Anda dapat mencoba dan menggunakan nilai default sedapat mungkin. # Menggunakan Tampilan di Amazon DocumentDB 8.0 + Amazon DocumentDB 8.0 sekarang mendukung tampilan. Tampilan berfungsi sebagai koleksi virtual yang menyajikan data berdasarkan operasi agregasi tertentu. Saat membuat tampilan, Anda menentukan kueri yang mengubah data dari satu atau beberapa koleksi sumber. Amazon DocumentDB 8.0 mengeksekusi kueri ini setiap kali tampilan diakses, tanpa menghabiskan sumber daya penyimpanan tambahan. Tidak seperti koleksi standar, tampilan di Amazon DocumentDB 8.0 tidak menyimpan dokumen pada disk, menjadikannya solusi yang efisien untuk menyajikan data yang diubah atau difilter ke aplikasi. Untuk membuat tampilan di Amazon DocumentDB, Anda dapat menggunakan perintah createView atau metode pembantu db.createView (): ``` db.createView("viewName","sourceCollection", [ { $match: { status: "active" } }, { $project: { _id: 1, name: 1, email: 1 } } ] ) ``` Ini membuat tampilan bernama “ViewName” berdasarkan “sourceCollection” yang hanya menyertakan dokumen aktif dan memproyeksikan hanya bidang \$1id, nama, dan email. Tampilan di Amazon DocumentDB hanya bisa dibaca. Operasi tulis pada tampilan akan mengembalikan kesalahan. Untuk kinerja optimal dengan kumpulan data yang besar, Anda dapat menyusun jalur pipa tampilan untuk memaksimalkan efisiensi. Untuk pipeline agregasi yang kompleks, disarankan untuk menggunakan tahap \$1match sebagai tahap pertama atau awal pipeline untuk mengurangi jumlah dokumen yang perlu diproses oleh tahap selanjutnya, sehingga meningkatkan kinerja kueri. ## Praktik Terbaik Beberapa praktik terbaik untuk diikuti dengan Tampilan tercantum di bawah ini. + Filter Awal: Gunakan tahap \$1match di awal pipeline tampilan untuk mengurangi jumlah data yang diproses. + Hindari Agregasi Kompleks: Untuk tampilan yang sering diakses dengan agregasi kompleks, pertimbangkan untuk membuat koleksi terpisah dengan hasil yang telah dihitung sebelumnya yang diperbarui secara berkala. + Perencanaan Indeks: Pastikan bahwa bidang yang digunakan dalam pipeline tampilan, terutama dalam operasi \$1match dan \$1sort, diindeks dengan benar pada koleksi sumber. + Pengoptimalan Kueri: Gunakan perintah jelaskan untuk memahami bagaimana kueri tampilan Anda dijalankan dan mengoptimalkannya. + Alternatif untuk Tampilan: Mengingat perbedaan fungsional antara tampilan Amazon DocumentDB dan MongoDB, pertimbangkan untuk menggunakan koleksi reguler dengan pembaruan terjadwal sebagai alternatif tampilan saat menghadapi batasan. ## Kompatibilitas Operator Agregator Amazon DocumentDB mendukung banyak operator agregasi dalam definisi tampilan sambil terus memperluas kompatibilitas. Saat menggunakan tampilan, fokuslah pada operator yang didukung ini: + \$1 match untuk memfilter dokumen + \$1project untuk seleksi lapangan dan transformasi + \$1addFields untuk menambahkan bidang yang dihitung + \$1 sort untuk memesan hasil + \$1limit dan \$1skip untuk pagination Beberapa operator khusus seperti \$1currentTop, \$1replaceRoot, dan \$1geonear saat ini bekerja dalam kueri agregasi langsung daripada definisi tampilan. ## Memanfaatkan Indeks dan Tampilan Tampilan di Amazon DocumentDB 8.0 menggunakan indeks koleksi yang mendasarinya. Akibatnya, Anda tidak dapat membuat, menjatuhkan, atau membangun kembali indeks pada tampilan secara langsung. Namun, indeks yang dirancang dengan baik pada koleksi sumber dapat secara signifikan meningkatkan kinerja kueri tampilan Di bawah ini adalah beberapa langkah untuk mengoptimalkan kinerja kueri pada tampilan: + Pastikan indeks yang sesuai ada pada kolom koleksi sumber yang digunakan dalam pipeline tampilan, terutama dalam operasi \$1match dan \$1sort + Gunakan metode explain () untuk menganalisis rencana eksekusi kueri dan memverifikasi penggunaan indeks. Misalnya, `db.viewName.find({...}).explain() ` # Menggunakan AWS Lambda dengan aliran perubahan Amazon DocumentDB terintegrasi AWS Lambda sehingga Anda dapat menggunakan fungsi Lambda untuk memproses catatan dalam aliran perubahan. Pemetaan sumber peristiwa Lambda adalah sumber daya yang dapat digunakan untuk menjalankan fungsi Lambda untuk memproses peristiwa Amazon DocumentDB yang tidak langsung memanggil Lambda. Dengan aliran perubahan Amazon DocumentDB sebagai sumber peristiwa, Anda dapat membuat aplikasi berbasis peristiwa yang merespons perubahan dalam data Anda. Misalnya, Anda dapat menggunakan fungsi Lambda untuk memproses dokumen baru, melacak pembaruan ke dokumen yang ada, atau mencatat dokumen yang dihapus. Anda dapat mengonfigurasi pemetaan sumber peristiwa untuk mengirim catatan dari aliran perubahan Amazon DocumentDB ke fungsi Lambda. Acara dapat dikirim satu per satu atau batch untuk meningkatkan efisiensi dan akan diproses secara berurutan. Anda dapat mengonfigurasi perilaku batching pemetaan sumber peristiwa berdasarkan durasi jendela waktu tertentu (0 - 300 detik) atau jumlah catatan batch (batas maksimal 10.000 catatan). Anda dapat membuat beberapa pemetaan sumber peristiwa untuk memproses data yang sama dengan beberapa fungsi Lambda, atau untuk memproses item yang berbeda dari beberapa aliran dengan satu fungsi. Jika fungsi Anda mengembalikan kesalahan, Lambda mencoba ulang batch hingga berhasil diproses. Jika peristiwa dalam aliran perubahan telah kedaluwarsa, Lambda akan menonaktifkan pemetaan sumber peristiwa. Dalam hal ini, Anda dapat membuat pemetaan sumber peristiwa baru dan mengonfigurasinya dengan posisi awal pilihan Anda. Pemetaan sumber peristiwa Lambda memproses peristiwa setidaknya sekali karena sifat pollernya yang terdistribusi. Akibatnya, fungsi Lambda Anda mungkin menerima kejadian duplikat dalam situasi yang jarang terjadi. Ikuti praktik terbaik untuk bekerja dengan AWS Lambda fungsi dan buat fungsi idempoten untuk menghindari masalah yang terkait dengan peristiwa duplikat. *Untuk informasi selengkapnya, lihat [Menggunakan AWS Lambda console dengan Amazon DocumentDB](https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html) di AWS Lambda Panduan Pengembang.* Sebagai praktik terbaik kinerja, fungsi Lambda harus berumur pendek. Untuk menghindari penundaan pemrosesan yang tidak perlu, logika yang rumit juga tidak boleh dijalankan. Khususnya untuk aliran kecepatan tinggi, lebih baik memicu alur kerja fungsi langkah pasca-pemrosesan asinkron daripada Lambdas yang berjalan lama secara sinkron. Untuk informasi selengkapnya AWS Lambda, lihat [Panduan AWS Lambda Pengembang](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html). ## Batasan Berikut ini adalah batasan yang perlu dipertimbangkan saat bekerja dengan Amazon AWS Lambda DocumentDB dan: + AWS Lambda saat ini hanya didukung di Amazon DocumentDB 4.0 dan 5.0. + AWS Lambda saat ini tidak didukung pada cluster elastis atau cluster global. + AWS Lambda ukuran muatan tidak boleh melebihi 6MB. *Untuk informasi selengkapnya tentang ukuran batch Lambda, lihat “Perilaku pengelompokan” di bagian [pemetaan sumber peristiwa Lambda](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-batching) di Panduan Pengembang.AWS Lambda *