Memodifikasi grup parameter cluster Amazon DocumentDB - Amazon DocumentDB

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

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 atau menyalin grup parameter yang ada, 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 AWS Management Console 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.

Using the AWS Management Console

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

Untuk mengubah grup parameter klaster kustom

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

  2. 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.) di pojok kiri atas halaman.

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

    2. Jika dapat dimodifikasi, pilih parameter dan pilih Edit dari kanan atas halaman konsol tersebut.

    3. Dalam kotak dialog Modifikasi <parameter-name>, 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. 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.

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

  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 (format JSON).

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

  3. Tunggu paling tidak 5 menit.

  4. 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"
           }
       ]
}