DB 인스턴스의 DB 파라미터 그룹 작업

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

DB 파라미터 그룹 생성

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

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

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

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

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

• 이름은 하이픈으로 끝나거나 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. 생성을 선택합니다.

AWS CLI

DB 파라미터 그룹을 생성하려면 AWS CLIcreate-db-parameter-group 명령을 사용합니다. 다음 예에서는 'My new parameter group'이라는 설명과 함께 mydbparametergroup이라는 MySQL 버전 8.0용 DB 파라미터 그룹을 생성합니다.

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

• --db-parameter-group-name

• --db-parameter-group-family

• --description

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

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

참고

출력에 중복이 있습니다.

예

Linux, macOS, Unix:

aws rds create-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family MySQL8.0 \
    --description "My new parameter group"

Windows의 경우:

aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family MySQL8.0 ^
    --description "My new parameter group"

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

DBPARAMETERGROUP  mydbparametergroup  mysql8.0  My new parameter group

RDS API

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

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

• DBParameterGroupName

• DBParameterGroupFamily

• Description

DB 파라미터 그룹과 DB 인스턴스 연결

사용자 지정 설정을 사용하여 사용자의 DB 파라미터 그룹을 생성할 수 있습니다. AWS Management Console, AWS CLI 또는 RDS API를 사용하여 DB 파라미터 그룹을 DB 인스턴스와 연결할 수 있습니다. DB 인스턴스를 생성하거나 수정할 때 이 작업을 수행할 수 있습니다.

DB 파라미터 그룹 생성에 대한 자세한 내용은 DB 파라미터 그룹 생성 단원을 참조하세요. DB 인스턴스 생성에 대한 자세한 내용은 Amazon RDS DB 인스턴스 생성을(를) 참조하세요. DB 인스턴스 수정에 대한 자세한 내용은 Amazon RDS DB 인스턴스 수정 단원을 참조하세요.

참고

새 DB 파라미터 그룹을 DB 인스턴스와 연결하면 수정된 정적 파라미터 및 동적 파라미터는 DB 인스턴스가 재부팅된 후에만 적용됩니다. 그러나 DB 파라미터 그룹을 DB 인스턴스에 연결한 후 DB 파라미터 그룹에서 동적 파라미터를 수정하면 이러한 변경 사항이 재부팅 없이 즉시 적용됩니다.

콘솔

DB 파라미터 그룹을 DB 인스턴스와 연결하는 방법

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

2. 탐색 창에서 데이터베이스를 선택한 다음 변경하려는 DB 인스턴스를 선택합니다.

3. 수정을 선택합니다. Modify DB instance(DB 인스턴스 수정) 페이지가 나타납니다.

4. DB 파라미터 그룹 설정을 변경합니다.

5. [Continue]를 수정 사항을 요약한 내용을 확인합니다.

6. (선택 사항) 즉시 적용을 선택하여 변경 내용을 즉시 적용합니다. 일부의 경우 이 옵션을 선택하면 중단이 발생할 수 있습니다. 자세한 내용은 즉시 적용 설정 사용 섹션을 참조하세요.

7. 확인 페이지에서 변경 내용을 검토합니다. 변경 내용이 정확할 경우 DB 인스턴스 수정을 선택하여 변경 내용을 저장합니다.

   또는 뒤로를 선택하여 변경 내용을 편집하거나 취소를 선택하여 변경 내용을 취소합니다.

AWS CLI

DB 파라미터 그룹을 DB 인스턴스와 연결하려면 다음 옵션과 함께 AWS CLI modify-db-instance 명령을 사용합니다.

• --db-instance-identifier

• --db-parameter-group-name

다음 예제에서는 mydbpg DB 파라미터 그룹을 database-1 DB 인스턴스와 연결합니다. --apply-immediately를 사용하면 변경 내용이 즉시 적용됩니다. --no-apply-immediately를 사용하여 다음 유지 관리 기간 동안 변경 사항을 적용합니다. 자세한 내용은 즉시 적용 설정 사용 섹션을 참조하세요.

예

Linux, macOS, Unix:

aws rds modify-db-instance \
    --db-instance-identifier database-1 \
    --db-parameter-group-name mydbpg \
    --apply-immediately

Windows의 경우:

aws rds modify-db-instance ^
    --db-instance-identifier database-1 ^
    --db-parameter-group-name mydbpg ^
    --apply-immediately

RDS API

DB 파라미터 그룹을 DB 인스턴스와 연결하려면 RDS API ModifyDBInstance 작업을 다음 파라미터와 함께 사용합니다.

• DBInstanceName

• DBParameterGroupName

DB 파라미터 그룹의 파라미터 수정

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

일부 파라미터에 대한 변경 사항은 재부팅 없이 DB 인스턴스에 즉시 적용됩니다. 다른 파라미터에 대한 변경 내용은 DB 인스턴스를 재부팅한 후에만 적용됩니다. RDS 콘솔에는 구성 탭에서 DB 인스턴스와 연결된 DB 파라미터 그룹의 상태가 표시됩니다. 예를 들어 DB 인스턴스에서 연결된 DB 파라미터 그룹에 대한 최신 변경 내용을 사용하고 있지 않다고 가정해 봅시다. 이 경우 RDS 콘솔에 DB 파라미터 그룹이 pending-reboot(재시작 보류 중) 상태로 표시됩니다. 최신 파라미터 변경 내용을 이 DB 인스턴스에 적용하려면 해당 DB 인스턴스를 수동으로 재부팅해야 합니다.

콘솔

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

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

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

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

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

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

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

6. 변경 사항 저장을 선택합니다.

AWS CLI

DB 파라미터 그룹을 수정하려면 AWS CLImodify-db-parameter-group 명령을 다음 필수 옵션과 함께 사용합니다.

• --db-parameter-group-name

• --parameters

다음 예에서는 mydbparametergroup이라는 DB 파라미터 그룹에서 max_connections 및 max_allowed_packet 값을 수정합니다.

예

Linux, macOS, Unix:

aws rds modify-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

Windows의 경우:

aws rds modify-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

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

DBPARAMETERGROUP  mydbparametergroup

RDS API

DB 파라미터 그룹을 수정하려면 RDS API ModifyDBParameterGroup 작업을 다음 필수 파라미터와 함께 사용합니다.

• DBParameterGroupName

• Parameters

DB 파라미터 그룹의 파라미터를 기본값으로 재설정

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

콘솔을 사용하는 경우 특정 파라미터를 기본값으로 재설정할 수 있습니다. 하지만 DB 파라미터 그룹의 모든 파라미터를 한꺼번에 손쉽게 재설정할 수는 없습니다. AWS CLI 또는 RDS API를 사용하는 경우 특정 파라미터를 기본값으로 재설정할 수 있습니다. DB 파라미터 그룹의 모든 파라미터를 한꺼번에 재설정할 수도 있습니다.

일부 파라미터에 대한 변경 사항은 재부팅 없이 DB 인스턴스에 즉시 적용됩니다. 다른 파라미터에 대한 변경 내용은 DB 인스턴스를 재부팅한 후에만 적용됩니다. RDS 콘솔에는 구성 탭에서 DB 인스턴스와 연결된 DB 파라미터 그룹의 상태가 표시됩니다. 예를 들어 DB 인스턴스에서 연결된 DB 파라미터 그룹에 대한 최신 변경 내용을 사용하고 있지 않다고 가정해 봅시다. 이 경우 RDS 콘솔에 DB 파라미터 그룹이 pending-reboot(재시작 보류 중) 상태로 표시됩니다. 최신 파라미터 변경 내용을 이 DB 인스턴스에 적용하려면 해당 DB 인스턴스를 수동으로 재부팅해야 합니다.

참고

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

콘솔

DB 파라미터 그룹의 파라미터를 기본값으로 재설정하려면

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

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

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

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

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

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

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

AWS CLI

DB 파라미터 그룹의 파라미터를 일부 또는 모두 재설정하려면 필수 옵션 AWS CLI과 함께 reset-db-parameter-group--db-parameter-group-name 명령을 사용합니다.

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

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

예

Linux, macOS, Unix:

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

Windows의 경우:

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

다음 예제에서는 mydbparametergroup이라는 DB 파라미터 그룹에서 max_connections 및 max_allowed_packet 옵션을 재설정합니다.

예

Linux, macOS, Unix:

aws rds reset-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" \
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Windows의 경우:

aws rds reset-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
                 "ParameterName=max_allowed_packet,ApplyMethod=immediate"

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

DBParameterGroupName  mydbparametergroup

RDS API

DB 파라미터 그룹의 파라미터를 기본값으로 재설정하려면 필수 파라미터 ResetDBParameterGroup과 함께 RDS API DBParameterGroupName 명령을 사용합니다.

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

DB 파라미터 그룹 복사

생성하는 사용자 지정 DB 파라미터 그룹을 복사할 수 있습니다 파라미터 그룹을 복사하는 것이 편리한 솔루션이 될 수 있습니다. DB 파라미터 그룹을 만들고 이 그룹의 사용자 지정 파라미터 및 값의 대부분을 새 DB 파라미터 그룹에 포함하려는 경우를 예로 들 수 있습니다. AWS Management Console을 사용하여 DB 파라미터 그룹을 복사할 수 있습니다. AWS CLI copy-db-parameter-group 명령 또는 RDS API CopyDBParameterGroup 작업을 사용할 수도 있습니다.

DB 파라미터 그룹을 복사한 후 5분 이상 기다렸다가 해당 DB 파라미터 그룹을 기본 파라미터 그룹으로 사용하는 첫 번째 DB 인스턴스를 생성하십시오. 이렇게 하면 파라미터 그룹이 사용되기 전에 Amazon RDS에서 복사 작업을 완전히 마칠 수 있습니다. 이는 DB 인스턴스의 기본 데이터베이스를 생성할 때 필수적인 파라미터에 특히 중요합니다. 한 가지 예는 character_set_database 파라미터로 정의되는 기본 데이터베이스에 대한 문자 집합입니다. Amazon RDS 콘솔의 파라미터 그룹 옵션이나 describe-db-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]를 선택합니다.

AWS CLI

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

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

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

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

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

예

Linux, macOS, Unix:

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

Windows의 경우:

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

RDS API

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

• SourceDBParameterGroupIdentifier

• TargetDBParameterGroupIdentifier

• TargetDBParameterGroupDescription

DB 파라미터 그룹 나열

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

참고

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

콘솔

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

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

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

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

AWS CLI

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

예

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

aws rds describe-db-parameter-groups

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

DBPARAMETERGROUP  default.mysql8.0     mysql8.0  Default parameter group for MySQL8.0
DBPARAMETERGROUP  mydbparametergroup   mysql8.0  My new parameter group

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

Linux, macOS, Unix:

aws rds describe-db-parameter-groups \
    --db-parameter-group-name mydbparamgroup1

Windows의 경우:

aws rds describe-db-parameter-groups ^
    --db-parameter-group-name mydbparamgroup1

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

DBPARAMETERGROUP  mydbparametergroup1  mysql8.0  My new parameter group

RDS API

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

DB 파라미터 그룹의 파라미터 값 보기

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

콘솔

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

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

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

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

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

AWS CLI

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

• --db-parameter-group-name

예

다음 예에서는 mydbparametergroup이라는 DB 파라미터 그룹에 대한 파라미터와 파라미터 값을 나열합니다.

aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup

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

DBPARAMETER  Parameter Name            Parameter Value  Source           Data Type  Apply Type  Is Modifiable
DBPARAMETER  allow-suspicious-udfs                      engine-default   boolean    static      false
DBPARAMETER  auto_increment_increment                   engine-default   integer    dynamic     true
DBPARAMETER  auto_increment_offset                      engine-default   integer    dynamic     true
DBPARAMETER  binlog_cache_size         32768            system           integer    dynamic     true
DBPARAMETER  socket                    /tmp/mysql.sock  system           string     static      false

RDS API

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

• DBParameterGroupName

DB 파라미터 그룹 삭제

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

콘솔

DB 파라미터 그룹을 삭제하는 방법

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

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

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

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

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

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

AWS CLI

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

• --db-parameter-group-name

예

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

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

RDS API

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

• DBParameterGroupName