Amazon DocumentDB 클러스터 파라미터 수정

Amazon DocumentDB에서 클러스터 파라미터 그룹은 클러스터에서 만드는 모든 인스턴스에 적용되는 파라미터로 구성됩니다. 사용자 지정 클러스터 파라미터 그룹의 경우 언제든지 파라미터 값을 수정하거나 모든 파라미터 값을 사용자가 생성하는 파라미터 그룹에 대한 기본값으로 재설정할 수 있습니다. 이 단원에서는 Amazon DocumentDB 클러스터 파라미터 그룹을 구성하는 파라미터 및 해당 값을 확인하는 방법과 이러한 값을 변경하거나 업데이트하는 방법에 대해 설명합니다.

파라미터는 동적이거나 정적일 수 있습니다. 동적 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 Apply Immediately 설정과 관계없이 변경 사항이 바로 적용됩니다. 고정 파라미터를 변경하고 클러스터 파라미터 그룹을 저장하면 인스턴스를 수동으로 재부팅한 후에만 파라미터 변경 사항이 적용됩니다.

Amazon DocumentDB 클러스터 파라미터 그룹의 파라미터 보기

또는 를 사용하여 Amazon DocumentDB 클러스터의 파라미터와 해당 값을 볼 수 있습니다. AWS Management Console AWS CLI

Using the AWS Management Console

클러스터 파라미터 그룹의 세부 정보를 보려면

1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/docdb 에서 Amazon DocumentDB 콘솔을 엽니다.

2. 탐색 창에서 파라미터 그룹을 선택합니다.

   작은 정보

   화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘()을 선택하십시오.

3. 파라미터 그룹 창에서 세부 정보를 보려는 클러스터 파라미터 그룹의 이름을 선택합니다.

4. 결과 페이지에는 각 파라미터에 대한 값(파라미터 이름, 현재 값, 허용된 값, 파라미터 수정 가능 여부, 적용 유형, 데이터 형식 및 설명)이 표시됩니다.

   

Using the AWS CLI

클러스터 파라미터 그룹의 파라미터 및 해당 값을 보려면 다음 파라미터와 함께 describe-db-cluster-parameters 작업을 사용합니다.

• --db-cluster-parameter-group-name - 필수입니다. 자세한 파라미터 목록을 원하는 클러스터 파라미터 그룹의 이름입니다.

• --source - 선택 사항. 제공된 경우 특정 소스에 대한 파라미터만 반환합니다. 파라미터 소스는 engine-default, system 또는 user가 될 수 있습니다.

다음 코드에는 custom3-6-param-grp 파라미터 그룹의 모든 파라미터 및 해당 값이 나열되어 있습니다. 파라미터 그룹에 대한 세부 정보를 보려면 --query 줄을 생략합니다. 모든 파라미터 그룹에 대한 정보를 보려면 --db-cluster-parameter-group-name 줄을 생략합니다.

Linux, macOS 또는 Unix의 경우:

aws docdb describe-db-cluster-parameters \
   --db-cluster-parameter-group-name custom3-6-param-grp \
   --query 'Parameters[*].[ParameterName,ParameterValue]'

Windows의 경우:

aws docdb describe-db-cluster-parameters ^
   --db-cluster-parameter-group-name custom3-6-param-grp ^
   --query 'Parameters[*].[ParameterName,ParameterValue]'

이 작업의 출력은 다음과 같습니다 (JSON형식).

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

Amazon DocumentDB 클러스터 파라미터 그룹의 파라미터 수정

AWS Management Console 또는 를 사용하여 파라미터 그룹의 파라미터를 수정할 수 AWS CLI있습니다.

Using the AWS Management Console

클러스터 파라미터 그룹의 파라미터를 업데이트하려면

1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/docdb 에서 Amazon DocumentDB 콘솔을 엽니다.

2. 탐색 창에서 파라미터 그룹을 선택합니다.

   작은 정보

   화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘()을 선택하십시오.

3. 파라미터 그룹 창에서 파라미터를 업데이트하려는 클러스터 파라미터 그룹을 선택합니다.

4. 결과 페이지에는 이 클러스터 파라미터 그룹에 대한 파라미터 및 해당 세부 정보가 표시됩니다. 업데이트할 파라미터를 선택합니다.

5. 페이지 오른쪽 상단에서 편집을 선택하여 파라미터의 값을 변경합니다. 클러스터 파라미터 유형에 대한 자세한 내용은 Amazon DocumentDB 클러스터 파라미터 참조(을)를 참조하세요.

6. 변경한 다음 Modify cluster parameter(클러스터 파라미터 수정)를 선택하여 변경 사항을 저장합니다. 변경 사항을 취소하려면 취소를 선택합니다.

Using the AWS CLI

클러스터 파라미터 그룹의 파라미터를 수정하려면 다음 파라미터와 함께 modify-db-cluster-parameter-group 작업을 사용합니다.

• --db-cluster-parameter-group-name - 필수입니다. 수정하려는 클러스터 파라미터 그룹의 이름입니다.

• --parameters - 필수입니다. 수정할 파라미터입니다. 각 파라미터 요소는 다음을 포함해야 합니다.

  • ParameterName - 수정 중인 파라미터의 이름입니다.

  • ParameterValue - 이 파라미터의 새 값입니다.

  • ApplyMethod - 파라미터에 대한 변경 사항을 적용할 방법입니다. 허용된 값은 immediate 및 pending-reboot입니다.

    참고

    static의 ApplyType 파라미터에는 pending-reboot의 ApplyMethod이 있어야 합니다.

클러스터 파라미터 그룹의 파라미터 값을 변경하려면(AWS CLI)

다음 예에서는 tls 파라미터를 변경합니다.

1. sample-parameter-group의 파라미터 및 해당 값을 나열합니다.

   Linux, macOS 또는 Unix의 경우:

   aws docdb describe-db-cluster-parameters \
       --db-cluster-parameter-group-name sample-parameter-group

   Windows의 경우:

   aws docdb describe-db-cluster-parameters ^
       --db-cluster-parameter-group-name sample-parameter-group

   이 작업의 출력은 다음과 같습니다 (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. 값이 disabled이 되도록 tls 파라미터를 수정합니다. ApplyType은 static이므로 ApplyMethod를 수정할 수 없습니다.

   Linux, macOS 또는 Unix의 경우:

   aws docdb modify-db-cluster-parameter-group \
       --db-cluster-parameter-group-name sample-parameter-group \
       --parameters "ParameterName"=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"

   Windows의 경우:

   aws docdb modify-db-cluster-parameter-group ^
       --db-cluster-parameter-group-name sample-parameter-group ^
       --parameters "ParameterName=tls,ParameterValue=disabled,ApplyMethod=pending-reboot"

   이 작업의 출력은 다음과 같습니다 (JSON형식).

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

3. 적어도 5분을 기다립니다.

4. sample-parameter-group의 파라미터 값을 나열합니다.

   Linux, macOS 또는 Unix의 경우:

   aws docdb describe-db-cluster-parameters \
       --db-cluster-parameter-group-name sample-parameter-group

   Windows의 경우:

   aws docdb describe-db-cluster-parameters ^
       --db-cluster-parameter-group-name sample-parameter-group

   이 작업의 출력은 다음과 같습니다 (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"
           }
       ]
   }