local_preload_libraries

접속 시작 시점에 미리 로드할 shared library를 지정한다. 일반 사용자도 설정할 수 있는 preload 파라미터다.

값은 쉼표로 구분한 라이브러리 이름 목록이며, 각 이름은 LOAD 명령과 같은 방식으로 해석된다. 접속 시작 시점에만 적용되고 이후 변경은 효과가 없으며, 지정한 라이브러리를 찾지 못하면 접속 자체가 실패한다.

누구나 설정할 수 있는 파라미터이기 때문에 로드 가능한 라이브러리는 설치 표준 라이브러리 디렉토리의 plugins 하위 디렉토리($libdir/plugins)에 있는 것으로 제한된다. 그 디렉토리에 안전한 라이브러리만 두는 것은 DBA의 책임이다. 권한 없는 사용자가 PGOPTIONS 환경 변수나 ALTER ROLE ... SET으로 디버깅·성능 측정 라이브러리를 특정 세션에 로드할 수 있게 하려는 기능인데, 모듈이 그런 사용을 염두에 두고 설계된 경우가 아니라면 대개 session_preload_libraries가 더 적절한 선택이다.

출처: PostgreSQL 18 문서