Amazon DocumentDB 클러스터 파라미터 그룹 설명

새 지역에서 첫 번째 Amazon DocumentDB 클러스터를 생성하거나 새 엔진을 사용할 때 default 클러스터 파라미터 그룹이 자동으로 생성됩니다. 동일한 지역에 생성되고 엔진 버전이 동일한 후속 클러스터는 default 클러스터 파라미터 그룹을 사용하여 생성됩니다.

Amazon DocumentDB 클러스터 파라미터 그룹의 세부 정보 설명

지정된 클러스터 파라미터 그룹의 세부 정보를 설명하려면 AWS Management Console 또는 AWS Command Line Interface(AWS CLI)를 사용하여 다음 단계를 완료합니다.

Using the AWS Management Console

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

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

   작은 정보

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

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

4. 결과 페이지에는 파라미터 그룹의 파라미터, 최근 활동 및 태그가 표시됩니다.

   • 클러스터 파라미터에서 파라미터의 이름, 현재 값, 허용되는 값, 파라미터의 수정 가능 여부, 적용 유형, 데이터 유형 및 설명을 볼 수 있습니다. 파라미터를 선택한 다음 클러스터 파라미터 섹션에서 편집을 선택하여 개별 파라미터를 수정할 수 있습니다. 자세한 내용은 Amazon DocumentDB 클러스터 파라미터 수정(을)를 참조하세요.

   • 최근 이벤트에서 이 파라미터 그룹에 대한 가장 최근 이벤트를 볼 수 있습니다. 이 섹션의 검색 창을 사용하여 이러한 이벤트를 필터링할 수 있습니다. 자세한 내용은 Amazon DocumentDB 이벤트 관리(을)를 참조하세요.

   • 태그에서 이 클러스터 파라미터 그룹에 있는 태그를 볼 수 있습니다. 태그 섹션에서 편집을 선택하여 태그를 추가하거나 제거할 수 있습니다. 자세한 내용은 Amazon DocumentDB 리소스 태깅(을)를 참조하세요.

Using the AWS CLI

describe-db-cluster-parameter-groups AWS CLI 명령을 사용하여 Amazon DocumentDB에 대해 보유한 단일 클러스터 파라미터 그룹 또는 모든 클러스터 파라미터 그룹의 Amazon 리소스 이름(ARN), 패밀리, 설명 및 이름을 볼 수 있습니다. describe-db-cluster-parameters AWS CLI 명령을 사용하여 단일 클러스터 파라미터 그룹 내에서 파라미터 및 세부 정보를 볼 수도 있습니다.

• --describe-db-cluster-parameter-groups - 모든 클러스터 파라미터 그룹 및 세부 정보 목록을 확인합니다.

  • --db-cluster-parameter-group-name - 선택 사항. 설명하려는 클러스터 파라미터 그룹의 이름입니다. 이 파라미터를 생략할 경우 모든 클러스터 파라미터 그룹을 설명합니다.

• --describe-db-cluster-parameters - 파라미터 그룹 내의 모든 파라미터와 해당 값을 나열합니다.

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

다음 코드에는 최대 100개의 클러스터 파라미터 그룹과 해당 ARN, 패밀리, 설명 및 이름이 나열되어 있습니다.

aws docdb describe-db-cluster-parameter-groups

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

{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Default cluster parameter group for docdb4.0",
                  "DBClusterParameterGroupName": "default.docdb4.0"
              },
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}

다음 코드에는 sample-parameter-group에 대한 ARN, 패밀리, 설명 및 이름이 나열되어 있습니다.

Linux, macOS 또는 Unix의 경우:

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

Windows의 경우:

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

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

{
          "DBClusterParameterGroups": [
              {
                  "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
                  "Description": "Custom docdb4.0 parameter group",
                  "DBParameterGroupFamily": "docdb4.0",
                  "DBClusterParameterGroupName": "sample-parameter-group"
              }
          ]
}

다음 코드에는 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": "change_stream_log_retention_duration",
            "ParameterValue": "17777",
            "Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
            "Source": "user",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "3600-86400",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot"
         }
   ]
}

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

다음 AWS CLI 코드는 어떤 파라미터 그룹이 클러스터 sample-cluster를 제어하는지 확인합니다.

aws docdb describe-db-clusters \
      --db-cluster-identifier sample-cluster \
      --query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'      

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

[
       [
           "sample-cluster",
           "sample-parameter-group"
       ]
]