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. AWS Management Console AWS CLI

Using the AWS Management Console

Untuk melihat detail grup parameter klaster

1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com

2. Di panel navigasi, pilih Grup parameter.

   Tip

   Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu () di pojok kiri atas halaman.

3. Di panel Grup parameter, pilih nama grup parameter klaster yang ingin Anda lihat detailnya.

4. 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.

   

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.

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 (JSONformat).

[
    [
        "audit_logs",
        "disabled"
    ],
    [
        "tls",
        "enabled"
    ],
    [
        "ttl_monitor",
        "enabled"
    ]
]

Memodifikasi parameter grup parameter cluster Amazon DocumentDB

Anda dapat memodifikasi parameter grup parameter menggunakan AWS Management Console atau AWS CLI.

Using the AWS Management Console

Untuk memperbarui parameter grup parameter klaster

1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com

2. Di panel navigasi, pilih Grup parameter.

   Tip

   Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu () di pojok kiri atas halaman.

3. Di panel Grup parameter, pilih grup parameter klaster yang ingin Anda perbarui parameternya.

4. Halaman yang dihasilkan menunjukkan parameter dan detail yang sesuai untuk grup parameter klaster ini. Pilih parameter untuk diperbarui.

5. Di kanan atas halaman, pilih Edit untuk mengubah nilai parameter. Untuk informasi selengkapnya tentang tipe parameter klaster, lihat Referensi parameter cluster Amazon DocumentDB.

6. 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 (JSONformat).

   {
       "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"
           }
       ]
   }

2. 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 (JSONformat).

   {
       "DBClusterParameterGroupName": "sample-parameter-group"
   }

3. Tunggu setidaknya 5 menit.

4. Buat daftar nilai parameter darisample-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 (JSONformat).

   {
       "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"
           }
       ]
   }