13.3 설정 운영

설정 변경은 현재값, 변경 근거, 적용 방식, 검증값, 롤백을 기록하고 한 번에 하나씩 진행합니다. 설정 속성의 전체 목록과 기본값은 현재 릴리스의 설정 레퍼런스를 참고합니다.

설정 파일

기본 설정 파일은 $MACHBASE_HOME/conf/machbase.conf입니다. 패키지·서비스 구성에 따라 다른 파일을 사용할 수 있으므로 시작 명령과 실제 환경을 확인합니다.

변경 전에는 다음을 기록합니다.

• 파일 경로, 소유자, 권한
• 변경할 설정 속성의 현재 파일값과 V$PROPERTY 값
• 단위와 허용 범위
• 실행 시점 변경 가능 여부와 재시작 필요 여부
• 관련 노드·인스턴스 범위
• 롤백 값과 검증 SQL

비밀번호, AUTH KEY, 라이선스 내용을 일반 설정 백업이나 작업 기록에 포함하지 않습니다.

실행 중 변경과 재시작

ALTER SYSTEM SET은 지원되는 일부 설정 속성만 실행 시점에 변경합니다. 문서에 예시가 있다는 이유로 임의 설정 속성을 실행하지 않습니다.

SELECT NAME, VALUE FROM V$PROPERTY ORDER BY NAME;

1. 설정 레퍼런스에서 동적 변경 지원 여부를 확인합니다.
2. 유지보수 범위와 영향받는 연결·쿼리를 정합니다.
3. 현재값을 저장합니다.
4. 검증 환경 또는 제한된 워크로드에서 한 설정 속성만 변경합니다.
5. 응답 시간, 처리량, 메모리·I/O와 오류를 비교합니다.
6. 유지할 값은 설정 파일에도 반영해 재시작 후 되돌아가지 않게 합니다.
7. 재시작 후 V$PROPERTY와 기능 테스트로 적용을 확인합니다.

설정 속성 찾기

SELECT NAME, VALUE FROM V$PROPERTY
WHERE NAME LIKE 'PVO_CACHE%' ORDER BY NAME;

정확한 이름을 알고 있을 때는 NAME = '...'로 조회합니다. 이름이 비슷한 설정 속성을 추정해 설정하지 않습니다.

메모리 설정

프로세스 상한, 테이블 space·캐시, 입력 버퍼, 쿼리·세션의 일시 메모리를 하나의 예산으로 봅니다. OS와 같은 호스트의 다른 프로세스에 필요한 메모리도 남깁니다.

• 정상·최대 부하 워크로드의 resident 메모리와 available 메모리
• swap 발생 여부와 증가 시각
• 동시 쿼리·Appender·세션 수
• PVO, Min-Max, LOOKUP·VOLATILE 등 캐시 사용량
• 인덱스 생성, 정렬, 집계 같은 일시 작업

고정 비율이나 예시 바이트 값을 그대로 적용하지 않습니다.

네트워크와 세션

listener 주소·포트, 최대 세션, connect·쿼리 시간 초과는 애플리케이션 연결 수와 장애 격리 요구사항을 기준으로 정합니다. 방화벽과 바인딩을 별도 검증하고, 최대 세션을 늘리기 전에 연결 누수와 연결 풀 설정을 확인합니다.

SELECT ID, USER_NAME, USER_IP, LOGIN_TIME, CLIENT_TYPE
FROM V$SESSION ORDER BY LOGIN_TIME DESC;

스토리지와 체크포인트

DBS_PATH, 체크포인트, direct I/O, I/O 스레드 관련 설정은 데이터 위치와 복구 시간에 직접 영향을 줍니다. 운영 데이터 파일을 수동 이동하거나 다른 경로를 추정하지 않습니다.

• 실제 데이터·백업 경로와 파일 시스템을 확인합니다.
• 체크포인트 시간과 장치 지연 시간을 같은 시각에서 비교합니다.
• 재시작이 필요한 설정은 서비스 중단·복구 절차를 준비합니다.
• 변경 후 정상 재시작과 백업·복원을 검증합니다.

시간대

시간 문자열을 입력·표시할 시간대를 서버, command-line tool, SDK에서 일관되게 설정합니다. epoch 단위와 DATETIME 정밀도를 별도로 확인하고, 같은 값의 입력·조회 왕복 테스트를 수행합니다.

서버와 세션의 시간대

서버의 기본 시간대와 클라이언트가 선택한 세션 시간대를 구분합니다. 애플리케이션의 문자열 입출력 기준은 지원되는 연결 옵션으로 명시하고, 새 연결에서 SHOW TIMEZONE과 표본 DATETIME 조회로 확인합니다. 설정 방법은 시간대 설정 사전을 참고하십시오. 기존 연결의 세션 설정이 자동으로 변경되는 것은 아닙니다.

machsql -z

"$MACHBASE_HOME/bin/machsql"   -s 127.0.0.1 -P 5656   -u APP_USER -p "$MACH_SAMPLE_PASSWORD"   -z +0900

입력·출력 문자열이 해당 오프셋으로 해석·표시되는지 표본으로 확인합니다.

machloader -z

"$MACHBASE_HOME/bin/machloader"   -s 127.0.0.1 -P 5656   -u APP_USER -p "$MACH_SAMPLE_PASSWORD"   -z +0900 -i -t SENSOR_LOG -d /data/sensor.csv

CSV 원본의 시간대와 날짜 형식을 함께 문서화합니다.

SDK 연결 시간대

지원 옵션 이름은 SDK마다 다릅니다. 11장 개발 및 애플리케이션 연동 에서 해당 드라이버의 연결 옵션을 확인하고, 입력·조회·연결 풀 재사용 뒤에도 같은 시간대가 적용되는지 검증합니다.

변경 기록

확인되지 않은 추천값이나 과거 릴리스의 기본값을 현재 설정으로 간주하지 않습니다.