카테고리:: 테이블 함수

<service_name>!SPCS_GET_EVENTS¶

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

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

구문¶

<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 열에 매핑됩니다.

액세스 제어 요구 사항¶

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

권한	오브젝트	참고
MONITOR	서비스	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).

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

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

사용법 노트¶

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

예¶

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

SELECT * FROM TABLE(mydb.myschema.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 | {                                      |        0    | 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 | {                                      |        0    | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Running",                |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "READY"                    |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:34.127 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        0    | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Waiting to start",       |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "PENDING"                  |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+

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

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

Copy