메인 콘텐츠로 건너뛰기
이 페이지의 기능은 미리보기 단계입니다. API는 안정적이지 않으며, 이 기능을 선언하는 확장 프로그램은 설치 시 vsql_allow_preview_extensions = ON이 필요합니다. 미리보기 계층을 활성화하고 기능을 등록하는 방법은 미리보기 기능을 참조하세요. 문 이벤트 기능(vsql::preview::statement_event)은 각 쿼리 실행이 완료된 후 확장 프로그램이 제공한 핸들러를 실행합니다. 서버는 쿼리 자체의 스레드에서 핸들러를 동기적으로 호출하고 실행 메타데이터 — 쿼리 텍스트, 타이밍, 행 개수, 연결 식별 정보, 그리고 옵티마이저 품질 지표를 전달합니다. 느린 쿼리 로깅, 감사 또는 메트릭 수집에 사용하세요. 기능 이름 VEF_PREVIEW_STATEMENT_EVENT_NAME은 "vsql::preview::statement_event"입니다.

기능 선언

파일 범위에서 발동 단계와 핸들러 함수로 인스턴스화된 StatementEventCapability을 선언하고 .with()에 전달합니다:
첫 번째 템플릿 인수는 발동 단계이며, vef_statement_event_phase_t 값입니다. VEF_STATEMENT_EVENT_POSTEXECUTE는 쿼리 실행이 완료된 후 성공 또는 실패와 관계없이 발동하며, 이 버전에서 구현된 유일한 단계입니다. 다른 vef_statement_event_phase_t 값은 예약되어 있으며, 그중 하나에 대한 핸들러를 선언하면 서버가 INSTALL EXTENSION을 거부합니다.

핸들러 인수

StatementEventArgs는 완료된 쿼리의 읽기 전용 뷰입니다. POSTEXECUTE 단계에서는 모든 필드가 채워져 있습니다. 주요 접근자: query()는 재작성된 형태가 존재하는 경우 그것을 반환하므로, 자격 증명을 담은 문은 일반 로그와 슬로우 쿼리 로그가 이미 민감 정보를 가리는 방식과 일치하게 비밀이 평문이 아닌 난독화된 상태로 도착합니다: SET PASSWORD, CREATE/ALTER USER ... IDENTIFIED BY, CHANGE REPLICATION SOURCE ... SOURCE_PASSWORD, 그리고 CREATE SERVER ... OPTIONS(PASSWORD ...). 재작성 규칙이 없는 문은 그대로 전달됩니다. query(), sqlstate(), error_message()와 같은 문자열 접근자는 핸들러 호출 기간 동안만 유효한 저장소를 가리킵니다 — 핸들러가 반환된 후에도 필요하면 바이트를 복사하세요. StatementEventResult::error_msg(fmt, ...)은 printf 형식의 메시지를 작성합니다. POSTEXECUTE 단계에서는 이 메시지가 권고용입니다: 서버가 로깅하지만 클라이언트에 전파하지 않습니다.

완전한 예제

vsql_slow_query_log 테스트 확장 프로그램의 축약된 형태입니다. 이는 실행 시간이 임계값을 초과하는 각 쿼리를 로깅하며, 문 이벤트 기능을 런타임 구성을 위한 시스템 변수와 결합합니다:

SQL에서 활성화

미리보기 계층이 활성화된 상태에서(참조: 미리보기 계층 활성화), 확장 프로그램을 빌드하고, 그 .veb 파일을 veb_dir에 복사하고, 설치한 다음, 시스템 변수를 통해 구성합니다:
임계값보다 느린 각 쿼리는 구성된 로그 파일에 추가됩니다: