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

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

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

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

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

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

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

경험상QueryId값은 기본 서버 버전과 카탈로그 메타 데이터 세부 정보가 정확히 동일하게 유지되는 한 안정적이고 비교할 수 있다고 가정 할 수 있습니다. 물리적 WAL 리플레이를 기반으로 복제에 참여하는 두 개의 서버가 동일 할 수 있습니다QueryId동일한 쿼리의 값. 그러나 논리적 복제 체계는 모든 관련 세부 사항에서 복제본을 동일하게 유지하겠다고 약속하지 않으므로QueryId일련의 논리적 복제품에 걸쳐 비용을 축적하는 데 유용한 식별자가 아닙니다. 의심스러운 경우 직접 테스트를 권장합니다.

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

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

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

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

# postgresql.conf
shared_preload_libraries = '범퍼카 토토'

범퍼카 토토.max = 10000
범퍼카 토토.track = all

벤치 =# 선택 범퍼카 토토_reset ();

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

벤치 =# \ x
벤치 =# 선택 쿼리, 통화, Total_Time, 행, 100.0 * shared_blks_hit /
               nullif (shared_blks_hit + shared_blks_read, 0) hit_percent
          PG_STAT_STATEMENTS에서 TOTAL_TIME DESC LIMIT 5에 의한 순서 5;
-[레코드 1] ----------------------------------------------------------------------
쿼리 | pgbench_branches 업데이트 bbalance = bbalance + $ 1 여기서 bid = $ 2;
전화 | 3000
Total_Time | 9609.00100000002
줄 | 2836
hit_percent | 99.9778970000200936
-[레코드 2] -------------------------------------------------------------------------------
쿼리 | PGBENCH_TELLERS 업데이트 TBALANCE = TBALANCE + $ 1 여기서 tid = $ 2;
전화 | 3000
Total_Time | 8015.156
줄 | 2990
hit_percent | 99.9731126579631345
-[레코드 3] ---------------------------------------------------------------------
쿼리 | stdin에서 pgbench_accounts를 복사하십시오
전화 | 1
Total_Time | 310.624
줄 | 100000
hit_percent | 0.30395136778115501520
-[레코드 4] -------------------------------------------------------------------------------
쿼리 | PGBENCH_ACCOUNTS 업데이트 세트 Abalance = Abalance + $ 1 여기서 AID = $ 2;
전화 | 3000
Total_Time | 271.74199999997
줄 | 3000
hit_percent | 93.7968855088209426
-[레코드 5] -------------------------------------------------------------------------------
쿼리 | ALTER TABLE PGBENCH_ACCOUTTS 기본 키 추가 (AID)
전화 | 1
Total_Time | 81.42
줄 | 0
hit_percent | 34.4947735191637631

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