Amazon DocumentDB クラスターパラメータグループを作成する

default.docdb5.0、default.docdb4.0、default.docdb3.6 などのデフォルトのクラスターパラメータグループは、新しいエンジンバージョンを使って新しいリージョンでクラスターを作成したときに作成されます。このリージョンで同じエンジンバージョンを使用して作成された後続のクラスターは、default クラスターパラメータグループを継承します。一度作成した default パラメータグループは、削除したり名前を変更したりすることはできません。設定したパラメータ値を使用してカスタムパラメータグループを作成し、それを Amazon DocumentDB クラスターにアタッチすることで、クラスターインスタンスのエンジン動作を変更できます。

次の手順では、 カスタムクラスターパラメータグループを作成する方法について説明します。その後、そのパラメータグループ内のパラメータを変更できます。

注記

クラスターパラメータグループの作成後、その特定のパラメータグループを使用するまで、5 分以上お待ちください。これにより、クラスターパラメーターグループが新しいクラスターに使用される前に、Amazon DocumentDB が create アクションを完全に完了させることができます。AWS Management Console または describe-db-cluster-parameter-groups AWS CLI オペレーションを使用して、クラスターパラメータグループが作成されたことを確認できます。詳細については、「Amazon DocumentDB クラスターパラメータグループについて説明します。」を参照してください。

Using the AWS Management Console

クラスターパラメータグループを作成するには

1. AWS Management Console にサインインし、Amazon DocumentDB コンソール https://console.aws.amazon.com/docdb を開きます。

2. ナビゲーションペインで、[パラメータグループ] を選択します。

   ヒント

   画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン () を選択します。

3. [クラスターパラメータグループ] ペインで、[作成] を選択します。

4. [クラスターパラメータグループの作成] ペインで、次のように入力します。

   1. グループ名 - クラスターパラメーターグループの名前を入力します。例えば、sample-parameter-group です。クラスターパラメータグループには、次のような命名に関する制約があります。

      • 長さは [1 ～ 255] 個の英数字です。

      • 1 字目は英字である必要があります。

      • ハイフンを、文字列の最後に使用したり、2 つ続けて使用したりすることはできません。

   2. 説明 - このクラスターパラメーターグループの説明を入力します。

5. クラスターパラメータグループを作成するには、[作成] を選択します。操作をキャンセルするには、[キャンセル] を選択します。

6. [作成] を選択すると、ページの上部に次のテキストが表示され、クラスターパラメータグループが正常に作成されたことを確認できます。

   Successfully created cluster parameter group 'sample-parameter-group'.

Using the AWS CLI

Amazon DocumentDB 4.0 クラスターの新しいパラメータグループを作成するには、次のパラメータを指定して AWS CLI create-db-cluster-parameter-group オペレーションを使用します。

• --db-cluster-parameter-group-name - カスタムクラスターパラメータグループの名前です。例えば、sample-parameter-group です。

• --db-cluster-parameter-group-family - カスタムクラスターパラメータグループのテンプレートとして使用されるクラスターパラメーターグループファミリーです。現在のところ、これは docdb4.0 である必要があります。

• --description - このクラスターパラメータグループのユーザーが提供する説明です。次の例では、「Custom docdb4.0 parameter group」を使用しています。

Linux、macOS、Unix の場合:

aws docdb create-db-cluster-parameter-group \
 --db-cluster-parameter-group-name sample-parameter-group \
 --db-parameter-group-family docdb4.0 \
 --description "Custom docdb4.0 parameter group"

Windows の場合:

aws docdb create-db-cluster-parameter-group ^
 --db-cluster-parameter-group-name sample-parameter-group ^
 --db-parameter-group-family docdb4.0 ^
 --description "Custom docdb4.0 parameter group"

このオペレーションによる出力は、次のようになります (JSON 形式)。

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "sample-parameter-group",
        "DBParameterGroupFamily": "docdb4.0",
        "Description": "Custom docdb4.0 parameter group",
        "DBClusterParameterGroupArn": "sample-parameter-group-arn"
    }
}