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

보안상의 이유로 수퍼유저와 회원만pg_read_all_stats역할은 SQL 텍스트를 볼 수 있으며쿼리ID19750_19883

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

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

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

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

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

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

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

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

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

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

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

# postgresql.conf
shared_preload_libraries = '토토 결과'

토토 결과.max = 10000
토토 결과.track = 모두

bench=# SELECT 토토 결과_reset();

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

벤치=# \x
벤치=# SELECT 쿼리, 호출, total_time, 행, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          FROM 토토 결과 ORDER BY total_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.5723926698852723
-[ 기록 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_time, 행, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          FROM 토토 결과 ORDER BY total_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.5723926698852723
-[ 기록 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_time, 행, 100.0 * shared_blks_hit /
               nullif(shared_blks_hit + shared_blks_read, 0) AS hit_percent
          FROM 토토 결과 ORDER BY total_time DESC LIMIT 5;
-[ 기록 1 ]----------------------------
쿼리 | 토토 결과_reset(0,0,0) 선택
전화 | 1
총_시간 | 0.189497
행 | 1
hit_percent |

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