F.30. 토토 사이트 - SQL 계획 및 실행의 통계 추적#

the토토 사이트모듈은 서버에서 실행 한 모든 SQL 문의 계획 및 실행 통계 추적 수단을 제공합니다.

추가하여 모듈을로드해야합니다토토 사이트toshared_preload_librariesinon, 추가 공유 메모리가 필요하기 때문입니다. 이는 모듈을 추가하거나 제거하기 위해 서버 재시작이 필요하다는 것을 의미합니다.compute_query_id로 설정되었습니다auto또는on또는 쿼리 식별자를 계산하는 타사 모듈이로드되었습니다.

언제토토 사이트활성화되어 서버의 모든 데이터베이스에서 통계를 추적합니다. 이러한 통계에 액세스하고 조작하기 위해 모듈은보기를 제공합니다토토 사이트and토토 사이트_info및 유틸리티 함수토토 사이트_resetand토토 사이트. 이들은 전 세계적으로 사용할 수 없지만의 특정 데이터베이스에 대해 활성화 할 수 있습니다.확장 생성 토토 사이트.

F.30.1. 그만큼토토 사이트보기#

모듈에 의해 수집 된 통계는 이름을 통해 제공됩니다.토토 사이트. 이보기에는 데이터베이스 ID, 사용자 ID, 쿼리 ID와 최상위 문장인지 여부의 각각의 별개의 조합에 대해 하나의 행이 포함되어 있습니다 (모듈이 추적 할 수있는 최대 수의 고유 한 명령문까지).테이블 F.21.

표 F.21. 토토 사이트

열 유형

설명

userID OID(참조pg_authid.OID)

진술을 실행 한 사용자의 OID

dbid OID(참조pg_database.OID)

진술이 실행 된 데이터베이스의 OID

toplevel bool

쿼리가 최상위 명령문으로 실행 된 경우 true (항상 true if토토 사이트로 설정되었습니다TOP)

QueryId bigint

동일한 정규화 된 쿼리를 식별하는 해시 코드.

쿼리 텍스트

대표 성명서의 텍스트

계획 bigint

성명서가 계획된 횟수 (if토토 사이트.track_planning활성화되어 있습니다. 그렇지 않으면 0)

Total_plan_time 이중 정밀

성명서를 계획하는 데 소요되는 총 시간 (if토토 사이트.track_planning활성화되어 있습니다. 그렇지 않으면 0)

min_plan_time 이중 정밀

진술을 계획하는 최소 시간, 밀리 초. 이 필드는 0이면토토 사이트.track_planning토토 사이트_resetminmax_only매개 변수 설정true이후로 계획되지 않았습니다.

max_plan_time 이중 정밀

진술을 계획하는 최대 시간, 밀리 초. 이 필드는 0이면토토 사이트.track_planning토토 사이트_resetminmax_only매개 변수 설정true이후로 계획되지 않았습니다.

Mean_Plan_Time 이중 정밀

진술을 계획하는 평균 시간, 진술을 밀리 초 단위로 사용했습니다 (if토토 사이트.track_planning활성화되어 있습니다. 그렇지 않으면 0)

stddev_plan_time 이중 정밀

인구 표준 시간의 시간 편차는 진술을 계획하는 데 소요 된 시간 편차 (if토토 사이트.track_planning활성화되어 있습니다. 그렇지 않으면 0)

전화 bigint

성명서가 실행 된 횟수

Total_exec_time 이중 정밀

진술을 실행하는 데 소요되는 총 시간, 밀리 초

min_exec_time 이중 정밀

명령문을 실행하는 데 소비 된 최소 시간, 밀리 초로이 필드는이 명세서가 처음 실행 된 후 처음으로 실행될 때까지 0이됩니다토토 사이트_resetminmax_only매개 변수 설정true

max_exec_time 이중 정밀

명령문을 실행하는 데 소요되는 최대 시간, 밀리 초 내 에서이 필드는이 명세서가 처음 실행 된 후 처음으로 실행될 때까지 0이됩니다.토토 사이트_resetminmax_only매개 변수 설정true

Mean_Exec_Time 이중 정밀

진술을 실행하는 데 소요되는 평균 시간, 밀리 초

stddev_exec_time 이중 정밀

인구 표준 진술을 실행하는 데 소요되는 시간의 인구 표준 편차, milliseconds

bigint

성명서에 의해 검색되거나 영향을받는 총 행 수

shared_blks_hit bigint

문의 공유 블록 캐시의 총 수

shared_blks_read bigint

성명서에 의해 읽은 총 공유 블록 수

shared_blks_dirtied bigint

성명서에 의해 더러워진 총 공유 블록의 총 수

shared_blks_written bigint

성명서에 의해 작성된 총 공유 블록 수

local_blks_hit bigint

성명서별 로컬 블록 캐시의 총 수치

local_blks_read bigint

성명서에 의해 읽은 총계 블록 수

local_blks_dirtied bigint

성명서에 의해 더러워진 총 지역 블록의 총 수

local_blks_written bigint

성명서에 의해 작성된 총계 블록 수

temp_blks_read bigint

진술서에 의해 읽는 총 임시 블록 수

temp_blks_written bigint

문에 의해 작성된 총 임시 블록 수

shared_blk_read_time 이중 정밀

성명서가 공유 블록을 읽는 데 소비 된 총 시간 (iftrack_io_timing활성화되어 있습니다. 그렇지 않으면 0)

shared_blk_write_time 이중 정밀

성명서가 공유 블록을 쓰는 데 소비 된 총 시간 (iftrack_io_timing활성화되어 있습니다. 그렇지 않으면 0)

local_blk_read_time 이중 정밀

성명서가 현지 블록을 읽는 데 소비 된 총 시간 (iftrack_io_timing활성화되어 있습니다. 그렇지 않으면 0)

local_blk_write_time 이중 정밀

성명서가 현지 블록을 작성하는 데 소비 된 총 시간 (iftrack_io_timing활성화되어 있습니다. 그렇지 않으면 0)

temp_blk_read_time 이중 정밀

성명서가 임시 파일 블록을 읽는 데 소비 된 총 시간 (iftrack_io_timing활성화되어 있습니다. 그렇지 않으면 0)

temp_blk_write_time 이중 정밀

성명서가 임시 파일 블록을 작성하는 데 소요되는 총 시간 (iftrack_io_timing활성화되어 있습니다. 그렇지 않으면 0)

Wal_records bigint

명세서에 의해 생성 된 WAL 레코드의 총 수

Wal_FPI bigint

문에 의해 생성 된 WAL 전체 페이지 이미지의 총 수

Wal_Bytes 숫자

바이트의 명령문에 의해 생성 된 WAL의 총 금액

JIT_FINCTIONS bigint

성명서에 의해 정리 된 총 함수 수

jit_generation_time 이중 정밀

Milliseconds의 JIT 코드 생성에 대한 명세서에 의해 소비 된 총 시간

jit_inlining_count bigint

함수가 상환되었습니다

jit_inlining_time 이중 정밀

밀리 초의 성명서에 대한 진술에 의해 소비 된 총 시간

jit_optimization_count bigint

진술이 최적화 된 횟수

jit_optimization_time 이중 정밀

진술서에 의해 지출 된 총 시간, 밀리 초의 최적화

jit_emission_count bigint

코드 수가 방출되었습니다

jit_emission_time 이중 정밀

방출 코드에 대한 명세서에 의해 소비 된 총 시간, 밀리 초

jit_deform_count bigint

튜플 변형 함수의 총 수 성명서에 의해 고환

jit_deform_time 이중 정밀

JIT 컴파일 튜플 변형 함수에 대한 진술에 의해 소비 된 총 시간

stats_since 시간대가있는 타임 스탬프

이 진술에 대한 통계 수집이 시작된 시간

minmax_stats_since 시간대가있는 타임 스탬프

이 진술을 위해 최소/최대 통계 수집이 시작된 시간 (필드min_plan_time, max_plan_time, min_exec_timeandmax_exec_time)


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

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

Note

지속적인 교체 및에 대한 다음 세부 사항QueryId만 적용compute_query_id가 활성화되었습니다. 대신 외부 모듈을 사용하여 계산하는 경우QueryId, 자세한 내용은 해당 문서를 참조해야합니다.

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

정규화를 적용 할 수있는 쿼리는 일정한 값으로 관찰 될 수 있습니다토토 사이트, 특히 높은 입력 거래가있을 때. 이런 일이 발생할 가능성을 줄이려면 증가하는 것을 고려하십시오토토 사이트. 그만큼토토 사이트_info보기, 아래에서 논의섹션 F.30.2, 입력 거래에 대한 통계를 제공합니다.

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

이후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보존됩니다. 이런 일이 발생하면 감소를 고려하십시오토토 사이트재발을 방지하기 위해.

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

F.30.2. 그만큼토토 사이트_info보기#

통계토토 사이트모듈 자체가 추적되어 이름이 지정된보기를 통해 사용할 수 있습니다토토 사이트_info. 이보기에는 단일 행 만 포함됩니다.표 F.22.

표 F.22. 토토 사이트_info

열 유형

설명

Dealloc bigint

총 시간토토 사이트최소 행사 진술에 관한 항목은보다 더 뚜렷한 진술이기 때문에 처리되었습니다.토토 사이트관찰되었습니다

stats_reset 시간대가있는 타임 스탬프

토토 사이트보기가 마지막 재설정되었습니다.


F.30.3. 기능#

PG_STAT_STATEMENTS_RESET (userID OID, DBID OID, QUERYID BIGINT, MINMAX_ONLY BOOLEAN) 시간대와 함께 타임 스탬프를 반환

토토 사이트_reset지금까지 수집 한 통계 폐기토토 사이트지정된 사람에 해당userID, dbidandQueryId. 매개 변수가 지정되지 않은 경우 기본값0(유효하지 않은) 각각에 사용되며 다른 매개 변수와 일치하는 통계가 재설정됩니다. 매개 변수가 지정되지 않았거나 지정된 모든 매개 변수가0(유효하지 않음) 모든 통계를 폐기합니다. 의 모든 통계가있는 경우토토 사이트보기가 폐기되면의 통계도 재설정됩니다.토토 사이트_info보기. 언제minmax_onlyistrue최소 및 최대 계획 및 실행 시간의 값 만 재설정됩니다 (예 :min_plan_time, max_plan_time, min_exec_timeandmax_exec_time필드). 의 기본값minmax_only매개 변수는거짓. 수행 된 마지막 최소/최대 재설정의 시간에 표시됩니다minmax_stats_since필드토토 사이트보기. 이 함수는 재설정 시간을 반환합니다.stats_reset필드토토 사이트_info보기 또는 tominmax_stats_since필드토토 사이트해당 재설정이 실제로 수행 된 경우보기. 기본적 으로이 기능은 슈퍼 사용자 만으로만 실행할 수 있습니다.그랜트.

토토 사이트 (ShowText Boolean) 레코드를 반환

the토토 사이트보기가 지명 된 함수 측면에서 정의됩니다토토 사이트. 고객이 전화를 걸 수 있습니다토토 사이트직접 기능하고 지정하여showtext : = false쿼리 텍스트를 생략하십시오 (즉,out보기에 해당하는 인수쿼리열이 널을 반환합니다). 이 기능은 불확실한 길이의 쿼리 텍스트를 반복적으로 검색하는 오버 헤드를 피할 수있는 외부 도구를 지원하기위한 것입니다.토토 사이트자체는 필요에 따라 쿼리 텍스트를 검색합니다. 서버는 파일에 쿼리 텍스트를 저장하기 때문에이 접근법은 물리적 I/O를 반복적으로 조사하기 위해를 줄일 수 있습니다.토토 사이트데이터.

F.30.4. 구성 매개 변수#

토토 사이트 (정수)

토토 사이트모듈에서 추적하는 최대 명령문 수입니다 (즉,의 최대 행 수토토 사이트보기). 그보다 더 뚜렷한 진술이 관찰되면, 가장 잘 수행되지 않은 진술에 대한 정보는 폐기됩니다.토토 사이트_info보기. 기본값은 5000입니다.이 매개 변수는 서버 시작시에만 설정할 수 있습니다.

토토 사이트 (enum)

토토 사이트모듈에 의해 계산되는 진술서를 제어합니다. 지정TOP최상위 진술을 추적하려면 (고객이 직접 발행 한 것),all중첩 된 진술 (예 : 함수 내에서 호출 된 진술) 또는도 추적합니다.없음명령문 통계 수집을 비활성화하려면. 기본값은입니다.TOP. 수퍼 유저만이 설정을 변경할 수 있습니다.

토토 사이트.track_utility (부울)

토토 사이트.track_utility모듈에서 유틸리티 명령을 추적하는지 여부를 제어합니다. 유틸리티 명령은 이외의 모든 명령입니다.select, 삽입, 업데이트, 삭제병합. 기본값은입니다.on. 수퍼 유저만이 설정을 변경할 수 있습니다.

토토 사이트.track_planning (부울)

토토 사이트.track_planning모듈에 의해 계획 운영 및 기간이 추적되는지 여부를 제어합니다. 이 매개 변수를 활성화하면 특히 동일한 쿼리 구조가있는 명령문이 소수의 숫자를 업데이트하기 위해 경쟁하는 많은 동시 연결에 의해 실행될 때 눈에 띄는 성능 페널티가 발생할 수 있습니다.토토 사이트항목. 기본값은입니다.OFF. 수퍼 유저만이 설정을 변경할 수 있습니다.

토토 사이트 (부울)

토토 사이트서버 종료에서 명령문 통계를 저장할지 여부를 지정합니다. 경우OFF그런 다음 통계는 종료시 저장되지 않거나 서버 시작시 다시로드되지 않습니다. 기본값은입니다.on. 이 매개 변수는에서만 설정할 수 있습니다.on파일 또는 서버 명령 줄에.

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

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

# postgresql.confshared_preload_libraries = '토토 사이트'

F.30.5. 샘플 출력#

벤치 =# 선택 토토 사이트_RESET ();$ pgbench -i 벤치

F.30.6. 저자#

Takahiro Itagaki. Peter Geoghegan에 의해 추가 된 쿼리 정규화.

수정 제출

문서에 올바른 것이없는 것이 있으면 일치하지 않습니다. 특정 기능에 대한 귀하의 경험 또는 추가 설명이 필요합니다.이 양식문서 문제를보고하려면