<service_name>!SPCS_GET_EVENTS
<service_name>!SPCS_GET_EVENTS
<service_name>!SPCS_GET_EVENTS 테이블 함수는 Snowflake가 지정된 서비스에 대해 수집한 이벤트를 반환해요.
본문
<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)