모듈에 의해 수집된 통계는 다음 이름의 뷰를 통해 제공됩니다.배트맨 토토. 이 보기에는 데이터베이스 ID, 사용자 ID, 쿼리 ID의 각 고유 조합과 최상위 명령문인지 여부(모듈이 추적할 수 있는 고유 명령문의 최대 개수까지)에 대해 하나의 행이 포함됩니다. 뷰의 열은 다음과 같습니다.표 F.20.

보안상의 이유로 수퍼유저 및 권한이 있는 역할만pg_read_all_stats역할은 SQL 텍스트를 볼 수 있으며쿼리ID28428_28561

계획 가능한 쿼리(즉,선택, 삽입, 업데이트, 삭제및병합)은 단일로 결합됩니다.배트맨 토토내부 해시 계산에 따라 동일한 쿼리 구조를 가질 때마다 항목입니다. 일반적으로 두 쿼리는 쿼리에 나타나는 리터럴 상수 값을 제외하고 의미상 동일한 경우 이 목적에서 동일한 것으로 간주됩니다. 그러나 유틸리티 명령(즉, 다른 모든 명령)은 텍스트 쿼리 문자열을 기준으로 엄격하게 비교됩니다.

쿼리를 다른 쿼리와 일치시키기 위해 상수 값이 무시되면 상수는 다음과 같은 매개변수 기호로 대체됩니다.$1, 에서배트맨 토토디스플레이. 쿼리 텍스트의 나머지 부분은 특정쿼리ID다음과 관련된 해시 값배트맨 토토항목.

어떤 경우에는 눈에 띄게 다른 텍스트가 포함된 쿼리가 단일로 병합될 수 있습니다.배트맨 토토항목. 일반적으로 이는 의미상 동일한 쿼리에 대해서만 발생하지만 해시 충돌로 인해 관련 없는 쿼리가 하나의 항목으로 병합될 가능성이 적습니다. (단, 다른 사용자나 데이터베이스에 속한 쿼리의 경우에는 이런 일이 발생할 수 없습니다.)

이후쿼리ID해시 값은 쿼리의 분석 후 표현에서 계산됩니다. 그 반대도 가능합니다. 동일한 텍스트가 포함된 쿼리가 서로 다른 요소로 인해 다른 의미를 갖는 경우 별도의 항목으로 나타날 수 있습니다.검색_경로설정.

소비자배트맨 토토사용하고 싶을 수도 있음쿼리ID(아마도 다음과 결합하여dbid그리고사용자 ID)을 쿼리 텍스트보다 각 항목에 대해 더 안정적이고 신뢰할 수 있는 식별자로 사용합니다. 그러나 안정성에 대한 보장은 제한적이라는 점을 이해하는 것이 중요합니다.쿼리ID해시 값. 식별자는 분석 후 트리에서 파생되므로 그 값은 무엇보다도 이 표현에 나타나는 내부 객체 식별자의 함수입니다. 이는 직관에 반하는 의미를 갖습니다. 예를 들어,배트맨 토토두 쿼리 실행 사이에 삭제되고 다시 생성된 테이블을 참조하는 경우 명백히 동일한 두 쿼리가 서로 다른 쿼리로 간주됩니다. 해싱 프로세스는 머신 아키텍처와 플랫폼의 다른 측면의 차이에도 민감합니다. 또한 다음과 같이 가정하는 것은 안전하지 않습니다.쿼리ID다음의 주요 버전에서 안정적입니다.포스트그레SQL.

물리적 WAL 재생을 기반으로 복제에 참여하는 두 서버는 동일할 것으로 예상할 수 있습니다.쿼리ID동일한 쿼리에 대한 값입니다. 그러나 논리적 복제 체계는 모든 관련 세부 사항에서 복제본을 동일하게 유지한다고 약속하지 않으므로쿼리ID논리적 복제본 집합에 걸쳐 비용을 누적하는 데 유용한 식별자는 아닙니다. 의심스러운 경우 직접 테스트하는 것이 좋습니다.

일반적으로 다음과 같이 가정할 수 있습니다.쿼리ID값은 부 버전 릴리스 간에 안정적입니다.포스트그레SQL, 인스턴스가 동일한 머신 아키텍처에서 실행되고 있고 카탈로그 메타데이터 세부정보가 일치하는 경우입니다. 호환성은 최후의 수단으로 부 버전 간에만 중단됩니다.

대표 쿼리 텍스트에서 상수를 대체하는 데 사용되는 매개변수 기호는 가장 높은 다음 숫자부터 시작합니다.$n원래 쿼리 텍스트의 매개변수 또는$1아무것도 없었다면. 어떤 경우에는 이 번호 매기기에 영향을 미치는 숨겨진 매개변수 기호가 있을 수 있다는 점은 주목할 가치가 있습니다. 예를 들어,PL/pgSQL숨겨진 매개변수 기호를 사용하여 함수 로컬 변수의 값을 쿼리에 삽입하므로 aPL/pgSQL다음과 같은 진술SELECT i + 1 INTO j다음과 같은 대표 텍스트가 있을 것입니다.선택 i + $2.

대표 쿼리 텍스트는 외부 디스크 파일에 보관되며 공유 메모리를 소비하지 않습니다. 따라서 매우 긴 쿼리 텍스트도 성공적으로 저장할 수 있습니다. 그러나 긴 쿼리 텍스트가 많이 누적되면 외부 파일이 감당할 수 없을 정도로 커질 수 있습니다. 그런 경우의 회복 방법으로,배트맨 토토쿼리 텍스트를 삭제하도록 선택할 수 있으며 그 결과에 있는 모든 기존 항목은배트맨 토토보기에 null이 표시됩니다.질의필드, 각 필드와 관련된 통계쿼리ID보존됩니다. 이런 일이 발생하면 줄이는 것을 고려해 보세요.배트맨 토토.max재발을 방지하기 위해.

계획그리고호출계획 및 실행 통계는 각 종료 단계에서 성공적인 작업에 대해서만 업데이트되므로 항상 일치할 것으로 예상되는 것은 아닙니다. 예를 들어 문이 성공적으로 계획되었지만 실행 단계에서 실패하는 경우 해당 계획 통계만 업데이트됩니다. 캐시된 계획을 사용하여 계획을 건너뛰면 실행 통계만 업데이트됩니다.

통계배트맨 토토모듈 자체는 추적되고 이름이 지정된 보기를 통해 사용할 수 있게 됩니다.배트맨 토토_info. 이 보기에는 단일 행만 포함되어 있습니다. 뷰의 열은 다음과 같습니다.표 F.21.

모듈에는 다음에 비례하는 추가 공유 메모리가 필요합니다.배트맨 토토.max. 이 메모리는 모듈이 로드될 때마다 소비됩니다.배트맨 토토.track다음으로 설정됨없음.

이 매개변수는 다음에서 설정되어야 합니다.postgresql.conf. 일반적인 사용법은 다음과 같습니다:

# postgresql.conf
shared_preload_libraries = '배트맨 토토'

Compute_query_id = 켜짐
배트맨 토토.max = 10000
배트맨 토토.track = 모두

벤치=# SELECT 배트맨 토토_reset();

$ pgbench -i 벤치
$ pgbench -c10 -t300 벤치

벤치=# \x
벤치=# SELECT 쿼리, 호출, total_exec_time, 행, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          배트맨 토토 ORDER BY total_exec_time DESC LIMIT 5;
-[ 기록 1 ]---+------------------------------------------------------------
쿼리 | 업데이트 pgbench_branches SET bbalance = bbalance + $1 WHERE bid = $2
전화 | 3000
총_실행_시간 | 25565.855387
행 | 3000
히트_퍼센트 | 100.0000000000000000
-[ 기록 2 ]---+------------------------------------------------------------
쿼리 | 업데이트 pgbench_tellers SET tbalance = tbalance + $1 WHERE tid = $2
전화 | 3000
총_실행_시간 | 20756.669379
행 | 3000
히트_퍼센트 | 100.0000000000000000
-[ 기록 3 ]---+------------------------------------------------------------
쿼리 | stdin에서 pgbench_accounts 복사
전화 | 1
총_실행_시간 | 291.865911
행 | 100000
히트_퍼센트 | 100.0000000000000000
-[ 기록 4 ]---+------------------------------------------------------------
쿼리 | 업데이트 pgbench_accounts SET abalance = abalance + $1 WHERE 지원 = $2
전화 | 3000
총_실행_시간 | 271.232977
행 | 3000
히트_퍼센트 | 98.8454011741682975
-[ 기록 5 ]---+------------------------------------------------------------
쿼리 | 테이블 변경 pgbench_accounts 기본 키 추가(지원)
전화 | 1
총_실행_시간 | 160.588563
행 | 0
히트_퍼센트 | 100.0000000000000000

벤치=# SELECT 배트맨 토토_reset(0,0,s.queryid) FROM 배트맨 토토 AS s
            WHERE s.query = 'pgbench_branches SET 업데이트 bbalance = bbalance + $1 WHERE bid = $2';

벤치=# SELECT 쿼리, 호출, total_exec_time, 행, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          배트맨 토토 ORDER BY total_exec_time DESC LIMIT 5;
-[ 기록 1 ]---+------------------------------------------------------------
쿼리 | 업데이트 pgbench_tellers SET tbalance = tbalance + $1 WHERE tid = $2
전화 | 3000
총_실행_시간 | 20756.669379
행 | 3000
히트_퍼센트 | 100.0000000000000000
-[ 기록 2 ]---+------------------------------------------------------------
쿼리 | stdin에서 pgbench_accounts 복사
전화 | 1
총_실행_시간 | 291.865911
행 | 100000
히트_퍼센트 | 100.0000000000000000
-[ 기록 3 ]---+------------------------------------------------------------
쿼리 | 업데이트 pgbench_accounts SET abalance = abalance + $1 WHERE 지원 = $2
전화 | 3000
총_실행_시간 | 271.232977
행 | 3000
히트_퍼센트 | 98.8454011741682975
-[ 기록 4 ]---+------------------------------------------------------------
쿼리 | 테이블 변경 pgbench_accounts 기본 키 추가(지원)
전화 | 1
총_실행_시간 | 160.588563
행 | 0
히트_퍼센트 | 100.0000000000000000
-[ 기록 5 ]---+------------------------------------------------------------
쿼리 | 진공 분석 pgbench_accounts
전화 | 1
총_실행_시간 | 136.448116
행 | 0
히트_퍼센트 | 99.9201915403032721

벤치=# SELECT 배트맨 토토_reset(0,0,0);

벤치=# SELECT 쿼리, 호출, total_exec_time, 행, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          배트맨 토토 ORDER BY total_exec_time DESC LIMIT 5;
-[ 기록 1 ]---+-----------------------------------------------------
쿼리 | 배트맨 토토_reset(0,0,0) 선택
전화 | 1
총_실행_시간 | 0.189497
행 | 1
히트_퍼센트 |
-[ 기록 2 ]---+-----------------------------------------​----------------------------
쿼리 | SELECT 쿼리, 호출, total_exec_time, 행, $1 * shared_blks_hit / +
                |                nullif(shared_blks_hit + shared_blks_read, $2) AS hit_percent+
                |           배트맨 토토에서 ORDER BY total_exec_time DESC LIMIT $3
전화 | 0
총_실행_시간 | 0
행 | 0
hit_percent |

이타가키 다카히로<itagaki.takahiro@oss.ntt.co.jp. Peter Geoghegan이 추가한 쿼리 정규화<peter@2ndquadrant.com.