메뉴
Amazon Relational Database Service
사용 설명서 (API Version 2014-10-31)

DB 파라미터 그룹 작업

DB 파라미터 그룹의 파라미터 사용을 통해 DB 엔진 구성을 관리합니다. DB 파라미터 그룹은 하나 이상의 DB 인스턴스에 적용되는 엔진 구성 값의 컨테이너 역할을 합니다.

고객이 생성한 DB 파라미터 그룹을 지정하지 않고 DB 인스턴스를 생성할 경우 기본 DB 파라미터가 생성됩니다. 이 기본 그룹에는 인스턴스의 엔진, 컴퓨팅 클래스 및 할당된 스토리지에 따른 데이터베이스 엔진 기본값과 Amazon RDS 시스템 기본값이 들어 있습니다. 기본 DB 파라미터 그룹의 파라미터 설정을 수정할 수 없습니다. DB 파라미터 그룹을 직접 생성하여 해당 기본값에서 파라미터 설정을 변경해야 합니다. 고객이 생성한 DB 파라미터 그룹에서 모든 DB 엔진 파라미터를 변경할 수 있는 것은 아닙니다.

사용자 고유의 DB 파라미터 그룹을 사용하는 경우 새 DB 파라미터 그룹을 만들고, 원하는 파라미터를 수정하고, 새 DB 파라미터 그룹을 사용하도록 DB 인스턴스를 수정하면 됩니다. 특정 DB 파라미터 그룹과 연결된 모든 DB 인스턴스는 해당 DB 파라미터 그룹에 대한 모든 파라미터 업데이트를 가져옵니다. 또한 AWS CLI copy-db-parameter-group 명령으로 기존 파라미터 그룹을 복사할 수 있습니다. DB 파라미터 그룹을 이미 생성했으며 해당 그룹의 사용자 지정 파라미터와 값을 대부분 새 DB 파라미터 그룹에 포함하려는 경우 파라미터 그룹을 복사하면 편리합니다.

다음은 DB 파라미터 그룹의 파라미터 작업 시 알아 두어야 할 몇 가지 주요 사항입니다.

  • 동적 파라미터를 변경하고 DB 파라미터 그룹을 저장하면 [Apply Immediately] 설정과 관계없이 변경 내용이 바로 적용됩니다. 고정 파라미터를 변경하고 DB 파라미터 그룹을 저장하면 DB 인스턴스를 수동으로 재부팅한 후에 파라미터 변경 내용이 적용됩니다. RDS 콘솔을 사용하거나 명시적으로 RebootDbInstance API 작업을 호출하여 DB 인스턴스를 재부팅할 수 있습니다(DB 인스턴스가 다중 AZ 배포에 있는 경우 장애 조치 없음). 고정 파라미터 변경 후 연결된 DB 인스턴스를 재부팅하도록 하면 ModifyDBInstance를 호출하여 DB 인스턴스 클래스를 변경하거나 스토리지를 조정하는 경우와 같이 잘못된 파라미터 구성이 API 호출에 영향을 주는 위험을 완화할 수 있습니다.

  • DB 인스턴스와 연결된 DB 파라미터 그룹을 변경하면 DB 인스턴스에서 새 DB 파라미터 그룹을 사용하기 전에 인스턴스를 수동으로 재부팅해야 합니다.

  • DB 파라미터 값을 수식, 변수, 함수 및 연산자로 만든 정수 식이나 정수 또는 로그 식으로 지정할 수 있습니다. 자세한 내용은 DB 파라미터 값을(를) 참조하십시오.

  • DB 인스턴스를 만들기 전 및 DB 인스턴스에 데이터베이스를 만들기 전에, 파라미터 그룹에 있는 데이터베이스의 문자 세트 또는 데이터 정렬과 관련된 파라미터를 모두 설정해야 합니다. 이렇게 하면 DB 인스턴스의 기본 데이터베이스와 새 데이터베이스가 지정한 문자 세트 및 데이터 정렬 값을 사용하게 됩니다. DB 인스턴스의 문자 세트 또는 데이터 정렬 파라미터를 변경해도 기존 데이터베이스에는 변경된 파라미터가 적용되지 않습니다.

    다음과 같이 ALTER DATABASE 명령을 사용하여 기존 데이터베이스의 문자 세트 또는 데이터 정렬 값을 변경할 수 있습니다.

    Copy
    ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
  • DB 파라미터 그룹에 파라미터를 잘못 설정하면 성능 저하나 시스템 불안정 등의 의도하지 않은 부작용이 있을 수 있습니다. 데이터베이스 파라미터를 수정할 때 항상 주의하고 DB 파라미터 그룹을 수정하기 전에 데이터를 백업하십시오. 파라미터 그룹 변경 내용을 프로덕션 DB 인스턴스에 적용하기 전에 테스트 DB 인스턴스에 적용해 봐야 합니다.

  • Amazon Aurora는 DB 파라미터 그룹과 DB 클러스터 파라미터 그룹을 모두 사용합니다. DB 파라미터 그룹의 파라미터는 Aurora DB 클러스터의 단일 DB 인스턴스에 적용됩니다. DB 클러스터 파라미터 그룹의 파라미터는 DB 클러스터의 모든 DB 인스턴스에 적용됩니다. 자세한 내용은 DB 클러스터와 DB 인스턴스 파라미터을(를) 참조하십시오.

DB 파라미터 그룹 생성

다음 섹션에서는 새 DB 파라미터 그룹을 생성하는 방법을 보여 줍니다.

AWS Management Console

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

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

  2. 창 왼쪽의 [Navigation] 목록에서 [Parameter Groups]를 클릭합니다.

  3. [Create DB Parameter Group] 버튼을 클릭합니다.

    [Create DB Parameter Group] 창이 나타납니다.

  4. [DB Parameter Group Family] 드롭다운 목록에서 DB 파라미터 그룹 패밀리를 선택합니다.

  5. [DB Parameter Group] 텍스트 상자에 새 DB 파라미터 그룹의 이름을 입력합니다.

  6. [Description] 텍스트 상자에 새 DB 파라미터 그룹에 대한 설명을 입력합니다.

  7. [Yes, Create] 버튼을 클릭합니다.

CLI

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

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

  • --db-parameter-group-name

  • --db-parameter-group-family

  • --description

Linux, OS X, Unix의 경우:

Copy
aws rds create-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --db-parameter-group-family MySQL5.6 \ --description "My new parameter group"

Windows의 경우:

Copy
aws rds create-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --db-parameter-group-family MySQL5.6 ^ --description "My new parameter group"

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

Copy
DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group

API

DB 파라미터 그룹을 생성하려면 Amazon RDS API CreateDBParameterGroup 작업을 사용합니다. 다음 예에서는 "My new parameter group"이라는 설명과 함께 mydbparametergroup이라는 MySQL 버전 5.6용 DB 파라미터 그룹을 생성합니다.

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

  • DBParameterGroupName = mydbparametergroup

  • DBParameterGroupFamily= MySQL5.6

  • Description = My new parameter group

Copy
https://rds.amazonaws.com/ ?Action=CreateDBParameterGroup &DBParameterGroupName=mydbparametergroup &Description=My%20new%20parameter%20group &DBParameterGroupFamily=MySQL5.6 &Version=2012-01-15 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2012-01-15T22%3A06%3A23.624Z &AWSAccessKeyId=<AWS Access Key ID> &Signature=<Signature>

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

Copy
<CreateDBParameterGroupResponse xmlns="http://rds.amazonaws.com/admin/2012-01-15/"> <CreateDBParameterGroupResult> <DBParameterGroup> <DBParameterGroupFamily>mysql5.6</DBParameterGroupFamily> <Description>My new parameter group</Description> <DBParameterGroupName>mydbparametergroup</DBParameterGroupName> </DBParameterGroup> </CreateDBParameterGroupResult> <ResponseMetadata> <RequestId>700a8afe-0b81-11df-85f9-eb5c71b54ddc</RequestId> </ResponseMetadata> </CreateDBParameterGroupResponse>

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

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

파라미터 값을 변경할 경우 변경 내용이 적용되는 시기는 파라미터 유형에 의해 결정됩니다. 동적 파라미터의 변경 내용은 즉시 적용됩니다. 고정 파라미터를 변경할 경우 DB 파라미터 그룹과 연결된 DB 인스턴스를 재부팅해야 해당 변경 내용이 적용됩니다. 파라미터 유형을 확인하려면 DB 파라미터 그룹 나열 섹션의 절차 중 하나를 사용하여 파라미터 그룹의 파라미터를 나열합니다.

RDS 콘솔에 DB 인스턴스와 연결된 DB 파라미터 그룹의 상태가 표시됩니다. 예를 들어, DB 인스턴스에서 연결된 DB 파라미터 그룹에 대한 최신 변경 내용을 사용하고 있지 않은 경우 RDS 콘솔에 DB 파라미터 그룹이 [pending-reboot] 상태로 표시됩니다. 최신 파라미터 변경 내용을 DB 인스턴스에 적용하려면 해당 DB 인스턴스를 수동으로 재부팅해야 합니다.

 파라미터 변경 내용 보류 중 재부팅 시나리오

AWS Management Console

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

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

  2. 창 왼쪽의 탐색 창에서 [Parameter Groups]를 클릭합니다.

    사용 가능한 DB 파라미터 그룹이 목록에 나타납니다.

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

  4. [Edit Parameters]를 선택합니다.

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

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

  6. [Save Changes]를 클릭합니다.

CLI

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

  • --db-parameter-group-name

  • --parameters

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

참고

Amazon RDS는 단일 파라미터에 대해 쉼표로 구분된 여러 파라미터 값 전달을 지원하지 않습니다.

Linux, OS X, Unix의 경우:

Copy
aws rds modify-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --parameters "name=max_connections,value=250,method=immediate" \ --parameters "name=max_allowed_packet,value=1024,method=immediate"

Windows의 경우:

Copy
aws rds modify-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --parameters "name=max_connections,value=250,method=immediate" ^ --parameters "name=max_allowed_packet,value=1024,method=immediate"

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

Copy
DBPARAMETERGROUP mydbparametergroup

API

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

  • DBParameterGroupName

  • Parameters

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

참고

Amazon RDS는 단일 파라미터에 대해 쉼표로 구분된 여러 파라미터 값 전달을 지원하지 않습니다.

Copy
https://rds.amazonaws.com/ ?Action=ModifyDBParameterGroup &DBParameterGroupName=mydbparametergroup &Parameters.member.1.ParameterName=max_connections &Parameters.member.1.ParameterValue=250 &Parameters.member.1.ApplyMethod=immediate &Parameters.member.2.ParameterName=max_allowed_packet &Parameters.member.2.ParameterValue=1024 &Parameters.member.2.ApplyMethod=immediate &Version=2012-01-15 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2012-01-15T22%3A29%3A47.865Z

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

Copy
<ModifyDBParameterGroupResponse xmlns="http://rds.amazonaws.com/admin/2012-01-15/"> <ModifyDBParameterGroupResult> <DBParameterGroupName>mydbparametergroup</DBParameterGroupName> </ModifyDBParameterGroupResult> <ResponseMetadata> <RequestId>3b824e10-0b87-11df-972f-21e99bc6881d</RequestId> </ResponseMetadata> </ModifyDBParameterGroupResponse>

DB 파라미터 그룹 복사

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

DB 파라미터 그룹을 복사한 후 해당 DB 파라미터 그룹을 기본 파라미터 그룹으로 사용하는 첫 번째 DB 인스턴스를 생성하기 전에 5분 이상 기다려야 합니다. 그동안 파라미터 그룹이 새 DB 인스턴스의 기본값으로 사용되기 전에 Amazon RDS에서 복사 작업을 완전히 마칠 수 있습니다. 이는 character_set_database 파라미터에서 정의한 기본 데이터베이스의 문자 세트와 같은 DB 인스턴스의 기본 데이터베이스를 생성할 때 필요한 파라미터에 특히 중요합니다. describe-db-parameters 명령이나 Amazon RDS 콘솔의 [Parameter Groups] 옵션을 사용하여 DB 파라미터 그룹이 생성되었는지 확인할 수 있습니다.

CLI

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

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

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

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

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

Linux, OS X, Unix의 경우:

Copy
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의 경우:

Copy
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"

API

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

  • SourceDBPparameterGroupIdentifier = arn%3Aaws%3Ards%3Aus-west-2%3A123456789012%3Apg%3Amygroup1

  • TargetDBPparameterGroupIdentifier = mygroup2

  • TargetDBPparameterGroupDescription = DB%20parameter%20group%202

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

Copy
https://rds.us-east-1.amazonaws.com/ ?Action=CopyDBParameterGroup &SignatureMethod=HmacSHA256 &SignatureVersion=4 &SourceDBParameterGroupIdentifier=arn%3Aaws%3Ards%3Aus-west-2%3A123456789012%3Apg%3Amygroup1 &TargetDBParameterGroupIdentifier=mygroup2 &TargetDBParameterGroupDescription=DB%20parameter%20group%202 &Version=2014-09-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140922/us-east-1/rds/aws4_request &X-Amz-Date=20140922T175351Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=5164017efa99caf850e874a1cb7ef62f3ddd29d0b448b9e0e7c53b288ddffed2

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

Copy
<CopyDBParameterGroupResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/"> <CopyDBParameterGroupResult> <DBParameterGroup> <DBParameterGroupFamily>mysql5.6</DBParameterGroupFamily> <Description>DB parameter group 2</Description> <DBParameterGroupName>mygroup2</DBParameterGroupName> </DBParameterGroup> </CopyDBParameterGroupResult> <ResponseMetadata> <RequestId>3328d60e-beb6-11d3-8e5c-3ccda5460d76</RequestId> </ResponseMetadata> </CopyDBParameterGroupResponse>

DB 파라미터 그룹 나열

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

참고

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

AWS Management Console

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

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

  2. 창 왼쪽의 탐색 창에서 [Parameter Groups]를 클릭합니다.

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

CLI

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

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

Copy
aws rds describe-db-parameter-groups

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

Copy
DBPARAMETERGROUP default.mysql5.5 mysql5.5 Default parameter group for MySQL5.5 DBPARAMETERGROUP default.mysql5.6 mysql5.6 Default parameter group for MySQL5.6 DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group

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

Linux, OS X, Unix의 경우:

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

Windows의 경우:

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

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

Copy
DBPARAMETERGROUP mydbparametergroup1 mysql5.5 My new parameter group

API

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

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

Copy
https://rds.amazonaws.com/ ?Action=DescribeDBParameterGroups &MaxRecords=100 &Version=2012-01-15 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2009-10-22T19%3A31%3A42.262Z &AWSAccessKeyId=<AWS Access Key ID> &Signature=<Signature>

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

Copy
<DescribeDBParameterGroupsResponse xmlns="http://rds.amazonaws.com/admin/2012-01-15/"> <DescribeDBParameterGroupsResult> <DBParameterGroups> <DBParameterGroup> <Engine>mysql5.6</Engine> <Description>Default parameter group for MySQL5.6</Description> <DBParameterGroupName>default.mysql5.6</DBParameterGroupName> </DBParameterGroup> <DBParameterGroup> <Engine>mysql5.6</Engine> <Description>My new parameter group</Description> <DBParameterGroupName>mydbparametergroup</DBParameterGroupName> </DBParameterGroup> </DBParameterGroups> </DescribeDBParameterGroupsResult> <ResponseMetadata> <RequestId>41731881-0b82-11df-9a9b-c1bd5894571c</RequestId> </ResponseMetadata> </DescribeDBParameterGroupsResponse>

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

Copy
https://rds.amazonaws.com/ ?Action=DescribeDBParameterGroups &DBParameterGroupName=mydbparamgroup1 &MaxRecords=100 &Version=2012-01-15 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2009-10-22T19%3A31%3A42.262Z &AWSAccessKeyId=<AWS Access Key ID> &Signature=<Signature>

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

Copy
<DescribeDBParameterGroupsResponse xmlns="http://rds.amazonaws.com/admin/2012-01-15/"> <DescribeDBParameterGroupsResult> <DBParameterGroups> <DBParameterGroup> <Engine>mysql5.6</Engine> <Description>My new parameter group</Description> <DBParameterGroupName>mydbparamgroup1</DBParameterGroupName> </DBParameterGroup> </DBParameterGroups> </DescribeDBParameterGroupsResult> <ResponseMetadata> <RequestId>41731881-0b82-11df-9a9b-c1bd5894571c</RequestId> </ResponseMetadata> </DescribeDBParameterGroupsResponse>

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

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

AWS Management Console

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

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

  2. 창 왼쪽의 탐색 창에서 [Parameter Groups]를 클릭합니다.

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

  3. 목록에서 DB 파라미터 그룹을 선택합니다. [Details] 페이지 아이콘을 클릭하여 선택한 DB 파라미터 그룹에 대한 파라미터 목록을 봅니다.

CLI

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

  • --db-parameter-group-name

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

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

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

Copy
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

API

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

  • DBParameterGroupName = mydbparametergroup

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

Copy
https://rds.amazonaws.com/ ?Action=DescribeDBParameters &DBParameterGroupName=mydbparametergroup &MaxRecords=100 &Version=2012-01-15 &SignatureVersion=2 &SignatureMethod=HmacSHA256 &Timestamp=2009-10-22T19%3A31%3A42.262Z &AWSAccessKeyId=<AWS Access Key ID> &Signature=<Signature>

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

Copy
<DescribeDBParametersResponse xmlns="http://rds.amazonaws.com/admin/2012-01-15/"> <DescribeDBParametersResult> <Marker>bWF4X3RtcF90YWJsZXM=</Marker> <Parameters> <Parameter> <DataType>boolean</DataType> <Source>engine-default</Source> <IsModifiable>false</IsModifiable> <Description>Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded</Description> <ApplyType>static</ApplyType> <AllowedValues>0,1</AllowedValues> <ParameterName>allow-suspicious-udfs</ParameterName> </Parameter> <Parameter> <DataType>integer</DataType> <Source>engine-default</Source> <IsModifiable>true</IsModifiable> <Description>Intended for use with master-to-master replication, and can be used to control the operation of AUTO_INCREMENT columns</Description> <ApplyType>dynamic</ApplyType> <AllowedValues>1-65535</AllowedValues> <ParameterName>auto_increment_increment</ParameterName> </Parameter> <Parameter> <DataType>integer</DataType> <Source>engine-default</Source> <IsModifiable>true</IsModifiable> <Description>Determines the starting point for the AUTO_INCREMENT column value</Description> <ApplyType>dynamic</ApplyType> <AllowedValues>1-65535</AllowedValues> <ParameterName>auto_increment_offset</ParameterName> </Parameter> (... sample truncated...) </Parameters> </DescribeDBParametersResult> <ResponseMetadata> <RequestId>99c0937a-0b83-11df-85f9-eb5c71b54ddc</RequestId> </ResponseMetadata> </DescribeDBParametersResponse>

DB 파라미터 값

다음으로 DB 파라미터에 대한 값을 지정할 수 있습니다.

  • 정수 상수

  • DB 파라미터 수식

  • DB 파라미터 함수

  • 문자열 상수

  • 로그 식(log 함수는 log base 2를 나타냄), 예: 값={log(DBInstanceClassMemory/8187281418)*1000}

DB 파라미터 수식

DB 파라미터 수식은 정수 값으로 확인되는 식이며 중괄호({})로 묶입니다. DB 파라미터 함수에 대한 인수나 DB 파라미터 값에 대해 수식을 지정할 수 있습니다.

구문

Copy
{FormulaVariable}
Copy
{FormulaVariable*Integer}
Copy
{FormulaVariable*Integer/Integer}
Copy
{FormulaVariable/Integer}

DB 파라미터 수식 변수

수식 변수는 정수를 반환합니다. 변수 이름은 대소문자를 구분합니다.

AllocatedStorage

데이터 볼륨의 크기를 바이트 단위로 반환합니다.

DBInstanceClassMemory

현재 DB 인스턴스와 연결된 DB 인스턴스에 할당된 메모리에서 인스턴스를 관리하는 Amazon RDS 프로세스에 사용되는 메모리를 뺀 바이트 수를 반환합니다.

EndPointPort

DB 인스턴스에 연결하는 데 사용되는 포트의 번호를 반환합니다.

DB 파라미터 수식 연산자

DB 파라미터 수식은 나눗셈과 곱셈의 두 가지 연산자를 지원합니다.

나눗셈 연산자: /

나뉨수를 나눗수로 나누어 정수 몫을 반환합니다. 몫의 소수는 잘리며 반올림되지 않습니다.

구문

Copy
dividend / divisor

나뉨수 및 나눗수 인수는 정수 식이어야 합니다.

곱셈 연산자: *

나뉨수를 나눗수로 나누어 정수 몫을 반환합니다. 몫의 소수는 잘리며 반올림되지 않습니다.

구문

Copy
expression * expression

두 식 모두 정수여야 합니다.

DB 파라미터 함수

정수나 수식으로 파라미터 인수를 지정할 수 있습니다. 함수마다 인수가 하나 이상 있어야 합니다. 쉼표로 구분된 목록으로 여러 인수를 지정할 수 있습니다. 목록에 argument1,,argument3과 같은 빈 멤버를 넣을 수 없습니다. 함수 이름은 대/소문자를 구분하지 않습니다.

참고

현재 CLI에서는 DB 파라미터 함수가 지원되지 않습니다.

GREATEST()

정수 또는 파라미터 수식 목록에서 가장 큰 값을 반환합니다.

구문

Copy
GREATEST(argument1, argument2,...argumentn)

정수를 반환합니다.

LEAST()

정수 또는 파라미터 수식 목록에서 가장 작은 값을 반환합니다.

구문

Copy
LEAST(argument1, argument2,...argumentn)

정수를 반환합니다.

SUM()

지정된 정수나 파라미터 수식의 값을 더합니다.

구문

Copy
SUM(argument1, argument2,...argumentn)

정수를 반환합니다.

DB 파라미터 값 예

다음 예에서는 DB 파라미터에 대한 값에 수식과 함수를 사용하는 방법을 보여 줍니다.

주의

DB 파라미터 그룹에 파라미터를 잘못 설정하면 성능 저하나 시스템 불안정 등의 의도하지 않은 부작용이 있을 수 있습니다. 데이터베이스 파라미터를 수정할 때 항상 주의하고 DB 파라미터 그룹을 수정하기 전에 데이터를 백업하십시오. 파라미터 그룹 변경 내용을 프로덕션 DB 인스턴스에 적용하기 전에 지정 시간 복원을 사용하여 생성한 테스트 DB 인스턴스에 적용해 봐야 합니다.

Oracle 프로세스 파라미터에 GREATEST 함수를 지정하여 DBInstanceClassMemory를 9868951로 나눈 값과 80 중 더 큰 수로 사용자 프로세스 수를 설정할 수 있습니다.

Copy
GREATEST({DBInstanceClassMemory/9868951},80)

MySQL max_binlog_cache_size 파라미터 값에 LEAST() 함수를 지정하여 트랜잭션이 MySQL 인스턴스에서 사용할 수 있는 최대 캐시 값을 1MB와 DBInstanceClass/256 중 더 작은 값으로 설정할 수 있습니다.

Copy
LEAST({DBInstanceClassMemory/256},10485760)