カテゴリ：: テーブル関数

<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が過去1日間の 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