<service_name>!SPCS_GET_EVENTS

<service_name>!SPCS_GET_EVENTS

<service_name>!SPCS_GET_EVENTS 테이블 함수는 Snowflake가 지정된 서비스에 대해 수집한 이벤트를 반환해요.

출처: <service_name>!SPCS_GET_EVENTS

본문

<service_name>!SPCS_GET_EVENTS 함수는 Snowflake가 지정된 서비스에 대해 수집한 이벤트를 반환해요. 자세한 내용은 플랫폼 이벤트 접근(Accessing platform events)을 참조해요.

함께 보기: 모니터링 서비스 (Monitoring Services)

구문 (Syntax)

<service_name>!SPCS_GET_EVENTS(
  [ START_TIME => <constant_expr> ],
  [ END_TIME => <constant_expr> ] )

인자 (Arguments)

  • START_TIME => constant_expr — 이벤트를 검색할 시간 범위의 시작 시각(TIMESTAMP_LTZ 형식)이에요. 날짜, 시간, 타임스탬프 데이터를 구성하는 데 사용할 수 있는 함수는 날짜 및 시간 함수(Date & time functions)를 참조해요. START_TIME을 지정하지 않으면 하루 전으로 기본 설정돼요.
  • END_TIME => constant_expr — 이벤트를 검색할 시간 범위의 종료 시각(TIMESTAMP_LTZ 형식)이에요. END_TIME을 지정하지 않으면 현재 타임스탬프로 기본 설정돼요.

출력 (Output)

열 (Column) 타입 (Type) 설명 (Description)
TIMESTAMP TIMESTAMP_NTZ Snowflake가 이벤트를 수집한 UTC(Coordinated Universal Time) 타임스탬프. 이 값은 이벤트 테이블의 TIMESTAMP 열에 매핑됨
SEVERITY VARCHAR 이벤트의 심각도. 이 값은 이벤트 테이블의 RECORD 열의 severity_text 필드에 매핑됨
EVENT_NAME VARCHAR 이벤트의 이름. 이 값은 이벤트 테이블의 RECORD 열의 name 필드에 매핑됨
EVENT_DETAILS OBJECT 이벤트에 대한 세부 정보. 이 값은 이벤트 테이블의 VALUE 열에 매핑됨
INSTANCE_ID NUMBER 이벤트가 서비스 인스턴스와 관련된 경우 서비스 인스턴스의 식별자. 이 값은 이벤트 테이블의 RESOURCE_ATTRIBUTES 열의 snow.service.instance 필드에 매핑됨
CONTAINER_NAME VARCHAR 이벤트가 컨테이너와 관련된 경우 컨테이너의 이름. 이 값은 이벤트 테이블의 RESOURCE_ATTRIBUTES 열의 snow.service.container.name 필드에 매핑됨
RECORD OBJECT JSON 형식의 이벤트 정보. 이 값은 이벤트 테이블의 RECORD 열에 매핑됨
RECORD_ATTRIBUTES OBJECT 이벤트에 대한 추가 정보. 이 값은 이벤트 테이블의 RECORD_ATTRIBUTES 열에 매핑됨

접근 제어 요구 사항 (Access control requirements)

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한이 있어야 해요:

권한 (Privilege) 객체 (Object) 참고 (Notes)
MONITOR Service OWNERSHIP은 객체에 대한 특수 권한으로, 객체를 만든 역할에 자동으로 부여되지만 소유 역할(또는 MANAGE GRANTS 권한이 있는 모든 역할)이 GRANT OWNERSHIP 명령으로 다른 역할에 양도할 수도 있음

스키마의 객체에 대해 운영하려면 부모 데이터베이스에 대한 권한이 하나 이상, 부모 스키마에 대한 권한이 하나 이상 필요해요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기(Creating custom roles)를 참조해요.

보안 가능한 객체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 접근 제어 개요(Overview of Access Control)를 참조해요.

사용 메모 (Usage notes)

  • 이벤트가 출력에 표시되기까지 몇 분이 걸릴 수 있어요.

예제 (Examples)

지난 하루 동안 my_test_job 작업에 대해 Snowflake가 기록한 이벤트를 검색해요:

SELECT * FROM TABLE(mydb.myschema.my_test_job!SPCS_GET_EVENTS());

지난 3일 동안 my_test_job 작업에 대해 Snowflake가 기록한 이벤트를 검색해요:

SELECT * FROM TABLE(mydb.myschema.my_test_job!SPCS_GET_EVENTS(START_TIME => DATEADD('day', -3, CURRENT_TIMESTAMP())));

더 알아보기 (Learn more)

  • 테이블 함수 (Table functions)
  • Snowpark Container Services (SPCS)
  • 모니터링 서비스 (Monitoring Services)
  • 플랫폼 이벤트 접근 (Accessing platform events)