"ERROR: <module/extension> must be loaded via shared_preload_libraries" 오류를 해결하려면 어떻게 해야 합니까?

최종 업데이트 날짜: 2020년 6월 17일

PostgreSQL DB 인스턴스에 대한 Amazon Relational Database Service(Amazon RDS)가 있습니다. "ERROR:  <module/extension> must be loaded via shared_preload_libraries" 오류가 발생했습니다. 이 오류를 해결하려면 어떻게 해야 합니까?

간략한 설명

Amazon RDS for PostgreSQL을 사용하는 경우 공유 라이브러리를 서버에 미리 로드하면 추가 가능을 로드하거나 성능상의 이점을 얻을 수 있습니다. 그러나 모듈/확장을 사용하려고 할 때 다음 오류가 발생할 수 있습니다. 

  • "ERROR:  <module/extension> must be loaded via shared_preload_libraries"

예를 들어 pg_stat_statements 쿼리를 실행할 때 다음 오류가 발생할 수 있습니다.

postgres=> SELECT * FROM pg_stat_statements;
ERROR:  relation "pg_stat_statements" does not exist
postgres=> CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
CREATE EXTENSION
 
postgres=> SELECT * FROM pg_stat_statements;
ERROR:  pg_stat_statements must be loaded via shared_preload_libraries

이 오류를 해결하고 pg_stat_statements 쿼리를 실행하려면 DB 인스턴스에 연결된 사용자 지정 파라미터 그룹에서 shared_preload_libraries 값을 pg_stat_statements로 설정합니다.

사용자 지정 파라미터 그룹에서 파라미터 shared_preload_libraries 값을 수정하여 RDS PostgreSQL에서 다음 모듈/확장을 사용할 수 있습니다.

  • auto_explain
  • orafce
  • pgaudit
  • pglogical
  • pg_hint_plan
  • pg_prewarm
  • pg_similarity
  • pg_stat_statements
  • pg_transport
  • plprofiler

참고: 사용자 지정 파라미터 그룹의 파라미터 값을 수정할 수 있습니다. 기본 DB 파라미터 그룹의 파라미터 값은 변경할 수 없습니다. 사용자 지정 파라미터 그룹의 파라미터를 변경하면 해당 파라미터 그룹에 연결된 모든 DB 인스턴스에 변경 사항이 적용됩니다.

해결 방법

사용자 지정 파라미터 그룹 생성

참고: 사용자 지정 파라미터 그룹이 이미 있는 경우 다음 단계로 건너뜁니다.

  1. Amazon RDS 콘솔에 로그인합니다.
  2. 탐색 창에서 [파라미터 그룹]을 선택합니다.
  3. [파라미터 그룹 생성]을 선택합니다.
  4. [파라미터 그룹 패밀리 목록]에서 [DB 파라미터 그룹 패밀리를 선택합니다.
  5. [그룹 이름] 상자에 새 DB 파라미터 그룹 이름을 입력합니다.
  6. [설명] 상자에 새 DB 파라미터 그룹의 설명을 입력합니다.
  7. [생성]을 선택합니다.

사용자 지정 파라미터 그룹에서 파라미터 수정

  1. Amazon RDS 콘솔에 로그인합니다.
  2. 탐색 창에서 [파라미터 그룹]을 선택합니다.
  3. 목록에서 수정할 파라미터 그룹을 선택합니다.
  4. [파라미터 그룹 작업]에서 [편집]을 선택합니다.
  5. shared_preload_libraries 파라미터의 값을 변경합니다.
  6. [변경 사항 저장]을 선택합니다.

참고: shared_preload_libraries 파라미터는 정적 파라미터입니다. 정적 파라미터를 변경하고 DB 파라미터 그룹을 저장하면 DB 인스턴스를 수동으로 재부팅한 후 파라미터 변경 사항이 적용됩니다.

파라미터 그룹을 DB 인스턴스에 연결

참고: 사용자 지정 파라미터 그룹이 이미 DB 인스턴스에 연결되어 있는 경우 다음 단계로 건너뜁니다.

DB 인스턴스를 수정하여 사용자 지정 파라미터 그룹을 DB 인스턴스에 연결합니다.

DB 인스턴스 재부팅

정적 파라미터를 변경하고 DB 파라미터 그룹을 저장하면 DB 인스턴스를 수동으로 재부팅한 후 파라미터 변경 사항이 적용됩니다.

DB 인스턴스에 연결된 DB 파라미터 그룹을 변경할 때는 DB 인스턴스에 새 DB 파라미터 그룹을 사용하기 전에 DB 인스턴스를 수동으로 재부팅해야 합니다.

Amazon RDS 콘솔을 사용하거나 RebootDBInstance API 작업을 명시적으로 호출하여 DB 인스턴스를 재부팅합니다(DB 인스턴스가 다중 AZ 배포에 있는 경우 장애 조치 사용 안 함).


pg_stat_statements에 대한 PostgreSQL 설명서

DB 파라미터 그룹 작업

이 문서가 도움이 되었습니까?

AWS에서 개선해야 할 부분이 있습니까?


도움이 필요하십니까?