카테고리:: 테이블 함수

<service_name>!SPCS_GET_EVENTS¶

Snowflake가 지정된 서비스에 대해 수집한 이벤트를 반환합니다. 자세한 내용은 플랫폼 이벤트에 액세스하기 섹션을 참조하십시오.

참고

이 함수는 릴리스 9.20 이상에서 생성된 서비스 및 작업에 대해서만 지원됩니다.

참고 항목:: 서비스 모니터링

구문¶

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

Copy

인자¶

START_TIME => constant_expr

이벤트를 검색할 시간 범위의 시작 시간(TIMESTAMP_LTZ 형식)입니다. 데이터, 시간 및 타임스탬프 데이터를 구성하는 데 사용할 수 있는 함수에 대해서는 날짜 및 시간 함수 섹션을 참조하세요.

START_TIME 이 지정되지 않은 경우, 기본값은 1일 전입니다.

END_TIME => constant_expr

이벤트를 검색할 시간 범위의 종료 시간(TIMESTAMP_LTZ 형식)입니다.

END_TIME이 지정되지 않은 경우, 기본값은 현재 타임스탬프입니다.

출력¶

열	타입	설명
TIMESTAMP	TIMESTAMP_NTZ	Snowflake가 이벤트를 수집한 시점의 UTC(협정 세계시) 타임스탬프입니다. 이 값은 이벤트 테이블의 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 열에 매핑됩니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
OWNERSHIP	서비스	OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

이벤트가 출력에 표시되기까지 몇 분 정도 걸릴 수 있습니다.

예¶

Snowflake가 지난 하루 동안의 my_test_job 작업에 대해 기록한 이벤트를 검색합니다.

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS());

Copy

출력 예:

+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+
| TIMESTAMP               | SEVERITY | EVENT_NAME              | EVENT_DETAILS                          | INSTANCE_ID | CONTAINER_NAME | RECORD                               | RECORD_ATTRIBUTES |
|-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------|
| 2025-06-26 00:23:40.933 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Completed successfully", |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "DONE"                     |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:35.919 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Running",                |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "READY"                    |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:34.127 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Waiting to start",       |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "PENDING"                  |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+

Snowflake가 지난 3일 동안의 my_test_job 작업에 대해 기록한 이벤트를 검색합니다.

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

Copy