파라미터 그룹 생성 및 관리
파라미터 그룹을 사용해 엔진 버전별 PostgreSQL 파라미터를 조회하고, 연결된 인스턴스 그룹에 적용할 설정을 관리하는 방법을 설명합니다.
카카오클라우드 PostgreSQL에서 제공하는 파라미터 목록과 기본 개념은 PostgreSQL 공식 문서를 따릅니다. 파라미터 변경은 PostgreSQL 서비스 운영에 영향을 미칠 수 있으므로 변경 전에 각 파라미터의 용도와 설정값을 충분히 검토하시기 바랍니다.
PostgreSQL 서비스에서 파라미터 그룹을 관리하는 방법은 다음과 같습니다.
- 생성, 수정 등 파라미터 그룹 관련 이벤트는 Alert Center > 이벤트 알림 기능으로 받아볼 수 있습니다. 설정 가능한 이벤트 내역은 Cloud Trail, 이벤트 알림 설정은 Alert Center > 알림 정책 생성 및 관리 가이드에서 확인할 수 있습니다.
- 파라미터 그룹 기능이 추가되기 전에 생성한 인스턴스 그룹(2025년 11월 27일 이전 생성)은
predeploy파라미터 그룹이 연결되어 있으며, 파라미터 그룹 내 설정값과 실제 PostgreSQL에서 조회되는 파라미터 값이 다를 수 있습니다. 또한 파라미터 그룹을 변경하는 경우, 파라미터 적용을 위해 최초 1회 PostgreSQL이 재시작됩니다.
파라미터 그룹 목록 보기
카카오클라우드 PostgreSQL에서 제공하는 파라미터 그룹, 기본/커스텀 그룹 목록을 확인할 수 있습니다.
-
카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
-
파라미터 그룹 메뉴를 클릭하고 확인할 파라미터 그룹 분류에 따라 커스텀 그룹/기본 그룹 탭을 선택합니다.
-
선택한 탭에 맞는 파라미터 그룹 메뉴로 이동합니다.
항목 설명 이름 파라미터 그룹 이름 엔진 버전 파라미터 그룹과 호환되는 PostgreSQL 엔진 버전 연결된 인스턴스 그룹 수 해당 그룹에 연결된 인스턴스 그룹 수
- 연결된 인스턴스 그룹의 파라미터 반영 상태에 이상이 있을 경우, 경고 아이콘 노출설명 파라미터 그룹 설명 더보기 커스텀 그룹만 제공
- 수정: 파라미터 수정
- 복사: 해당 그룹과 동일한 파라미터로 새로운 파라미터 그룹 생성
- 초기값으로 재설정: 해당 그룹의 파라미터를 생성 시점의 초기값으로 재설정
- 롤백: 해당 그룹의 파라미터를 직전값으로 되돌림, 수정한 내역이 없거나 이미 롤백을 한 경우 롤백 불가능
- 삭제: 해당 그룹 삭제
파라미터 그룹 상세 보기
PostgreSQL 파라미터 그룹의 상세 정보는 탭별로 구분해 확인할 수 있습니다.
- 카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 확인할 파라미터 그룹 분류에 따라 커스텀 그룹/기본 그룹 탭을 선택합니다.
- 선택한 탭에 맞는 파라미터 그룹 메뉴로 이동한 뒤 상세 정보를 조회할 파라미터 그룹을 선택합니다.
파라미터 그룹 상세 화면의 탭은 다음과 같이 구성됩니다.
- 파라미터: 파라미터의 이름, 값, 단위, 유형, 데이터 형식, 수정 여부를 확인할 수 있습니다.
Static파라미터 등 유형에 따라 수정 시 인스턴스 재시작이 필요할 수 있습니다. 파라미터 수정 시 유의 사항은 파라미터 그룹 수정을 참고해 주세요. - 연결된 인스턴스 그룹: 파라미터 그룹이 연결된 인스턴스 그룹과 파라미터 반영 상태를 확인할 수 있습니다. 파라미터 반영 상태가
Error-Sync,Suspended이면 [재시도] 버튼으로 연결된 인스턴스 그룹에 파라미터 반영을 다시 요청할 수 있습니다. 파라미터 반영 상태의 의미는 파라미터 반영 상태를 참고해 주세요. - 최근 이벤트: 최근 7일간 발생한 파라미터 그룹의 주요 이벤트를 확인할 수 있습니다. 이벤트 발생 시간, 이벤트 이름, 처리 결과, 관련 인스턴스 그룹 정보를 확인할 수 있습니다.
최근 이벤트 탭에서 확인할 수 있는 이벤트는 다음과 같습니다.
| 파라미터 그룹 유형 | 이벤트 이름 | 설명 |
|---|---|---|
| 커스텀 파라미터 그룹 | Create Parameter Group | 커스텀 파라미터 그룹 생성되었을 때 발생 |
| Update Parameter Group | 커스텀 파라미터 그룹의 정보(설명) 수정되었을 때 발생 | |
| Update Parameter | 파라미터의 값이 수정되었을 때 발생 | |
| Reset Parameters | 파라미터의 값을 초기값으로 재설정 요청이 들어왔을 때 발생 | |
| Rollback Parameters | 파라미터의 값의 롤백 요청이 들어왔을 때 발생 | |
| Apply Instance Group | 해당 파라미터 그룹을 인스턴스 그룹에 반영을 완료했을 경우 발생 | |
| 기본 파라미터 그룹 | Apply Instance Group | 해당 파라미터 그룹을 인스턴스 그룹에 반영을 완료했을 경우 발생 |
파라미터 그룹 생성
-
카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
-
파라미터 그룹 메뉴를 클릭하고 확인할 파라미터 그룹 분류에 따라 커스텀 그룹 탭을 선택합니다.
-
커스텀 그룹 탭으로 이동한 뒤 아이콘 > 파라미터 그룹 생성을 선택합니다.
-
파라미터 그룹 생성 페이지에서 필요한 내용을 입력합니다. 파라미터 값은 파라미터 그룹 생성 후 수정 가능합니다.
항목 구분 설명 기본 설정 파라미터 그룹 이름 파라미터 그룹의 이름
- 동일 프로젝트 내에서 중복된 이름은 사용할 수 없음설명(선택) 파라미터 그룹에 대한 부가 설명을 100자까지 입력 가능 파라미터 그룹 설정 엔진 버전 파라미터 그룹의 PostgreSQL 엔진 버전 기본 파라미터 그룹 해당 엔진 버전에서 제공하는 기본 파라미터 그룹 선택 파라미터 해당 파라미터 그룹의 초기 파라미터 값
파라미터 그룹 수정
커스텀 파라미터 그룹은 생성 후 설명과 수정하려는 파라미터 값을 변경할 수 있습니다. 수정 여부가 가능인 파라미터만 수정할 수 있으며, 값이 수정된 파라미터는 가능(수정됨)으로 변경됩니다.
Dynamic유형인 파라미터 중 일부는 글로벌로 적용되므로 세션 갱신이 필요합니다.Static유형인 파라미터가 수정되는 경우에는 연결된 인스턴스 그룹이 재시작됩니다.- 연결된 인스턴스 그룹의 파라미터 반영 상태가
Pending,Applying인 경우에는 파라미터를 수정할 수 없습니다. - 파라미터 그룹 수정 페이지에서는 수정 가능한 파라미터 목록 내에서 목록을 이동하여도 선택한 체크 박스가 유지됩니다.
- 일부 파라미터는 수정 시 PostgreSQL 서비스 운영에 영향을 미칠 수 있습니다. 자세한 내용은 파라미터 목록의 수정 시 주의해야 하는 파라미터를 확인해 주세요.
- 파라미터 수정 후 문제가 발생할 수 있으므로, 설정을 백업하려면 파라미터 그룹
복사를 권장합니다. 필요에 따라재시도,롤백,초기화를 사용할 수 있습니다.
-
카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
-
파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
-
수정할 파라미터 그룹을 확인한 뒤 [더보기] 아이콘 > 수정을 선택합니다.
-
파라미터 그룹 수정 페이지에서 필요한 내용을 수정합니다.
항목 구분 설명 기본 정보 파라미터 그룹 이름 파라미터 그룹의 이름 설명(선택) 파라미터 그룹에 대한 부가 설명을 100자까지 입력 가능 수정 가능한 파라미터 파라미터 그룹 내에서 수정 가능한 파라미터 목록
- 수정된 파라미터는 수정 여부가가능(수정됨)으로 변경 -
직접
값을 입력하거나기존 파라미터 불러오기기능을 활용해 기존 커스텀 파라미터 그룹에 입력된 파라미터 값을 불러오거나초기값으로 재설정기능을 활용해 최초 입력된 디폴트 값을 입력할 수 있습니다. 필요한 값으로 파라미터 그룹을 수정한 뒤 [확인] 버튼을 클릭합니다. -
인스턴스 그룹에 연결된 파라미터 그룹이 복수개인 경우, 파라미터 적용 방식을 선택할 수 있습니다.
일괄반영: 수정된 파라미터를 모든 인스턴스 그룹에 일괄 반영합니다.
순차반영: 수정된 파라미터를 인스턴스 그룹에 연속해서 반영합니다.
기존 파라미터 불러오기
버전에 상관없이 기존 커스텀 파라미터 그룹의 파라미터 값을 불러올 수 있습니다. 값을 불러오는 경우, 기존에 입력된 값을 대체하므로 파라미터를 불러오기 전 필요한 내용은 별도로 저장해 두시는 것을 권장드립니다.
커스텀 파라미터 그룹 내 파라미터값 수정 시, 일부 파라미터는 PostgreSQL 서비스 운영에 영향을 미칠 수 있습니다. 자세한 내용은 수정 시 주의해야 하는 파라미터를 참고하시기 바랍니다.
- 파라미터 그룹 수정 페이지로 이동합니다.
- 기존 파라미터 불러오기 팝업 창에서 불러올 파라미터 그룹 엔진 버전을 선택하고 대상 커스텀 파라미터 그룹을 선택합니다.
- 불러오는 파라미터 값을 확인한 뒤 [적용] 버튼을 클릭합니다.
파라미터에 사용되는 수식, 함수, 예약어
카카오클라우드 PostgreSQL 서비스의 파라미터 그룹에서는 일부 파라미터에 대해 수식, 함수, 예약어를 지원합니다. 예약어는 숫자형 및 문자열형 파라미터에만 사용할 수 있으며, 수식의 결과는 int64 범위의 정수(-9,223,372,036,854,775,807 ~ 9,223,372,036,854,775,807)여야 합니다.
자세한 내용은 아래를 참고해 주세요.
수식, 함수
| 구분 | 설명 |
|---|---|
| 수식 | 수식은 항상 {} 안에 작성 |
(), +, -, *, /를 사용 가능 | |
| 수식의 결과는 항상 숫자여야 함. | |
데이터 형식이 INTEGER인 경우 소수점은 버림 처리 | |
| 함수 | MAX(a, b, ...): 여러 개의 값 중 가장 큰 값을 반환, 대문자만 사용 |
| MIN(a, b, ...): 여러 개의 값 중 가장 작은 값을 반환, 대문자만 사용 | |
| SUM(a, b, ...): 여러 개의 값의 합을 반환, 대문자만 사용 | |
| IF(판별식, a, b): 판별식이 true면 a, false면 b를 반환, 대문자만 사용 |
예약어
데이터 크기 관련 예약어 kc.InstanceMemory, kc.VolumeSizeData, kc.VolumeSizeLog는 GB 단위를 기준으로 합니다.
계산식 내의 수 단위는 파라미터 별 unit을 기준으로 하기 때문에 예약어 사용 전 단위에 따른 수식 및 계산이 필요합니다.
| 구분 | 예약어 | 설명 |
|---|---|---|
| 예약어 | kc.InstanceMemory | 현재 DB 인스턴스 유형의 메모리 크기 값, GB 단위 |
| kc.InstanceMemoryMB | 현재 DB 인스턴스 유형의 메모리 크기를 메가바이트로 변환한 값 ex. kc.InstanceMemoryMB = kc.InstanceMemory * 1024 | |
| kc.InstanceMemoryKB | 현재 DB 인스턴스 유형의 메모리 크기를 킬로바이트로 변환한 값 ex. kc.InstanceMemoryKB = kc.InstanceMemory * 1024 * 1024 | |
| kc.VolumeSizeData | Data Volume 크기 값, GB 단위 | |
| kc.VolumeSizeDataMB | Data Volume 크기를 메가바이트로 변환한 값 ex. kc.VolumeSizeDataMB = kc.VolumeSizeData * 1024 | |
| kc.VolumeSizeDataKB | Data Volume 크기를 킬로바이트로 변환한 값 ex. kc.VolumeSizeDataKB = kc.VolumeSizeData * 1024 * 1024 | |
| kc.VolumeSizeLog | Log Volume 크기 값, GB 단위 | |
| kc.VolumeSizeLogMB | Log Volume 크기를 메가바이트로 변환한 값 ex. kc.VolumeSizeLogMB = kc.VolumeSizeLog * 1024 | |
| kc.VolumeSizeLogKB | Log Volume 크기를 킬로바이트로 변환한 값 ex. kc.VolumeSizeLogKB = kc.VolumeSizeLog * 1024 * 1024 |
1. shared_buffers 파라미터 계산식
## 크기 관련 예약어는 모두 GB 단위이기 때문에 사용자가 unit을 기준으로 8KB 단위로 변환 필요
# KB 단위로 전환을 위해 `* 1024 * 1024`으로 계산 후 unit인 8KB 단위 계산을 위해 8로 나눔
{((kc.InstanceMemory * 1024 * 1024 / 8)-((kc.InstanceMemory * 1024 * 1024 / 8) * 0.4))* 0.7} / unit: 8KB / dataType: integer
2. work_mem 파라미터 계산식
# '100'은 unit을 기준으로 KB 단위인 100KB로 계산되며, 메모리가 8GB이나 Unit을 기준으로 계산하게 되어 8KB+100KB = 108KB로 입력됨
{kc.InstanceMemory + 100} / unit: kb / dataType: integer (memory: 8GB)
# 8GB를 KB 단위로 계산하려는 경우, kc.InstanceMemory * 1024 * 1024와 같은 수식이 필요함
{kc.InstanceMemory * 1024 * 1024 + 100} / unit: kb / dataType: integer (memory: 8GB)
3. maintenance_work_mem 파라미터 계산식
# '65536'은 단위, unit을 기준으로 KB 단위로 계산되어 65536KB로 입력됨
{MAX(kc.InstanceMemory * 1024 * 1024 * 0.015, 65536)} / unit: kb / dataType: integer
1. effective_cache_size 파라미터 계산식
#kc.InstanceMemory * 1024 * 1024는 kc.InstanceMemoryKB로 입력 가능
{((kc.InstanceMemory * 1024 * 1024 / 8)-((kc.InstanceMemory * 1024 * 1024 / 8) * 0.4))* 0.7}
{((kc.InstanceMemoryKB / 8)-((kc.InstanceMemoryKB / 8) * 0.4))* 0.7}
2. wal_keep_size 파라미터 계산식
#kc.VolumeSizeData * 1024는 kc.VolumeSizeDataMB로 입력 가능
{kc.VolumeSizeData * 1024 / 10}
{kc.VolumeSizeDataMB / 10}
파라미터 그룹 복사
커스텀 파라미터 그룹에서는 복사 기능을 제공하며 백업용으로 사용할 수 있습니다. 선택한 파라미터 그룹을 복사하여 새로운 파라미터 그룹을 만듭니다.
- 카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 복사할 파라미터 그룹을 확인한 뒤 [더보기] 아이콘 > 복사를 선택합니다.
- 팝업창에서 입력 정보를 확인한 후 [확인] 버튼을 클릭합니다.
- 커스텀 그룹 탭에서 복사된 파라미터 그룹을 확인합니다.
파라미터 그룹 초기값으로 재설정
커스텀 파라미터 그룹에서는 변경한 파라미터 값을 초기값으로 재설정할 수 있습니다. 초기값은 파라미터 그룹 생성 시 선택한 엔진 버전에서 기본으로 제공하는 디폴트값을 의미합니다. 초기값으로 재설정하면 연결된 인스턴스 그룹 전체에 파라미터 변경이 일괄 적용됩니다.
- 커스텀 파라미터 그룹 생성 후 수정한 파라미터가 없거나 연결된 인스턴스 그룹의 파라미터 반영 상태가
Pending,Applying인 경우에는 파라미터를 초기값으로 재설정할 수 없습니다. Static유형인 파라미터가 초기화되는 경우에는 연결된 인스턴스 그룹이 재시작됩니다.
- 카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 초기값으로 재설정할 파라미터 그룹을 확인한 뒤 [더보기] 아이콘 > 파라미터 초기값으로 재설정을 선택합니다.
- 팝업창에서 안내사항을 확인한 후 [확인] 버튼을 클릭합니다.
인스턴스 그룹에 연결된 파라미터 그룹이 복수개인 경우, 파라미터 적용 방식을 선택할 수 있습니다.일괄반영: 수정된 파라미터를 모든 인스턴스 그룹에 일괄 반영합니다.
순차반영: 수정된 파라미터를 인스턴스 그룹에 연속해서 반영합니다. - 연결된 인스턴스 그룹이 있는 경우, 각 인스턴스 그룹의 파라미터 반영 상태로 재설정이 잘 반영되었는지 확인합니다.
파라미터 그룹 롤백
커스텀 파라미터 그룹에서는 파라미터 값을 수정한 후 직전 값으로 변경할 수 있는 롤백 기능을 제공합니다. 파라미터 그룹은 직전 변경 이력이 있는 경우에만 롤백할 수 있습니다.
- 연결된 인스턴스 그룹의 파라미터 반영 상태가
Pending,Applying인 경우에는 파라미터 그룹은 롤백할 수 없습니다. Static유형인 파라미터가 롤백되는 경우에는 연결된 인스턴스 그룹이 재시작됩니다.- 롤백을 수행한 후에는 이미 직전의 수정 이력으로 변경되었기 때문에 더 이전의 수정 이력으로 롤백할 수는 없습니다. 롤백 후 다시 파라미터를 수정하게 되면 수정 이력이 생기므로 다시 롤백을 사용할 수 있습니다.
- 카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 롤백할 파라미터 그룹을 확인한 뒤 [더보기] 아이콘 > 롤백을 선택합니다.
- 팝업창에서 안내 사항을 확인하고, [확인] 버튼을 클릭합니다.
- 연결된 인스턴스 그룹이 있는 경우, 각 인스턴스 그룹의 파라미터 반영 상태로 롤백이 잘 반영되었는지 확인합니다.
파라미터 그룹 삭제
커스텀 파라미터 그룹을 더 이상 사용하지 않는 경우, 파라미터 그룹을 삭제할 수 있습니다.
- 기본 파라미터 그룹은 삭제할 수 없습니다.
- 연결된 인스턴스 그룹이 있는 경우에는 파라미터 그룹을 삭제할 수 없습니다.
- 카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 삭제할 파라미터 그룹을 확인한 뒤 [더보기] 아이콘 > 삭제를 선택합니다.
- 팝업창에서 입력 정보를 작성한 후 [확인] 버튼을 클릭합니다.
- 커스텀 그룹 탭에서 파라미터 그룹이 삭제되었는지 확인합니다.
파라미터 그룹 반영 재시도
연결된 인스턴스의 파라미터 반영 상태가 In-Sync가 아닌 Error-Sync, Suspended일 때만 파라미터 반영을 재시도할 수 있습니다.
파라미터 반영 상태에 대한 자세한 설명은 파라미터 반영 상태 참고하시기 바랍니다.
- 카카오클라우드 콘솔 > Data Store > PostgreSQL 메뉴로 이동합니다.
- 파라미터 그룹 메뉴를 클릭하고 커스텀 그룹 탭을 선택합니다.
- 선택한 탭에 맞는 파라미터 그룹 메뉴로 이동한 뒤 상세 정보를 조회할 파라미터 그룹을 선택합니다.
- 연결된 인스턴스 그룹 탭으로 이동합니다.
- 재시도할 인스턴스의 [재시도] 버튼을 클릭합니다.
파라미터 그룹 엔진 버전 확인
인스턴스 그룹의 엔진 버전이 파라미터 그룹과 맞지 않으면 엔진 버전 확인 뱃지가 표시됩니다. 이 뱃지가 표시된 커스텀 파라미터 그룹은 서비스 안정을 위해 수정할 수 없습니다.
엔진 버전이 맞지 않는 인스턴스 그룹은 파라미터 그룹 메뉴의 인스턴스 탭에서 확인할 수 있습니다. 인스턴스 그룹에서 파라미터 그룹 변경 기능을 사용해 엔진 버전에 맞는 파라미터 그룹으로 변경하면 뱃지가 표시되지 않습니다.
기존에 설정한 파라미터 값을 그대로 사용하려면, 엔진 버전이 맞는 파라미터 그룹을 새로 만든 뒤 파라미터 그룹 수정의 기존 파라미터 불러오기 기능을 사용합니다.