[ postgresql ] 파라미터

Postgresql 에서 많이 사용하는 파라미터와 설명을 정리해 보았다. 

 

파라미터	설명
autovacuum_analyze_scale_factor	테이블 전체 행 수 대비, ANALYZE가 실행될 변경 비율
autovacuum_naptime	autovacuum 프로세스가 각 테이블을 검사하는 간격(초)
cron.database_name	pg_cron 확장에서 작업이 실행될 데이터베이스명
default_statistics_target	ANALYZE 시 컬럼 통계 샘플링 정도(샘플 개수)를 지정
idle_in_transaction_session_timeout	트랜잭션이 열린 채로 아무 작업도 하지 않는 (Idle in transaction) 세션의 최대 허용 시간(ms). 초과 시 세션이 종료
idle_session_timeout	아무 쿼리도 실행하지 않고 대기 중인(Idle) 세션의 최대 허용 시간(ms)
log_connections	클라이언트가 데이터베이스에 접속할 때마다 로그로 남길지 여부
log_disconnections	클라이언트가 데이터베이스에서 접속을 끊을 때 로그로 남길지 여부
log_error_verbosity	로그에 기록되는 오류 메시지의 상세 정도를 지정 (예: terse, default, verbose)
log_lock_waits	쿼리가 락 대기 상태로 일정 시간 이상 지연될 때 해당 상황을 로그로 남길지 여부
log_min_duration_statement	지정한 시간(ms) 이상 소요된 쿼리만 로그로 남김
log_statement	어떤 종류의 SQL 문을 로그로 남길지 설정합니다. (none, ddl, mod, all 등)
max_parallel_maintenance_workers	VACUUM, CREATE INDEX 등 유지보수 작업에 사용할 수 있는 최대 병렬 워커 수
max_parallel_workers_per_gather	Gather 연산(병렬 쿼리 실행) 시 사용 가능한 최대 워커 수
max_replication_slots	동시 생성 가능한 replication slot(스트리밍/논리 복제용)의 최대 개수
max_wal_senders	WAL 데이터를 전송할 수 있는 최대 wal sender 프로세스 수(주로 스트리밍 복제에 사용)
max_wal_size	자동 체크포인트가 발생하기 전까지 WAL 파일이 차지할 수 있는 최대 크기
min_wal_size	체크포인트 후 유지할 WAL 파일의 최소 크기
rds_force_admin_logging_level	(AWS RDS) 관리자 작업에 대한 로그 레벨을 강제로 지정
rds.log_retention_period	(AWS RDS) 로그 파일의 보관 기간을 일 단위로 지정
rds.restrict_password_commands	(AWS RDS) 비밀번호 변경 등 보안 관련 명령어의 사용을 제한할지 여부
shared_preload_libraries	PostgreSQL 시작 시 미리 로드할 확장 라이브러리 목록을 지정 (예: pg_stat_statements, pgaudit 등)
temp_buffers	임시 테이블 작업에 사용할 수 있는 버퍼(메모리) 크기
temp_file_limit	세션별 임시 파일의 최대 허용 크기(MB)
temp_tablespaces	임시 테이블 및 임시 파일을 저장할 테이블스페이스
timezone	데이터베이스의 기본 시간대를 지정
track_activity_query_size	pg_stat_activity 뷰에 저장되는 쿼리 문자열의 최대 길이
track_commit_timestamp	각 트랜잭션의 커밋 타임스탬프 추적 기능을 활성화할지 여부
vacuum_freeze_min_age	VACUUM이 tuple을 "frozen" 상태로 만드는 최소 트랜잭션 age를 지정
vacuum_freeze_table_age	테이블 전체 VACUUM FREEZE가 강제로 실행되는 age 기준을 지정
vacuum_multixact_freeze_min_age	VACUUM 작업 시, 멀티트랜잭션(MultiXact) ID가 "frozen" 상태로 변환되기 위한 최소 age(경과 트랜잭션 수)를 지정
vacuum_multixact_freeze_table_age	테이블의 가장 오래된 MultiXact ID가 이 값보다 오래되면, VACUUM이 해당 테이블에서 강제로 freeze 작업을 수행
wal_buffers	WAL 데이터를 디스크에 기록하기 전 임시로 보관하는 메모리 버퍼 크기
wal_keep_size	복제용으로 보관할 WAL 파일의 최소 크기입니다. (슬레이브가 따라잡을 때까지 보관)
work_mem	정렬, 해시 조인 등 쿼리 실행 시 각 작업에 할당되는 메모리 크기
rds.logical_replication	(AWS RDS) 논리 복제 기능의 활성화 여부
hot_standby_feedback	슬레이브에서 쿼리 실행 중 마스터의 vacuum 작업이 슬레이브 쿼리를 방해하지 않도록 피드백을 줄지 여부를 설정
max_parallel_workers	전체 서버에서 사용 가능한 병렬 워커의 최대 수
max_worker_processes	서버 전체에서 실행 가능한 백그라운드 워커 프로세스의 최대 수
pgaudit.log	pgaudit 확장에서 어떤 유형의 쿼리를 감사 로그로 남길지 지정
pglte.clientauth_db_name	pglte 확장에서 클라이언트 인증에 사용할 데이터베이스명
pglte.enable_clientauth	pglte 확장의 클라이언트 인증 기능 활성화 여부
pglte.enable_password_check	pglte 확장의 비밀번호 체크 기능 활성화 여부
pglte.passcheck_db_name	pglte 확장에서 비밀번호 체크에 사용할 데이터베이스명