이벤트 테이블 설정하기

로깅 또는 추적을 시작하기 전에 처리기 코드에서 생성된 메시지와 이벤트 데이터를 수집할 이벤트 테이블을 설정해야 합니다. 이벤트 테이블은 미리 정의된 열 세트를 사용하여 함수 및 프로시저 처리기 코드에서 로그에 남겨진 이벤트, 이벤트 로그, 추적 이벤트를 기록하도록 설계되었습니다.

이벤트 테이블에는 생성한 다른 테이블과 구별되는 다음과 같은 특징이 있습니다.

  • 테이블에는 로그 항목과 추적 이벤트를 캡처하기 위해 미리 정의된 열 세트가 포함됩니다. 테이블의 구조에는 미리 정의된 데이터와 사용자가 설계한 데이터를 모두 보유하기 위한 열과 키/값 특성 오브젝트 정의가 포함됩니다.

  • 로그 항목을 캡처하고 해당 테이블에 대해 이벤트를 추적하기 위해 이벤트 테이블을 계정과 연결합니다. 계정을 한 번에 하나의 이벤트 테이블에만 연결할 수 있습니다. 연결된 이벤트 테이블을 활성 이벤트 테이블 이라고 합니다.

  • 로그 메시지의 심각도 수준과 캡처할 추적 이벤트의 세부 정보 표시 수준을 지정할 수 있습니다.

  • 저장 프로시저, UDF, UDTF에 대한 처리기 코드에서 생성된 로그 메시지와 추적 이벤트는 활성 이벤트 테이블에 저장됩니다.

로깅을 위한 이벤트 테이블을 설정하려면 이 항목에서 설명하는 대로 다음을 수행해야 합니다.

  1. 이벤트 테이블 만들기.

  2. 이벤트 테이블을 계정과 연결하기.

  3. 로그 및 추적 이벤트의 수준 설정하기.

이벤트 테이블 만들기

로그 및 추적 이벤트 데이터를 저장하기 위한 이벤트 테이블을 만들려면 CREATE EVENT TABLE 명령을 실행하고 이벤트 테이블의 이름을 지정합니다. 나중에 이벤트 테이블 이름을 사용하여 테이블이 계정의 저장 프로시저, UDF, UDTF에서 생성된 로그를 캡처할 수 있도록 합니다.

이벤트 테이블을 생성할 때 테이블에서 열을 지정하지 않습니다. 이벤트 테이블에는 이벤트 테이블 열 에 설명된 대로 미리 정의된 열 세트가 이미 있습니다.

참고

이벤트 테이블의 복제는 현재 지원되지 않습니다. 이벤트 테이블이 포함된 데이터베이스를 복제하려고 하면 복제가 실패합니다.

복제할 수 있도록 활성화되지 않은 데이터베이스에 이벤트 테이블을 생성해야 합니다.

예를 들어 이름이 my_events 인 이벤트 테이블을 생성하려면 다음 문을 실행하십시오.

CREATE EVENT TABLE my_database.my_schema.my_events;
Copy

이벤트 테이블을 계정과 연결하기

계정에 대한 함수와 프로시저에서 로그 및 추적 이벤트 데이터 저장소를 활성화하려면 생성한 이벤트 테이블이 계정에 대한 활성 이벤트 테이블임을 지정해야 합니다.

계정에 대한 활성 이벤트 테이블을 지정하려면 ALTER ACCOUNT 명령을 실행하고 EVENT_TABLE 매개 변수를 이벤트 테이블의 이름으로 설정하십시오.

참고

이 명령을 실행하려면 ACCOUNTADMIN 역할을 사용해야 합니다.

또한 다음 권한이 모두 있어야 합니다.

ALTER ACCOUNT 실행에 필요한 권한에 대한 자세한 내용은 ALTER ACCOUNT 명령에 대한 설명서 를 참조하십시오.

예를 들어 데이터베이스 my_database 의 스키마 my_schema 에 있는 my_events 라는 이벤트 테이블을 계정의 활성 이벤트 테이블로 설정하려면 다음 문을 실행하십시오.

ALTER ACCOUNT SET EVENT_TABLE = my_database.my_schema.my_events;
Copy

위에서 보여준 바와 같이, 이벤트 테이블의 정규화된 이름 을 지정해야 합니다.

계정에서 이벤트 테이블의 연결을 해제하려면 ALTER ACCOUNT 명령을 실행하고 EVENT_TABLE 매개 변수를 설정 해제하십시오. 예:

ALTER ACCOUNT UNSET EVENT_TABLE;
Copy

SHOW PARAMETERS 명령으로 EVENT_TABLE 값을 확인할 수 있습니다.

SHOW PARAMETERS LIKE 'event_table' IN ACCOUNT;
Copy

로그 및 추적 이벤트의 수준 설정하기

로그 또는 추적 수준을 설정하여 이벤트 테이블에 저장되는 로그 및 추적 이벤트 데이터의 수준을 관리할 수 있습니다. 로깅하거나 추적하기 전에 이러한 설정을 사용하여 원하는 데이터의 양과 종류를 캡처하고 있는지 확인해야 합니다.

  • 메시지를 로깅하려는 경우 로그 수준 설정하기 에 설명된 대로 로그 메시지 심각도의 임계값을 설정할 수 있습니다.

  • 이벤트를 추적하려는 경우 추적 수준 설정하기 에 설명된 대로 이벤트 데이터의 세부 정보 표시 수준을 설정할 수 있습니다.