다중 AZ DB 클러스터용 DB 클러스터 파라미터 그룹 작업 - Amazon Relational Database Service
DB 클러스터 파라미터 그룹 만들기DB 클러스터 파라미터 그룹의 파라미터 수정DB 클러스터 파라미터 그룹의 파라미터 수정DB 클러스터 파라미터 그룹 복사DB 클러스터 파라미터 그룹 나열DB 클러스터 파라미터 그룹의 파라미터 값 보기DB 클러스터 파라미터 그룹 삭제

다중 AZ DB 클러스터용 DB 클러스터 파라미터 그룹 작업

다중 AZ DB 클러스터는 DB 클러스터 파라미터 그룹을 사용합니다. 다음 섹션에서는 DB 클러스터 파라미터 그룹 구성 및 관리에 대해 설명합니다.

DB 클러스터 파라미터 그룹 만들기

AWS Management Console, AWS CLI 또는 RDS API를 사용하여 새 DB 클러스터 파라미터 그룹을 생성할 수 있습니다.

DB 클러스터 파라미터 그룹을 생성한 후 해당 DB 클러스터 파라미터 그룹을 사용하는 DB 클러스터를 생성하려면 5분 이상 기다려야 합니다. 이렇게 하면 새 DB 클러스터에서 사용하기 전에 Amazon RDS에서 파라미터 그룹을 완전히 생성할 수 있습니다. Amazon RDS 콘솔의 파라미터 그룹 페이지 또는 describe-db-cluster-parameters 명령을 사용하여 DB 클러스터 파라미터 그룹이 생성되었는지 확인할 수 있습니다.

DB 클러스터 파라미터 그룹 이름에는 다음과 같은 제한이 적용됩니다.

  • 이름은 1~255자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.

    기본 파라미터 그룹 이름에는 마침표(예: default.aurora-mysql5.7)가 포함될 수 있습니다. 하지만 사용자 지정 파라미터 그룹 이름에는 마침표를 포함할 수 없습니다.

  • 첫 번째 자리는 문자여야 합니다.

  • 이름은 하이픈으로 끝나거나 2개 연속 하이픈을 포함할 수 없습니다.

DB 클러스터 파라미터 그룹을 생성하려면

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

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

  3. [Create parameter group]을 선택합니다.

    파라미터 그룹 생성 창이 나타납니다.

  4. 파라미터 그룹 패밀리] 목록에서 DB 파라미터 그룹 패밀리를 선택합니다.

  5. 유형 목록에서 DB 클러스터 파라미터 그룹을 선택합니다.

  6. 그룹 이름 상자에 새로운 DB 클러스터 파라미터 그룹의 이름을 입력합니다.

  7. 설명 상자에 새 DB 클러스터 파라미터 그룹에 대한 설명을 입력합니다.

  8. Create를 선택합니다.

DB 클러스터 파라미터 그룹을 생성하려면 AWS CLI create-db-cluster-parameter-group 명령을 사용합니다.

다음 예에서는 "My new cluster parameter group(내 새로운 클러스터 파라미터 그룹)"이라는 설명과 함께 mydbclusterparametergroup이라는 RDS for MySQL 버전 8.0용 DB 클러스터 파라미터 그룹을 생성합니다.

다음 필수 파라미터를 포함합니다.

  • --db-cluster-parameter-group-name

  • --db-parameter-group-family

  • --description

사용 가능한 모든 파라미터 그룹 패밀리를 나열하려면 다음 명령을 사용합니다.

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
참고

출력에 중복이 있습니다.

예

Linux, macOS, Unix:

aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family mysql8.0 \
    --description "My new cluster parameter group"

Windows의 경우:

aws rds create-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --db-parameter-group-family mysql8.0 ^
    --description "My new cluster parameter group"

다음과 비슷한 출력이 생성됩니다.

{
    "DBClusterParameterGroup": {
        "DBClusterParameterGroupName": "mydbclusterparametergroup",
        "DBParameterGroupFamily": "mysql8.0",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2"
    }
}

DB 클러스터 파라미터 그룹을 생성하려면 RDS API CreateDBClusterParameterGroup 작업을 사용합니다.

다음 필수 파라미터를 포함합니다.

  • DBClusterParameterGroupName

  • DBParameterGroupFamily

  • Description

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

고객이 생성한 DB 클러스터 파라미터 그룹에서 파라미터 값을 수정할 수 있습니다. 기본 DB 클러스터 파라미터 그룹에서는 파라미터 값을 변경할 수 없습니다. 고객이 생성한 DB 클러스터 파라미터 그룹의 파라미터를 변경하면 DB 클러스터 파라미터 그룹과 연결된 모든 DB 클러스터에 해당 변경 내용이 적용됩니다.

DB 클러스터 파라미터 그룹을 수정하려면

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

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

  3. 목록에서 수정할 파라미터 그룹을 선택합니다.

  4. 파라미터 그룹 작업에서 편집을 선택합니다.

  5. 수정하려는 파라미터의 값을 변경합니다. 대화 상자 오른쪽 위의 화살표 키를 사용하여 파라미터를 스크롤할 수 있습니다.

    기본 파라미터 그룹의 값은 변경할 수 없습니다.

  6. Save changes(변경 사항 저장)를 선택합니다.

  7. 클러스터의 기본(라이터) DB 인스턴스를 재부팅하여 변경 사항을 적용합니다.

  8. 그런 다음 리더 DB 인스턴스를 재부팅하여 변경 사항을 적용합니다.

DB 클러스터 파라미터 그룹을 수정하려면 AWS CLI modify-db-cluster-parameter-group 명령을 다음 필수 파라미터와 함께 사용합니다.

  • --db-cluster-parameter-group-name

  • --parameters

다음 예에서는 mydbclusterparametergroup이라는 DB 클러스터 파라미터 그룹에서 server_audit_logging 및 server_audit_logs_upload 값을 수정합니다.

예

Linux, macOS, Unix:

aws rds modify-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Windows의 경우:

aws rds modify-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

다음과 같은 출력이 생성됩니다.

DBCLUSTERPARAMETERGROUP  mydbclusterparametergroup

DB 클러스터 파라미터 그룹을 수정하려면 RDS API ModifyDBClusterParameterGroup 명령을 다음 필수 파라미터와 함께 사용합니다.

  • DBClusterParameterGroupName

  • Parameters

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

고객이 생성한 DB 클러스터 파라미터 그룹에서 파라미터를 기본값으로 수정할 수 있습니다. 고객이 생성한 DB 클러스터 파라미터 그룹의 파라미터를 변경하면 DB 클러스터 파라미터 그룹과 연결된 모든 DB 클러스터에 해당 변경 내용이 적용됩니다.

참고

기본 DB 클러스터 파라미터 그룹에서 파라미터는 항상 기본값으로 설정됩니다.

DB 클러스터 파라미터 그룹의 파라미터를 기본값으로 수정

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

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

  3. 목록에서 파라미터 그룹을 선택합니다.

  4. 파라미터 그룹 작업에서 편집을 선택합니다.

  5. 기본값으로 재설정할 파라미터를 선택합니다. 대화 상자 오른쪽 위의 화살표 키를 사용하여 파라미터를 스크롤할 수 있습니다.

    기본 파라미터 그룹의 값은 변경할 수 없습니다.

  6. Reset을 선택한 다음 Reset parameters를 선택하여 확인합니다.

  7. DB 클러스터의 기본 DB 인스턴스를 재부팅하여 변경 사항을 DB 클러스터의 모든 DB 인스턴스에 적용합니다.

DB 클러스터 파라미터 그룹의 파라미터를 기본값으로 수정하려면 AWS CLI reset-db-cluster-parameter-group 명령을 필수 옵션 --db-cluster-parameter-group-name과 함께 사용합니다.

DB 클러스터 파라미터 그룹의 모든 파라미터를 수정하려면 --reset-all-parameters 옵션을 지정합니다. 특정 파라미터를 수정하려면 --parameters 옵션을 지정합니다.

다음 예제에서는 mydbparametergroup이라는 DB 파라미터 그룹의 모든 파라미터를 기본값으로 수정합니다.

예

Linux, macOS, Unix:

aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbparametergroup \
    --reset-all-parameters

Windows의 경우:

aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbparametergroup ^
    --reset-all-parameters

다음 예제에서는 mydbclusterparametergroup이라는 DB 클러스터 파라미터 그룹에서 server_audit_logging 및 server_audit_logs_upload 값을 수정합니다.

예

Linux, macOS, Unix:

aws rds reset-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
                 "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"

Windows의 경우:

aws rds reset-db-cluster-parameter-group ^
    --db-cluster-parameter-group-name mydbclusterparametergroup ^
    --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
                 "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

다음과 같은 출력이 생성됩니다.

DBClusterParameterGroupName  mydbclusterparametergroup

DB 클러스터 파라미터 그룹의 파라미터를 기본값으로 재설정하려면 다음과 같은 필수 파라미터와 함께 RDS API ResetDBClusterParameterGroup 명령을 사용합니다: DBClusterParameterGroupName.

DB 클러스터 파라미터 그룹의 모든 파라미터를 재설정하려면 ResetAllParameters 파라미터를 true로 설정합니다. 특정 파라미터를 재설정하려면 Parameters 파라미터를 지정합니다.

DB 클러스터 파라미터 그룹 복사

생성하는 사용자 지정 DB 클러스터 파라미터 그룹을 복사할 수 있습니다. DB 클러스터 파라미터 그룹을 이미 생성했으며 해당 그룹의 사용자 지정 파라미터와 값의 대부분을 새 DB 클러스터 파라미터 그룹에 포함하려는 경우 파라미터 그룹을 복사하면 편리합니다. AWS CLIcopy-db-cluster-parameter-group 명령이나 RDS API CopyDBClusterParameterGroup 작업을 사용하여 DB 클러스터 파라미터 그룹을 복사할 수 있습니다.

DB 클러스터 파라미터 그룹을 복사한 후 5분 이상 기다렸다가 해당 DB 클러스터 파라미터 그룹을 기본 파라미터 그룹으로 사용하는 첫 번째 DB 클러스터를 복사합니다. 이렇게 하면 새 DB 클러스터에서 사용하기 전에 Amazon RDS에서 파라미터 그룹을 완전히 복사할 수 있습니다. Amazon RDS 콘솔의 파라미터 그룹 페이지 또는 describe-db-cluster-parameters 명령을 사용하여 DB 클러스터 파라미터 그룹이 생성되었는지 확인할 수 있습니다.

참고

기본 파라미터 그룹은 복사할 수 없습니다. 하지만 기본 파라미터 그룹을 바탕으로 하는 새로운 파라미터 그룹을 만들 수 있습니다.

DB 클러스터 파라미터 그룹을 다른 AWS 계정 또는 AWS 리전에 복사할 수 없습니다.

DB 클러스터 파라미터 그룹을 복사하려면

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

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

  3. 목록에서 복사할 사용자 지정 파라미터 그룹을 선택합니다.

  4. 파라미터 그룹 작업에서 복사를 선택합니다.

  5. 새로운 DB 파라미터 그룹 식별자에 새로운 파라미터 그룹의 이름을 입력합니다.

  6. 설명에 새로운 파라미터 그룹에 대한 설명을 입력합니다.

  7. [Copy]를 선택합니다.

DB 클러스터 파라미터 그룹을 복사하려면 AWS CLI copy-db-cluster-parameter-group 명령을 다음 필수 파라미터와 함께 사용합니다.

  • --source-db-cluster-parameter-group-identifier

  • --target-db-cluster-parameter-group-identifier

  • --target-db-cluster-parameter-group-description

다음 예에서는 DB 클러스터 파라미터 그룹 mygroup2을 복사하여 mygroup1라는 새 DB 클러스터 파라미터 그룹을 생성합니다.

예

Linux, macOS, Unix:

aws rds copy-db-cluster-parameter-group \
    --source-db-cluster-parameter-group-identifier mygroup1 \
    --target-db-cluster-parameter-group-identifier mygroup2 \
    --target-db-cluster-parameter-group-description "DB parameter group 2"

Windows의 경우:

aws rds copy-db-cluster-parameter-group ^
    --source-db-cluster-parameter-group-identifier mygroup1 ^
    --target-db-cluster-parameter-group-identifier mygroup2 ^
    --target-db-cluster-parameter-group-description "DB parameter group 2"

DB 클러스터 파라미터 그룹을 복사하려면 RDS API CopyDBClusterParameterGroup 작업을 다음 필수 파라미터와 함께 사용합니다.

  • SourceDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupDescription

DB 클러스터 파라미터 그룹 나열

AWS 계정에 대해 생성한 DB 클러스터 파라미터 그룹을 나열할 수 있습니다.

참고

특정 DB 엔진과 버전에 대한 DB 클러스터를 생성할 때 기존 파라미터 템플릿에서 기본 파라미터 그룹이 자동으로 생성됩니다. 이 기본 파라미터 그룹은 기본 파라미터 설정을 포함하며 수정할 수 없습니다. 사용자 지정 파라미터 그룹을 생성할 때 파라미터 설정을 수정할 수 있습니다.

AWS 계정에 대한 모든 DB 클러스터 파라미터 그룹을 나열하려면

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

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

    DB 클러스터 파라미터 그룹은 목록에서 DB 클러스터 파라미터 그룹유형에 나타납니다.

AWS 계정에 사용할 수 있는 모든 DB 클러스터 파라미터 그룹을 나열하려면 AWS CLI describe-db-cluster-parameter-groups 명령을 사용합니다.

예

다음 예에서는 AWS 계정에 사용할 수 있는 모든 DB 클러스터 파라미터 그룹을 나열합니다.

aws rds describe-db-cluster-parameter-groups

다음은 mydbclusterparametergroup 파라미터 그룹을 설명하는 예제입니다.

Linux, macOS, Unix:

aws rds describe-db-cluster-parameter-groups \
    --db-cluster-parameter-group-name mydbclusterparametergroup

Windows의 경우:

aws rds describe-db-cluster-parameter-groups ^
    --db-cluster-parameter-group-name mydbclusterparametergroup

다음과 같은 응답이 반환됩니다.

{
    "DBClusterParameterGroups": [
        {
            "DBClusterParameterGroupName": "mydbclusterparametergroup2",
            "DBParameterGroupFamily": "mysql8.0",
            "Description": "My new cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
        }
    ]
}

AWS 계정에 사용할 수 있는 모든 DB 클러스터 파라미터 그룹을 나열하려면 RDS API DescribeDBClusterParameterGroups 작업을 사용합니다.

DB 클러스터 파라미터 그룹의 파라미터 값 보기

DB 클러스터 파라미터 그룹의 모든 파라미터와 해당 값 목록을 가져올 수 있습니다.

DB 클러스터 파라미터 그룹의 파라미터 값을 보려면

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

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

    DB 클러스터 파라미터 그룹은 목록에서 DB 클러스터 파라미터 그룹유형에 나타납니다.

  3. DB 클러스터 파라미터 그룹의 이름을 선택하여 파라미터 목록을 봅니다.

DB 클러스터 파라미터 그룹의 파라미터 값을 보려면 AWS CLI describe-db-cluster-parameters 명령을 다음 필수 파라미터와 함께 사용합니다.

  • --db-cluster-parameter-group-name

예

다음 예에서는 mydbclusterparametergroup이라는 DB 클러스터 파라미터 그룹에 대한 파라미터와 파라미터 값을 JSON 형식으로 나열합니다.

다음과 같은 응답이 반환됩니다.

aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
{
    "Parameters": [
        {
            "ParameterName": "activate_all_roles_on_login",
            "ParameterValue": "0",
            "Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
        {
            "ParameterName": "allow-suspicious-udfs",
            "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
            "Source": "engine-default",
            "ApplyType": "static",
            "DataType": "boolean",
            "AllowedValues": "0,1",
            "IsModifiable": false,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },
...

DB 클러스터 파라미터 그룹의 파라미터 값을 보려면 RDS API DescribeDBClusterParameters 명령을 다음 필수 파라미터와 함께 사용하세요.

  • DBClusterParameterGroupName

경우에 따라 파라미터에 허용된 값이 표시되지 않습니다. 이러한 파라미터는 항상 소스가 데이터베이스 엔진 기본값인 파라미터입니다.

이러한 파라미터의 값을 보려면 다음 SQL 문을 실행하면 됩니다.

  • MySQL:

    -- Show the value of a particular parameter
mysql$ SHOW VARIABLES LIKE '%parameter_name%';

-- Show the values of all parameters
mysql$ SHOW VARIABLES;

  • PostgreSQL:

    -- Show the value of a particular parameter
postgresql=> SHOW parameter_name;

-- Show the values of all parameters
postgresql=> SHOW ALL;

DB 클러스터 파라미터 그룹 삭제

AWS Management Console, AWS CLI 또는 RDS API를 사용하여 DB 클러스터 파라미터 그룹을 삭제할 수 있습니다. DB 클러스터 파라미터 그룹 파라미터 그룹은 DB 클러스터와 연결되지 않은 경우에만 삭제할 수 있습니다.

파라미터 그룹을 삭제하려면

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

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

    파라미터 그룹이 목록에 나타납니다.

  3. 삭제할 DB 클러스터 파라미터 그룹의 이름을 선택합니다.

  4. 작업을 선택한 후 삭제를 선택합니다.

  5. 파라미터 그룹 이름을 검토한 다음 삭제를 선택합니다.

DB 클러스터 파라미터 그룹을 삭제하려면 AWS CLI delete-db-cluster-parameter-group 명령을 다음 필수 파라미터와 함께 사용합니다.

  • --db-parameter-group-name

예

다음 예제에서는 mydbparametergroup이라는 DB 클러스터 파라미터 그룹을 삭제합니다.

aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup

DB 클러스터 파라미터 그룹을 삭제하려면 RDS API DeleteDBClusterParameterGroup 명령을 다음 필수 파라미터와 함께 사용합니다.

  • DBParameterGroupName