DB Cluster 상세 보기

VPC 환경에서 이용 가능합니다.

DB Cluster를 운영하다 보면 생성 당시 설정했던 DB 관련 옵션을 변경해야 하는 상황이 발생할 수 있습니다. Cloud DB Serverless에서는 이미 생성한 DB 클러스터일지라도 간편하게 몇 번의 클릭으로 관련 설정을 변경할 수 있도록 지원하고 있습니다.

참고

DB 관리 기능은 기본적으로 DB 클러스터 상태가 운영중인 경우에 사용 가능합니다.
DB 관리 기능은 DB 클러스터와 DB 인스턴스에 따라 사용 가능한 메뉴가 상이합니다.

생성하여 운영 중인 DB Cluster를 관리하는 방법은 다음과 같습니다.

네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 Menu > All Services > Database > Cloud DB Serverless 메뉴를 차례대로 클릭해 주십시오.
DB Cluster 메뉴를 클릭해 주십시오.
DB Cluster 목록에서 관리할 Cluster를 클릭한 다음 [DB 관리] 버튼을 클릭해 주십시오.
DB Cluster 상세 보기 메뉴에서 필요한 관리 탭을 클릭해 주십시오.

Database 관리

선택한 DB 클러스터에 데이터베이스를 추가하거나 생성한 데이터베이스를 삭제할 수 있습니다. 데이터베이스는 최대 1,000개까지 추가 및 조회 할 수 있으며, 추가 및 삭제 작업은 한번에 10개까지 가능합니다.

DB 추가 및 생성 작업을 수행하려면 [Database 추가] 버튼을 클릭하여 데이터베이스를 추가하거나 생성된 DB 행의 [삭제] 버튼을 클릭하여 데이터베이스를 삭제해 주십시오.

주의

데이터베이스를 삭제하면 선택한 데이터베이스의 모든 데이터가 삭제됩니다.

DB Config 관리

DB 클러스터가 운영중 상태에서 다양한 설정을 변경할 수 있습니다. 변경한 설정값은 DB 클러스터 전체에 적용되며, 일부 Config 변수는 변경 시 DB 클러스터가 재시작된 후 적용됩니다. 변경하는 방법은 다음과 같습니다.

DB Config 관리 탭에서 필요한 정보를 확인하거나 입력해 주십시오.
- Config Name: 설정 변수 이름
- Config Value: 변수값
[추가] 버튼을 클릭해 주십시오.
- 추가한 설정 변수 수정 시: [수정] 버튼 클릭
- 추가한 설정 변수 삭제 시(기본값으로 설정 시): [삭제] 버튼 클릭
[저장] 버튼을 클릭해 주십시오.
DB 클러스터 목록에서 Config를 변경한 Status를 확인해 주십시오.
- 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태
- 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태

주의

설정한 Config값이 적합하지 않은 경우 DB 클러스터가 정상적으로 동작하지 않을 수 있습니다. 설정 전 Config 변수의 동작을 충분히 숙지한 후 적용해 주십시오. 만약 잘못된 설정으로 DB 클러스터 동작에 문제가 발생한 경우 고객 센터로 문의해 주십시오.
DB Config 관리를 통해 로그(binary, error, slow, general log)가 수집되도록 설정하는 경우 해당 DB 클러스터의 데이터 스토리지 영역에 저장하고, 사용량 만큼 비용이 발생합니다.

Config 변수 목록

Config 변수에 대한 설명은 다음과 같습니다.

참고

Config 변수 설정에 대한 자세한 설명은 MySQL 공식 문서(영문)를 참조해 주십시오.
일부 Config 변수는 Cloud DB Serverless 내부적으로 관리되어 직접 수정이 불가합니다.

DB User 관리

DB 클러스터를 생성할 때 접속할 계정의 아이디와 비밀번호를 기본으로 생성합니다. 하지만 DB 클러스터를 운영하다 보면 사용자를 추가해야 하거나, 기존 사용자 계정 비밀번호를 재설정해야 하는 상황이 발생할 수 있습니다. 또는 사용자 계정을 삭제해야 할 수도 있습니다. Cloud DB Serverless에서는 DB 클러스터를 사용하는 사용자 계정의 추가, 수정, 삭제를 간편하게 할 수 있는 DB User 관리 기능을 제공합니다. DB User 관리 기능으로 사용자 계정을 변경한 결과는 DB Service 전체에 적용됩니다. 사용자 계정은 최대 1,000개까지 추가할 수 있습니다.

사용자 계정을 추가, 삭제하거나 기존 관리자 계정의 비밀번호를 변경하는 방법은 다음과 같습니다.

DB User 관리 탭에서 사용자 계정에 필요한 작업을 진행해 주십시오.
- 사용자 계정 추가: USER_ID, DB 권한, 암호에 정보를 입력한 후 [DB User 추가] 버튼 클릭
  - 모든 DB 권한은 system DB의 execute 권한을 포함
  - CRUD 권한은 READ 권한을 포함하며, DDL 권한은 READ, CRUD 권한을 포함
  - 프로시저 조회는 권한과 상관 없이 모든 계정에서 수행 가능(MySQL 공식 문서(영문) 참조)
- 사용자 계정 삭제: 삭제할 사용자 계정 행에서 [삭제] 버튼 클릭
- 사용자 계정 비밀번호 수정: 수정할 사용자 계정 행에서 [수정] 버튼 클릭하여 수정 후 [저장] 버튼 클릭
[저장] 버튼을 클릭해 주십시오.
DB 클러스터 화면의 목록에서 User를 설정한 DB 클러스터의 상태를 확인해 주십시오.
- 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태
- 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태

주의

사용자 계정을 삭제할 경우, 삭제된 계정을 사용하고 있던 애플리케이션은 접근이 불가능해 집니다.
콘솔에서 허용하지 않는 문자로 DB User를 생성할 경우, 콘솔에서 수정, 삭제가 불가능합니다. DB 클러스터에 직접 접속 후 변경해 주십시오.

Audit 설정 관리

DB 클러스터에서 발생하는 접속 및 쿼리 수행 내역을 감사(Audit) 목적으로 로그 파일에 기록할 수 있습니다. Audit 설정 관리에서 Audit Log 사용 여부, 기록할 이벤트 범위, 로그 형식을 설정할 수 있으며, 변경한 설정은 DB 클러스터 전체에 적용됩니다. 변경하는 방법은 다음과 같습니다.

Audit 설정 관리 탭에서 아래 내용을 참조하여 설정을 변경해 주십시오.
- Audit Log 사용: Audit Log의 활성화 여부 선택 (기본값: 비활성화)
- Audit Policy: Audit Log에 기록할 이벤트 정의 (기본값: ALL)
  - LOGINS: DB에 접속하는 DB 계정의 접속 및 접속 해제만 기록
  - QUERIES: DB에서 발생하는 DDL 문을 포함한 쿼리 기록
  - ALL: LOGINS + QUERIES
- Log Format: Audit Log 파일에 기록되는 형식 (JSON, XML 중 선택, 기본값: JSON)
[저장] 버튼을 클릭해 주십시오.
재시작 안내 팝업이 표시되는 경우 내용을 확인한 후 [확인] 버튼을 클릭해 주십시오.
DB Cluster 화면의 DB 클러스터 목록에서 Audit을 설정한 대상의 Status를 확인해 주십시오.
- 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태
- 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태

설정 변경 시 재시작 여부

변경 내용	재시작	설명
Audit Log 활성화	필요	DB 클러스터의 모든 DB 인스턴스가 재시작된 후 적용
Log Format 변경	필요	활성화 상태에서 Log Format을 변경하는 경우 재시작된 후 적용
Audit Policy 변경	불필요	활성화 상태에서 Audit Policy만 변경하는 경우 즉시 적용
Audit Log 비활성화	불필요	즉시 적용되며, 이미 기록된 Audit Log 파일은 삭제되지 않고 유지

Audit Log 필드 목록

Audit Log에 기록되는 정보는 동일하나 Log Format(JSON/XML)에 따라 필드 이름과 구조가 다릅니다.

JSON: 레코드 배열로 기록되며, 각 레코드는 공통 필드와 이벤트 종류별 데이터 객체로 구성됩니다.
XML: <AUDIT_RECORD> 요소의 하위 요소로 기록되며, 모든 항목이 대문자 요소 이름을 사용합니다.
- 필드 대응표

항목	JSON	XML
이벤트 발생 시간(UTC+0)	timestamp	TIMESTAMP
레코드 ID	id	RECORD_ID XML은 `<번호>_<시각>` 형식
이벤트 종류	class + event	NAME
수행된 작업 유형	query_data.sql_command	COMMAND_CLASS
Client connection ID	connection_id	CONNECTION_ID
접속 계정	account.user	USER
인증에 사용된 계정	account.user에 포함	PRIV_USER
접속 호스트	account.host	HOST
Client IP 주소	login.ip	IP
외부 인증 사용자	login.os	OS_LOGIN
Proxy 사용자	login.proxy	PROXY_USER
접속 시 default DB	connection_data.db	DB
접근한 테이블	table_access_data.table	TABLE
상태 결과 값(0: 성공)	connection_data.status general_data.status command_data.status query_data.status	STATUS
커넥션 종류	connection_data.connection_type	CONNECTION_TYPE
수행된 SQL 문	query_data.query parse_data.query	SQLTEXT
재작성된 SQL 문	parse_data.rewritten_query	REWRITTEN_QUERY
파싱 플래그	parse_data.flags	FLAGS
수행된 커맨드 종류	command_data.command	COMMAND_CLASS
조회한 변수 이름/값	global_variable_data.name global_variable_data.value	VARIABLE_NAME VARIABLE_VALUE
Client 정보	connection_attributes	CONNECTION_ATTRIBUTES XML은 ATTRIBUTE의 NAME/VALUE 쌍으로 반복
서버 ID	server_id	SERVER_ID

Client 정보(connection_attributes)에는 _pid, _platform, _os, _client_name, _client_version,
program_name, os_user 등이 기록되며, 접속에 사용한 커넥터에 따라 항목이 달라질 수 있습니다.

* 이벤트 종류 대응표

설명	JSON (class/event)	XML (NAME)
접속	connection/connect	Connect
접속 해제	connection/disconnect	Disconnect
쿼리 시작	query/query_start	Query Start
쿼리 종료	query/query_status_end	Query Status End
커맨드 시작	command/command_start	Command Start
커맨드 종료	command/command_end	Command End
쿼리 재작성	parse/query_rewritten	Query Rewritten
Prepared statement	parse/prepared_statement	Prepared Statement
테이블 조회	table_access/read	TableRead
테이블 입력	table_access/insert	TableInsert
변수 조회	global_variable/variable_get	Variable Get
일반 상태	general/status	Status
일반 결과	general/result	Result
오류	general/error	Error

* 레코드 예시

JSON

{
  "timestamp": "2026-07-31 17:23:37",
  "id": 62,
  "class": "connection",
  "event": "connect",
  "connection_id": 10,
  "account": { "user": "app_user", "host": "" },
  "login": { "user": "app_user", "os": "", "ip": "127.0.0.1", "proxy": "" },
  "connection_data": { "connection_type": "tcp/ip", "status": 0, "db": "fmtdb" }
}

XML

<AUDIT_RECORD>
  <NAME>Connect</NAME>
  <RECORD_ID>5_2026-07-31T17:23:37</RECORD_ID>
  <TIMESTAMP>2026-07-31T17:23:37</TIMESTAMP>
  <COMMAND_CLASS>Connection</COMMAND_CLASS>
  <CONNECTION_ID>10</CONNECTION_ID>
  <HOST>localhost</HOST>
  <IP>127.0.0.1</IP>
  <USER>app_user</USER>
  <OS_LOGIN></OS_LOGIN>
  <PRIV_USER>app_user</PRIV_USER>
  <PROXY_USER></PROXY_USER>
  <DB>fmtdb</DB>
  <STATUS>0</STATUS>
  <CONNECTION_TYPE>TCP/IP</CONNECTION_TYPE>
</AUDIT_RECORD>

로그인에 실패한 경우 접속 이벤트(JSON connection/connect, XML Connect)의 상태 결과 값에
오류 번호가 기록됩니다. 예를 들어 비밀번호가 틀린 경우 1045가 기록됩니다.

주의

Audit Log 활성화 또는 Log Format 변경 시 DB 클러스터의 모든 DB 인스턴스가 재시작됩니다. 재시작 중에는 DB 접속이 끊길 수 있으며, Primary가 재시작되는 동안에는 쓰기(Write) 작업을 수행할 수 없습니다. 단, Failover는 발생하지 않습니다.
Audit Policy를 ALL 또는 QUERIES로 설정하는 경우 수행되는 모든 쿼리가 기록되어 로그 발생량이 크게 증가할 수 있습니다.
Audit Log는 DB 클러스터의 데이터 스토리지 및 Cloud Log Analytics 서비스를 이용하므로 용량에 대한 추가 비용이 발생합니다.

참고

Log Format을 변경하면 기록되는 정보는 동일하나 필드 이름과 구조가 달라집니다. Audit Log를 수집해 분석하는 시스템을 연동한 경우 Log Format 변경 시 파싱 규칙도 함께 변경해 주십시오.
Audit Log가 비활성화 상태인 경우 Audit Policy와 Log Format은 선택할 수 없습니다.
Audit Log의 로테이션 및 보관 설정은 DB Log 설정 관리 탭에서 다른 로그와 동일한 방식으로 변경할 수 있습니다.
수집된 Audit Log는 다른 DB 로그와 동일한 방식으로 파일로 저장됩니다. 로그 파일 목록은 [DB 관리] > DB Instance 상세 보기 > DB Instance Logs에서, 로그 내용은 Monitoring > DB Logs에서 조회할 수 있습니다.
사용 중인 Audit Log 파일은 mysql-audit.log로 저장되며, 로테이션된 파일은 mysql-audit.<로테이션 시각>.log 형식으로 저장됩니다.
DB 클러스터 운영 및 이중화를 위해 네이버 클라우드 플랫폼에서 사용하는 관리 계정의 활동은 Audit Log 기록 대상에서 제외됩니다.

DB Log 설정 관리

생성한 DB 클러스터의 로그 로테이션 및 보관 설정을 변경할 수 있습니다. 변경 시 DB 클러스터 전체에 적용됩니다. 변경하는 방법은 다음과 같습니다.

DB Log 설정 관리 탭에서 아래 내용을 참조하여 설정을 변경해 주십시오.
- Log: 로그 이름 확인 (Error Log, Slow Query Log, General Log, Audit Log 중 선택)
- Log Rotate: 로그 로테이션이 매일 또는 사이즈별로 수행되도록 설정
  - 사이즈로 선택 시 10~100MB 중 선택
- Log file: 저장할 로그 파일의 개수 (3~7개 중 선택)
[저장] 버튼을 클릭해 주십시오.
DB Cluster 화면의 DB 클러스터 목록에서 Log를 설정한 대상의 Status를 확인해 주십시오.
- 설정중: 사용자가 입력한 정보로 DB 클러스터를 구성하고 있는 상태
- 운영중: 사용자가 입력한 정보로 DB 클러스터의 설정이 완료된 상태

참고

General Query Log는 DB 관리 > DB Cluster 상세 보기 > DB Config 관리에서 general_log를 활성화해야 적재됩니다.
Audit Log는 DB 관리 > DB Cluster 상세 보기 > Audit 설정 관리에서 활성화한 경우에만 로테이션 및 보관 설정을 변경할 수 있습니다.
Log Rotate 타입 변경 시 이전 로그는 자동 삭제가 불가합니다. 불필요한 로그는 [DB 관리] > DB Instance 상세 보기 > DB Instance Logs > [Log 삭제] 기능을 통해 삭제 바랍니다.

Backup 설정 관리

선택한 DB 클러스터의 백업 파일 보관 기간 및 백업 수행 시간 설정을 변경할 수 있습니다. 변경하는 방법은 다음과 같습니다.

Backup 설정 관리 탭에서 아래 내용을 참조하여 설정을 변경해 주십시오.
- Backup 설정: Cloud DB Serverless의 백업 설정의 사용 여부 선택 (현재 옵션 변경 불가)
- Backup 파일 보존 기간: 1~30까지 입력 가능
- Backup 시간: 백업을 진행하는 시간 설정이며 선택한 시간으로부터 15분 이내에 백업 수행
  - 자동: 하루마다 자동으로 백업 시작
  - 사용자 정의: 하루마다 사용자가 설정한 시간+15분 사이에 백업 시작
[저장] 버튼을 클릭해 주십시오.