SHOW — 런타임 매개변수의 값 표시

SHOW — 런타임 매개변수의 값 표시

SHOW는 서버의 런타임 매개변수(configuration parameter) 현재 값이나 그 값들을 지정할 설정을 알아보고 싶을 때 쓰는 명령이에요. 말 그대로 "지금 설정이 어떻게 되어 있는지" 보여주는 조회 명령이라 데이터를 바꾸지는 않아요.

출처: PostgreSQL 문서

본문

Synopsis

SHOW name
SHOW ALL

설명 (Description)

SHOW는 런타임 매개변수의 현재 설정을 표시해요. 이 변수들은 SET 문을 사용하거나, postgresql.conf 구성 파일을 편집하거나, PGOPTIONS 환경 변수를 통해(libpq 또는 libpq 기반 애플리케이션을 사용할 때), 혹은 postgres 서버를 시작할 때 커맨드라인 플래그를 통해 설정할 수 있어요. 자세한 내용은 19장을 참고하면 돼요.

매개변수 (Parameters)

name

런타임 매개변수의 이름이에요. 사용 가능한 매개변수는 19장과 SET 참조 페이지에 문서화되어 있어요. 그 외에도 표시는 되지만 설정할 수는 없는 몇 가지 매개변수가 있어요:

SERVER_VERSION

서버의 버전 번호를 보여줘요. SERVER_ENCODING

서버 측 문자 집합 인코딩을 보여줘요. 현재는 이 매개변수를 표시할 수는 있지만 설정할 수는 없어요. 인코딩은 데이터베이스 생성 시점에 결정되기 때문이에요. IS_SUPERUSER

현재 역할(role)이 수퍼유저 권한을 가졌다면 참(true)이에요. ALL

설명과 함께 모든 구성 매개변수의 값을 보여줘요.

참고 (Notes)

current_setting 함수는 동일한 출력을 만들어 내요. 9.28.1절을 참고하면 돼요. 또한 pg_settings 시스템 뷰도 같은 정보를 제공해요.

예시 (Examples)

매개변수 DateStyle의 현재 설정을 보여줘요:

SHOW DateStyle;
 DateStyle
-----------
 ISO, MDY
(1 row)

매개변수 geqo의 현재 설정을 보여줘요:

SHOW geqo;
 geqo
------
 on
(1 row)

모든 설정을 보여줘요:

SHOW ALL;
            name         | setting |                description
-------------------------+---------+-------------------------------------------------
 allow_system_table_mods | off     | Allows modifications of the structure of ...
    .
    .
    .
 xmloption               | content | Sets whether XML data in implicit parsing ...
 zero_damaged_pages      | off     | Continues processing past damaged page headers.
(196 rows)

호환성 (Compatibility)

SHOW 명령은 PostgreSQL 확장이에요.

더 알아보기 (Learn more)

  • 런타임 매개변수의 값을 변경하는 SET 명령과 짝을 이뤄요.
  • 전체 설정 매개변수 목록은 19장(서버 구성)에서 확인할 수 있어요.
  • pg_settings 시스템 뷰와 current_setting() 함수도 같은 정보를 제공해요.