모듈에 의해 수집 된 통계는이라는 뷰를 통해 제공됩니다.무지개 토토. 이보기에는 각각의 별개의 데이터베이스 ID, 사용자 ID 및 쿼리 ID에 대해 하나의 행이 포함됩니다 (모듈이 추적 할 수있는 최대의 별개의 명령문 수까지). 보기의 열은에 표시됩니다.테이블 F.21.

보안상의 이유로, 슈퍼업자와 회원 만PG_READ_ALL_STATS역할은 SQL 텍스트를 볼 수 있습니다.QueryId다른 사용자가 실행 한 쿼리. 그러나 다른 사용자는 데이터베이스에보기가 설치된 경우 통계를 볼 수 있습니다.

Plannable Queries (즉,select, 삽입, 업데이트및삭제)는 단일로 결합됩니다무지개 토토내부 해시 계산에 따라 동일한 쿼리 구조가있을 때마다 항목. 일반적으로 쿼리에 나타나는 문자 상수의 값을 제외하고 의미 적으로 동등한 경우 두 쿼리 가이 목적에 대해 동일하게 간주됩니다. 유틸리티 명령 (즉, 다른 모든 명령)은 텍스트 쿼리 문자열을 기반으로 엄격하게 비교됩니다.

쿼리를 다른 쿼리와 일치시키기 위해 상수의 값이 무시되면 상수는와 같은 매개 변수 기호로 대체됩니다.$ 1, in무지개 토토디스플레이. 나머지 쿼리 텍스트는 특정 쿼리의 쿼리입니다.QueryId와 관련된 해시 값무지개 토토Entry.

경우에 따라 텍스트가 눈에 띄게 다른 쿼리가 단일로 병합 될 수 있습니다무지개 토토입력. 일반적으로 이것은 의미 적으로 동등한 쿼리에 대해서만 발생하지만 해시 충돌 가능성은 적어 관련없는 쿼리가 하나의 항목으로 병합 될 수 있습니다. (그러나 다른 사용자 또는 데이터베이스에 속하는 쿼리에는 발생할 수 없습니다.)

이후QueryId해시 값은 쿼리의 패스 분석 후 표현에서 계산됩니다. 반대도 가능합니다. 동일한 텍스트가있는 쿼리는 별도의 항목으로 나타날 수 있습니다.search_path설정.

소비자무지개 토토사용하기를 원할 수 있습니다QueryId(아마도dbidanduserId) 쿼리 텍스트보다 각 항목에 대해보다 안정적이고 신뢰할 수있는 식별자로서. 그러나의 안정성에 대한 보장이 제한되어 있음을 이해하는 것이 중요합니다.QueryId해시 값. 식별자는 패스트리 분석 후 트리에서 파생되므로 그 값은 무엇 보다도이 표현에 나타나는 내부 객체 식별자의 함수입니다. 이것은 반 직관적 인 영향을 미칩니다. 예를 들어,무지개 토토두 쿼리의 실행 사이에 삭제되고 재현 된 테이블을 참조하면 두 개의 명백한 동일 쿼리가 뚜렷하다고 생각합니다. 해싱 프로세스는 또한 기계 아키텍처 및 플랫폼의 다른 측면의 차이에 민감합니다. 또한, 가정하는 것은 안전하지 않습니다.QueryId의 주요 버전에서 안정적입니다PostgreSQL.

물리적 WAL 재생을 기반으로 복제에 참여하는 두 서버가 동일 할 수 있습니다QueryId동일한 쿼리의 값. 그러나 논리적 복제 체계는 모든 관련 세부 사항에서 복제본을 동일하게 유지하겠다고 약속하지 않으므로QueryId는 일련의 논리적 복제품에서 비용을 축적하는 데 유용한 식별자가 아닙니다. 의심스러운 경우 직접 테스트를 권장합니다.

일반적으로 가정 할 수 있습니다.QueryId값은 마이너 버전 릴리스 사이에서 안정적입니다PostgreSQL, 인스턴스가 동일한 기계 아키텍처에서 실행되고 카탈로그 메타 데이터 세부 사항이 일치하도록 제공합니다. 호환성은 최후의 수단으로서 마이너 버전 사이에서만 끊어집니다.

대표 쿼리 텍스트의 상수를 대체하는 데 사용되는 매개 변수 기호는 다음 숫자에서 가장 높은 다음 숫자에서 시작합니다$n원래 쿼리 텍스트의 매개 변수 또는$ 1없는 경우. 어떤 경우에는이 번호에 영향을 미치는 숨겨진 매개 변수 기호가있을 수 있습니다. 예를 들어,pl/pgsql숨겨진 매개 변수 기호를 사용하여 함수 로컬 변수 값을 쿼리에 삽입하여 APL/PGSQL문장 같은 진술i + 1을 J로 선택하십시오선택 i + $ 2.

대표 쿼리 텍스트는 외부 디스크 파일에 보관되어 공유 메모리를 소비하지 않습니다. 따라서 매우 긴 쿼리 텍스트조차도 성공적으로 저장할 수 있습니다. 그러나 많은 긴 쿼리 텍스트가 축적되면 외부 파일이 무의식적으로 커질 수 있습니다. 그런 경우 복구 방법으로무지개 토토쿼리 텍스트를 버릴 수 있습니다.무지개 토토보기가 표시됩니다쿼리필드, 각각의 통계는 각각QueryId보존됩니다. 이런 일이 발생하면 감소를 고려하십시오무지개 토토.max재발을 방지합니다.

계획and전화계획 및 실행 통계가 각각의 종료 단계에서 업데이트되며 성공적인 운영에 대해서만 업데이트되기 때문에 항상 일치 할 것으로 예상되는 것은 아닙니다. 예를 들어, 명세서가 성공적으로 계획되었지만 실행 단계에서 실패하면 계획 통계 만 업데이트됩니다. 캐시 된 계획이 사용되어 계획이 건너 뜁니다. 실행 통계 만 업데이트됩니다.

모듈에는에 비례하여 추가 공유 메모리가 필요합니다.무지개 토토.max. 이 메모리는 모듈이로드 될 때마다 소비됩니다.무지개 토토.track로 설정되었습니다없음.

이 매개 변수를 설정해야합니다postgresql.conf. 일반적인 사용법은 다음과 같습니다.

# postgresql.conf
shared_preload_libraries = '무지개 토토'

무지개 토토.max = 10000
무지개 토토.track = all

벤치 =# 선택 PG_STAT_STATEMENTS_RESET ();

$ pgbench -i 벤치
$ PGBENCH -C10 -T300 벤치

벤치 =# \ x
벤치 =# 쿼리 선택, 통화, total_exec_time, 행, 100.0 * shared_blks_hit /
               nullif (shared_blks_hit + shared_blks_read, 0) hit_percent
          PG_STAT_STATEMENTS에서 TOTAL_EXEC_TIME DESC LIMIT 5에 의해 주문됩니다.
-[레코드 1] ---+-------------------------------------------------------------------
쿼리 | pgbench_branches 업데이트 bbalance = bbalance + $ 1 bid = $ 2
전화 | 3000
Total_exec_time | 25565.855387
줄 | 3000
hit_percent | 100.0000000000000000
-[레코드 2] ---+-------------------------------------------------------------------
쿼리 | PGBENCH_TELLERS 업데이트 TBALANCE = TBALANCE + $ 1 여기서 tid = $ 2
전화 | 3000
Total_exec_time | 20756.669379
줄 | 3000
hit_percent | 100.0000000000000000
-[레코드 3] ---+---------------------------------------------------------------------
쿼리 | stdin에서 pgbench_accounts를 복사하십시오
전화 | 1
Total_exec_time | 291.865911
줄 | 100000
hit_percent | 100.0000000000000000
-[레코드 4] ---+--------------------------------------------------------------------
쿼리 | PGBENCH_ACCOUNTS 업데이트 세트 Abalance = Abalance + $ 1 Aid = $ 2
전화 | 3000
Total_exec_time | 271.232977
줄 | 3000
hit_percent | 98.8454011741682975
-[레코드 5] ---+------------------------------------------------------------------
쿼리 | ALTER TABLE PGBENCH_ACCOUTTS 기본 키 추가 (AID)
전화 | 1
Total_exec_time | 160.588563
줄 | 0
hit_percent | 100.0000000000000000

벤치 =# 무지개 토토에서 s로 무지개 토토_reset (0,0, s.queryid)을 선택하십시오
            여기서 s.query = '업데이트 pgbench_branches는 bbalance = bbalance + $ 1 여기서 bid = $ 2';

벤치 =# 쿼리 선택, 통화, total_exec_time, 행, 100.0 * shared_blks_hit /
               nullif (shared_blks_hit + shared_blks_read, 0) hit_percent
          PG_STAT_STATEMENTS에서 TOTAL_EXEC_TIME DESC LIMIT 5에 의해 주문됩니다.
-[레코드 1] ---+-------------------------------------------------------------------
쿼리 | PGBENCH_TELLERS 업데이트 TBALANCE = TBALANCE + $ 1 여기서 tid = $ 2
전화 | 3000
Total_exec_time | 20756.669379
줄 | 3000
hit_percent | 100.0000000000000000
-[레코드 2] ---+-------------------------------------------------------------------
쿼리 | stdin에서 pgbench_accounts를 복사하십시오
전화 | 1
Total_exec_time | 291.865911
줄 | 100000
hit_percent | 100.0000000000000000
-[레코드 3] ---+---------------------------------------------------------------------
쿼리 | PGBENCH_ACCOUNTS 업데이트 세트 Abalance = Abalance + $ 1 Aid = $ 2
전화 | 3000
Total_exec_time | 271.232977
줄 | 3000
hit_percent | 98.8454011741682975
-[레코드 4] ---+--------------------------------------------------------------------
쿼리 | ALTER TABLE PGBENCH_ACCOUTTS 기본 키 추가 (AID)
전화 | 1
Total_exec_time | 160.588563
줄 | 0
hit_percent | 100.0000000000000000
-[레코드 5] ---+------------------------------------------------------------------
쿼리 | 진공 분석 PGBENCH_ACCOUTTS
전화 | 1
Total_exec_time | 136.448116
줄 | 0
hit_percent | 99.9201915403032721

벤치 =# 선택 PG_STAT_STATEMENTS_RESET (0,0,0);

벤치 =# 쿼리 선택, 통화, total_exec_time, 행, 100.0 * shared_blks_hit /
               nullif (shared_blks_hit + shared_blks_read, 0) hit_percent
          PG_STAT_STATEMENTS에서 TOTAL_EXEC_TIME DESC LIMIT 5에 의해 주문됩니다.
-[레코드 1] ---+---------------------------------------------------------------------------
쿼리 | PG_STAT_STATEMENTS_RESET을 선택하십시오 (0,0,0)
전화 | 1
Total_exec_time | 0.189497
줄 | 1
hit_percent | 
-[레코드 2] ---+---------------------------------------------------------------------------
쿼리 | 선택 쿼리, 통화, Total_exec_time, 행, $ 1 * shared_blks_hit / +
                |                nullif (shared_blks_hit + shared_blks_read, $ 2) hit_percent +
                |           PG_STAT_STATEMENTS에서 TOTAL_EXEC_TIME DESC LIMIT $ 3
전화 | 0
Total_exec_time | 0
줄 | 0
hit_percent |

Takahiro Itagaki<itagaki.takahiro@oss.ntt.co.jp. Peter Geoghegan에 의해 추가 된 쿼리 정규화<peter@2ndquadrant.com.