Ikhtisar tugas operasional Amazon DocumentDB

Bagian ini mencakup tugas operasional untuk klaster Amazon DocumentDB Anda, dan cara menyelesaikan tugas ini menggunakan. AWS CLI

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 manajemen tertentu seperti manajemen siklus hidup cluster dan instans, Amazon DocumentDB memanfaatkan teknologi operasional 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.

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.

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 (inUTC):

[
    "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.

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