イベントテーブル列¶

イベント・テーブルは、あらかじめ定義された列セットを持つ、特別な種類のデータベーステーブルです。テーブルの構造は、遠隔測定データを扱うためのフレームワークである OpenTelemetry のデータモデルをサポートするように設計されています。

イベントテーブルの操作の詳細については、イベントテーブルの操作をご参照ください。

イベントテーブル列¶

イベントテーブルには次の列があります。

列	データ型	説明
TIMESTAMP	TIMESTAMP_NTZ	イベント作成時の UTC タイムスタンプ。ある期間を表すイベントの場合、これはその期間の終わりです。
START_TIMESTAMP	TIMESTAMP_NTZ	トレースイベントなど、一定の期間を表すイベントの場合は、 UTC タイムスタンプとしての期間の開始時刻。
OBSERVED_TIMESTAMP	TIMESTAMP_NTZ	ログに使用される時間は UTC です。現在、 TIMESTAMP と同じ値です。
TRACE	OBJECT	すべてのシグナル型のコンテキストをトレースします。文字列値 `trace_id` と `span_id` が含まれます。
RESOURCE	OBJECT	今後の使用のために予約されています。
RESOURCE_ATTRIBUTES	OBJECT	データベース、スキーマ、ユーザー、ウェアハウス:ref:`Openflow<label-openflow_event_table-resource_attributes>` などのイベントのソースを識別する属性。
SCOPE	OBJECT	イベントのスコープ。たとえば、ログのクラス名などです。
SCOPE_ATTRIBUTES	OBJECT	今後の使用のために予約されています。
RECORD_TYPE	STRING	イベント型。次のいずれかを使用します。ログメッセージの場合は `LOG`。同じスレッド上で連続して実行されるユーザー定義関数呼び出しの `SPAN`。詳細については、 RECORD_TYPE 列をご参照ください。単一のトレースイベントの場合は `SPAN_EVENT`。1つのクエリで複数の `SPAN_EVENT` を出力できます。 Icebergの自動リフレッシュなど、操作に関連付けられたイベントの:code:`EVENT`。
RECORD	OBJECT	RECORD 列で説明されている、各記録の型の固定値。
RECORD_ATTRIBUTES	OBJECT	RECORD_ATTRIBUTES 列で説明されている、各記録の型の変数属性。
VALUE	VARIANT	プライマリイベントの値。
EXEMPLARS	ARRAY	今後の使用のために予約されています。

イベント型ごとにキャプチャされたデータ¶

ログのデータ¶

属性	説明
OBSERVED_TIMESTAMP	現在、 TIMESTAMP と同じ値です。
RECORD	ログイベントによって記録された重大度レベル。
RECORD_ATTRIBUTES	ログイベントが出力されたコード内の場所。値は言語によって異なりますが、コードファイルのパス、関数名、行番号などが含まれる場合があります。
RECORD_TYPE	イベント型: ログメッセージの場合は `LOG`
RESOURCE_ATTRIBUTES	データベース、スキーマ、ユーザー、ウェアハウスなど、イベントのソースを識別する属性。
SCOPE	ログイベントが作成されたクラスの名前など、イベントが発生したスコープ。
TIMESTAMP	イベントが作成されたときのタイムスタンプ。
VALUE	ログメッセージ。

メトリックのためのデータ¶

属性	説明
RECORD	メトリックイベントの場合、メトリックの名前と単位を含むオブジェクト。
RECORD_TYPE	イベントタイプ: メトリックデータポイント用の `METRIC`。
RESOURCE_ATTRIBUTES	データベース、スキーマ、ユーザー、ウェアハウスなど、イベントのソースを識別する属性。
START_TIMESTAMP	RECORD 列 `metric_type` 値が `sum` の場合、これはメトリックが収集された時間です。`metric_type` の値が `gauge` の場合は使用されません。
TIMESTAMP	イベントが作成されたときのタイムスタンプ。
VALUE	メトリックの数値。

トレースイベントのデータ¶

属性	説明
RECORD	スパンの場合、スパンの名前と種類を含むオブジェクト。スパンイベントの場合、オブジェクトにはスパンの名前が含まれます。
RECORD_ATTRIBUTES	スパンまたはスパンイベントに関連付けられた属性データ。
RECORD_TYPE	イベント型: スパンの場合は `SPAN`、スパンイベントの場合は `SPAN_EVENT`。
RESOURCE_ATTRIBUTES	データベース、スキーマ、ユーザー、ウェアハウスなど、イベントのソースを識別する属性。
START_TIMESTAMP	スパンの場合は、そのスパンが開始された時刻。スパンイベントには使用されません。
TIMESTAMP	イベントが作成されたときのタイムスタンプ。
TRACE	スパンとその中のスパンイベントの識別子 `trace_id` と `span_id` です。

Icebergの自動リフレッシュイベントのデータ¶

Snowflakeは、Icebergの自動リフレッシュのスナップショットを処理するときに、イベントテーブルにイベントをログします。次のテーブルは、Icebergの自動リフレッシュイベントの列について説明しています。

属性	説明
TIMESTAMP	イベントが作成されたときのタイムスタンプ。
RESOURCE_ATTRIBUTES	データベース名、スキーマ名、テーブル名、カタログ名など、Iceberg自動リフレッシュイベントを識別する属性。
RECORD_TYPE	イベント型:code:`EVENT`。
RECORD	名前と重大度など、イベントに関連付けられた操作のステータスに関する詳細情報。
RECORD_ATTRIBUTES	イベントに関連付けられた属性。
VALUE	イベントに固有の追加情報。

EXEMPLARS 列¶

今後の使用のために予約されています。

OBSERVED_TIMESTAMP 列¶

ログの UTC タイムスタンプ。トレースイベントには使用されません。

RECORD 列¶

ログイベントのログレベルやトレースイベント（スパンまたはスパンイベント記録）の名前など、イベントに関するコア情報を提供します。

記録の属性がある場合は、 RECORD_ATTRIBUTES 列に記録されます。

この列に含まれる値は、次のセクションで説明するように、 RECORD_TYPE 列（LOG、 SPAN、または SPAN_EVENT）の値に応じて異なります。

`LOG` RECORD_TYPE の場合¶

RECORD_TYPE 列の値が LOG の場合、 RECORD 列の値にはログメッセージの重大度が含まれます。列の値には次のキーが含まれる場合があります。

キー	型	説明
`severity_text`	STRING	ログの重大度のテキスト。次のいずれかを使用します。 `TRACE` `DEBUG` `INFO` `WARN` `ERROR` `FATAL` ログエントリが未処理の例外の場合、この値は現在の言語ランタイムについて最も重大度が高いエラーレベルとなります。たとえば、Pythonで記述されたコードの場合、値は `FATAL` になります。

キー

型

説明

severity_text

STRING

ログの重大度のテキスト。次のいずれかを使用します。

TRACE
DEBUG
INFO
WARN
ERROR
FATAL

ログエントリが未処理の例外の場合、この値は現在の言語ランタイムについて最も重大度が高いエラーレベルとなります。たとえば、Pythonで記述されたコードの場合、値は FATAL になります。

例¶

{
  "severity_text": "INFO"
}

Copy

`METRIC` RECORD_TYPE の場合¶

メトリックは、Snowflakeによって生成された CPU 、メモリデータである。このデータを使ってリソースの消費を分析することができます。

実行ハンドラ言語とその環境は、メトリック・データの意味に大きく影響します。詳細については、ハンドラー・コードからメトリクス・データを出力するをご参照ください。

キー	型	説明
`metric.name`	string	その行が記録するメトリックの名前。次のいずれかを使用します。 `process.memory.usage`: 実行中に消費されたメモリの量（バイト）。 `process.cpu.utilization`: （ CPU を使用）ハンドラーの言語によって測定方法が異なります。詳細については、ハンドラー・コードからメトリクス・データを出力するをご参照ください。
`metric.unit`	string	メートル法の単位。例えば、 `bytes` です。
`metric_type`	string	OpenTelemetry メトリックデータのメトリックポイントのタイプ。例えば、 `sum` または `gauge` 。
`value_type`	string	VALUE 列の値のデータ型。例えば、 `DOUBLE` または `INT` 。

例¶

{
  "metric": {
    "name": "process.memory.usage",
    "unit": "bytes"
  },
  "metric_type": "sum",
  "value_type": "INT"
}

Copy

`SPAN` RECORD_TYPE の場合¶

スパンは、関数とプロシージャの個々の実行を表します。ストアドプロシージャの場合は、単一のスパンが存在します。ユーザー定義関数の場合は、Snowflakeが実行スケジュールをどのように決定したかに応じて、1つの関数呼び出しに複数のスパンが存在する場合があります。

特定のクエリのスパンすべては、 TRACE 列の trace_id キーに同じ値を持ちます。

スパンの継続時間は、 start_timestamp 列と timestamp 列の値の差であり、それぞれスパン実行の開始時刻と終了時刻を示します。

スパンの ID とクエリトレースは、 TRACE 列の値で表されます。

Snowflakeは、以下に示すキーを使用して実行ごとに1つのスパンを作成します。

キー	型	説明
`dropped_attributes_count`	int	記録が最大値に達した後に無視される属性の数。
`name`	string	実行ファイルのハンドラがPythonで書かれている場合、これはデータを発行した関数やプロシージャのハンドラーを識別します。これは実行ファイルの種類によって以下のように異なります: 手続き: ハンドラ関数名ユーザー定義関数 (UDF): ハンドラー関数名ユーザー定義テーブル関数 (UDTF): ハンドラー・クラス名クライアントコード: スパンを開始したクライアントサイド API 名。トレースコードが、プロシージャ内で実行される SQL ステートメントなどの SQL で書かれているとき、たとえば `SELECT` や `INSERT` などは実行されたステートメントの名前です。実行可能ファイルのハンドラーがPythonまたは SQL 以外の言語で書かれている場合、これは `snow.auto_instrumented` のような固定値になります。
`kind`	string	トレースされたコードが SQL で書かれている場合の `SPAN_KIND_SERVER`。それ以外の場合、これは固定値 `SPAN_KIND_INTERNAL` です。
`parent_span_id`	16進数文字列	現在のトレースが通過したプロシージャまたは UDF のスパンを識別します。この値が存在する場合、現在のプロシージャまたは UDF の呼び出しが、呼び出し連鎖の関係にある別のプロシージャによって行われたことを意味します。その「親」プロシージャの `span_id` の値は、この `parent_span_id` と同じです。
`snow.process.memory.usage.max`	string	任意。存在する場合、このスパンの実行中に使用されるメモリの最大量をバイト単位で指定します。
`status`	string	スパンが未処理の例外に対応する場合は、 `STATUS_CODE_ERROR`。それ以外の場合は、 `STATUS_CODE_UNSET`。

ユーザー定義関数の場合、Snowflakeはスパンの属性を追加して、関数によって処理および出力された行数を示すことがあります。

`SPAN_EVENT` RECORD_TYPE の場合¶

スパンイベントは、上で説明したように、特定のスパン実行に関連付けられたイベント記録です。アプリケーションのニーズに合わせてイベントを作成できます。スパンイベントの数は128に制限されています。

TRACE 列の値は、イベントが作成されたスパンを識別します。

スパンイベントには単一のキー name があり、 RECORD_ATTRIBUTES 列に任意の属性を追加できます。

キー	型	説明
`name`	string	スパンイベントの名前。

Iceberg自動リフレッシュイベントの :code:`EVENT`RECORD_TYPE の場合¶

キー	型	説明
`name`	VARCHAR	イベントの名前。例: `iceberg_auto_refresh_snapshot_lifecycle`
`severity_text`	VARCHAR	イベントの重大度のテキスト。次の値のいずれかです。 `DEBUG` `WARN` `ERROR` `snapshot_state` が `"errored"` の場合の重大度テキストは以下の値のいずれかです。 Snowflakeが人間の介入なしに解決できるエラーを検出した場合は:code:`WARN`。解決するために人間の介入を必要とするエラーがSnowflakeで発生した場合は:code:`ERROR`。 `snapshot_state` は、VALUE 列のオブジェクトのキーと値のペアです。詳細については、 Iceberg自動リフレッシュイベントの :code:`EVENT`VALUE の場合をご参照ください。

キー

型

説明

name

VARCHAR

イベントの名前。例: iceberg_auto_refresh_snapshot_lifecycle

severity_text

VARCHAR

イベントの重大度のテキスト。次の値のいずれかです。

DEBUG
WARN
ERROR

snapshot_state が "errored" の場合の重大度テキストは以下の値のいずれかです。

Snowflakeが人間の介入なしに解決できるエラーを検出した場合は:code:WARN。
解決するために人間の介入を必要とするエラーがSnowflakeで発生した場合は:code:ERROR。

snapshot_state は、VALUE 列のオブジェクトのキーと値のペアです。詳細については、 Iceberg自動リフレッシュイベントの :code:`EVENT`VALUE の場合をご参照ください。

RECORD_ATTRIBUTES 列¶

Snowflakeまたはーコードによって設定されたメタデータを使用してイベントを説明します。次のセクションで説明するように、値は行に含まれる記録の型によって異なります。

`LOG` RECORD_TYPE の場合¶

ログイベントが出力されたコード内の場所。コードファイルのパス、関数名、行番号などが含まれます。

以下の属性に加えて、 RECORD_ATTRIBUTES の値に含める独自の属性を追加することができます。

属性	型	説明
`code.filepath`	int	メッセージを生成したコードを含むファイル。
`code.function`	string	メッセージを生成した関数の名前。
`code.lineno`	int	メッセージを生成したコードの行番号。
`code.namespace`	int	メッセージを生成したコードの名前空間。
`exception.message`	string	未処理の例外からのエラーメッセージ。
`exception.type`	string	未処理の例外のクラス名。
`exception.stacktrace`	string	言語ランタイムによってフォーマットされた未処理の例外のスタックトレース。
`exception.escaped`	boolean	このエントリが未処理の例外からのものである場合は、 `true`。
`thread.id`	int	ログイベントが作成されたスレッド。
`thread.name`	string	ログイベントが作成されたスレッド。

例¶

以下の例では、カスタム属性によって追加された employee.id を除き、すべての属性が Snowflake によって追加されています。

{
  "code.filepath": "main.scala",
  "code.function": "$anonfun$new$10",
  "code.lineno": 149,
  "code.namespace": "main.main$",
  "thread.id": 1,
  "thread.name": "main"
  "employee.id": "52307953446424"
}

Copy

`SPAN` RECORD_TYPE の場合¶

記録時にスパンに割り当てられる属性（存在する場合）。属性の名前と値は、コードまたはSnowflakeによって設定されます。

次のテーブルに、Snowflakeによって設定される可能性のある属性をリストします。

属性	型	説明
`db.query.executable.names`	string	このスパンでトレースされたクエリの下で実行された実行可能ファイルの名前。
`db.query.table.names`	string	このスパンでトレースされたクエリで読み取られたテーブルまたは変更されたテーブルの名前。
`db.query.view.names`	string	このスパンでトレースされたクエリでアクセスされたビューの名前。
`db.query.text`	string	このスパンでトレースされた SQL クエリのテキスト。SQL トレースクエリテキストがトレース用に有効になっている場合のみ含まれます。詳細については、 SQL ステートメントトレースをご参照ください。
`snow.input.rows`	int	関数のスパンによって処理される入力行の数。
`snow.output.rows`	int	関数のスパンによって処理される出力行の数。

例¶

次の例のコードには、Snowflakeによって設定される属性が含まれています。

{
  "snow.input.rows": 12
  "snow.output.rows": 12
}

Copy

例¶

次の例のコードには、ハンドラーコードによって設定される属性が含まれています。

{
  "MyFunctionVersion": "1.1.0"
}

Copy

`SPAN_EVENT` RECORD_TYPE の場合¶

記録時にスパンイベントに割り当てられる属性（存在する場合）。属性の名前と値は、Snowflakeまたはユーザーコードによって設定されます。

例¶

次の例のコードには、ハンドラーコードによって設定される属性が含まれています。

{
  "mykey1": "value1",
  "mykey2": "value2"
}

Copy

Iceberg自動リフレッシュイベントの :code:`EVENT`RECORD_TYPE の場合¶

Icebergの自動リフレッシュに対して記録されたときのEVENT イベントに割り当てられた属性。属性の名前と値はSnowflakeによって設定されます。

属性	型	説明	例
`snow.snapshot.id`	INTEGER	Iceberg自動リフレッシュ中に処理されるIcebergスナップショットの ID。自動リフレッシュプロセスが失敗した場合は NULL。	`12345`

RECORD_TYPE 列¶

イベントテーブルの行で記述される記録の種類を指定します。この列の値は、イベントテーブルにデータを含めることができるさまざまな種類の記録のどれであるかを識別します。

RECORD 列には、この記録のデータが含まれています。RECORD_ATTRIBUTES 列には、この記録のメタデータが含まれます（存在する場合）。

次のテーブルに、この列に指定できる値をリストします。

列の値	説明
`LOG`	この行は、ハンドラーコードによって生成されたログエントリを表します。
`SPAN`	行はスパンを表します。ストアドプロシージャの場合は、単一のスパンが存在します。並列化できるユーザー定義関数の場合は、関数が実行されるスレッドごとにスパンが存在します。スレッドの数は、関数が実行されるSnowflakeウェアハウスのサイズなど、複数の要因によって異なります。スパンには複数のスパンイベントが含まれる場合があります。詳細については、記録されたスパンデータをご参照ください。
`SPAN_EVENT`	行はスパンイベントを表します。特定のスパンに関連付けられた複数のスパンイベント記録である場合があります。ハンドラーコードでは、ニーズに合わせてイベントを作成できます。スパンイベントの数は128に制限されています。
`METRIC`	行はメトリックの観測値を表します。複数のメトリックの複数のオブザベーションを、特定のスパンに関連付けることがでまする。
`EVENT`	行は、Icebergの自動リフレッシュなど、特定の操作に関連付けられたイベントを表します。

RESOURCE 列¶

今後の使用のために予約されています。

RESOURCE_ATTRIBUTES 列¶

Snowflakeオブジェクトの観点からイベントのソースを説明します。

この列の値を構成する属性はSnowflakeによって設定され、変更できません。

イベントソースのリソース属性¶

注釈

イベントソースがIceberg自動リフレッシュの場合は、以下の属性型のみが設定されます。

snow.catalog.integration.name
snow.catalog.table.name
snow.database.name
snow.schema.name
snow.table.name

属性名	属性の型	説明	例
`snow.catalog.integration.name`	string	Iceberg自動リフレッシュの実行可能ファイルに関連付けられたカタログ統合の名前。	`MY_CATALOG_INTEGRATION_NAME`
`snow.catalog.table.name`	string	カタログ内のIcebergテーブルの名前。	`MY_CATALOG_TABLE_NAME`
`snow.database.id`	int	実行可能ファイルを含んでいるデータベースの内部/システム生成の識別子。	`12345`
`snow.database.name`	string	実行可能ファイルを含んでいるデータベースの名前。	`MY_DATABASE`
`snow.executable.id`	int	イベントを生成する実行可能ファイル（プロシージャ、関数、 SnowService など）の内部/システム生成の識別子。	`12345`
`snow.executable.name`	string	イベントを生成する実行可能ファイルの名前。たとえば、プロシージャ名、関数名、Streamlitアプリ名などです。	`MY_UDF`
`snow.executable.runtime.version`	string	実行言語のランタイムバージョン。これは、後述するように、その言語に固有の値となります: Java: `11` または `17` JavaScript: 値なし Python: `3.9` から `3.12` Scala: `2.12` SQL: 値なし	`procedure`
`snow.executable.type`	string	次のいずれかを使用します。ストアドプロシージャの場合は `procedure` ユーザー定義関数の場合は `function` SQL ステートメントがストアドプロシージャ内で実行される場合など、SQL が実行されたイベントの `query`。 Snowflake スクリプトブロックなど、単一クエリからのイベントの場合は `sql` Snowpark Container Servicesのサービス用の `spcs` Streamlitアプリの `streamlit`	`procedure`
`snow.owner.id`	int	実行可能ファイルに対する OWNERSHIP 権限を持つロールの内部/システム生成識別子。	`1234`
`snow.owner.name`	string	実行可能ファイルの OWNERSHIP 権限を持つロールの名前。	`UDF_OWNER_RL`
`snow.schema.id`	int	実行可能ファイルを含んでいるスキーマの内部/システム生成の識別子。	`12345`
`snow.schema.name`	string	実行可能ファイルを含んでいるスキーマの名前。	`MY_SCHEMA`
`snow.table.name`	string	実行可能ファイルに関連付けられたテーブルの名前。	`MY_TABLE_NAME`
`telemetry.sdk.language`	string	リソース/SDK の言語。Snowflakeは、Java、scala、Python、JavaScript、SQLを使用します。	`java`

実行環境のリソース属性¶

属性	型	説明	例
`db.user`	string	関数またはプロシージャの場合、その関数またはプロシージャを実行するユーザーの名前。Streamlitアプリの場合、特定のイベントでアプリを表示していたユーザーの名前。	`MY_USER_NAME`
`snow.query.id`	string	クエリの ID。	`01a6aeb7-0604-c466-0000-097127d13812`
`snow.release.version`	string	イベントの生成時に実行されていたSnowflakeリリース	`7.9.0`
`snow.session.id`	int	実行可能ファイルを実行しているセッションの ID。	`10`
`snow.session.role.primary.id`	int	セッション内にあるプライマリロールの内部/システム生成の識別子。	`10`
`snow.session.role.primary.name`	string	セッション内のプライマリロールの名前。	`MY_ROLE`
`snow.user.id`	int	クエリを実行しているユーザーの内部/システム生成の識別子。	`1234`
`snow.warehouse.id`	int	イベントを生成するクエリを実行しているウェアハウスの内部/システム生成の識別子。	`12345`
`snow.warehouse.name`	string	イベントを生成するクエリを実行しているウェアハウスの名前。	`MY_WAREHOUSE`

アプリケーションのリソース属性¶

属性	型	説明	例
`snow.application.consumer.name`	string	Snowflake Native App の場合、コンシューマーアカウントの名前。	`CONSUMER_NAME`
`snow.application.consumer.organization`	string	Snowflake Native App の場合、コンシューマー組織の名前。	`CONSUMER_ORG_NAME`
`snow.application.id`	string	Snowflake Native App の場合、アプリの内部/システム生成識別子。	`ABCZN3J3`
`snow.application.name`	string	Snowflake Native App の場合、アプリケーションの名前。	`MY_INSTALLED_APP_NAME`
`snow.application.package.name`	string	Snowflake Native App の場合、アプリケーションパッケージの名前。	`MY_INSTALLED_PACKAGE_NAME`
`snow.listing.global_name`	string	Snowflake Native App の場合、リスティングの内部/システム生成識別子。	`GZYZN3J3`
`snow.listing.name`	string	Snowflake Native App の場合は、リスティングの名前。	`MY_LISTING_NAME`

Snowflakeバージョンのリソース属性¶

属性	型	説明	例
`service.version`	string	関連性がある場合は、実行可能ファイルのバージョン。`snow.version` と `snow.patch` が存在する場合は、これらをドットで結合した組み合わせ。標準の OpenTelemetry 属性。	`2.3.1`
`snow.patch`	string	実行中の実行可能ファイルのパッチレベル。	`1`
`snow.version`	string	実行中の実行可能ファイルのバージョン。	`2.3`

例¶

{
  "db.user": "MYUSERNAME",
  "snow.database.id": 13,
  "snow.database.name": "MY_DB",
  "snow.executable.id": 197,
  "snow.executable.name": "FUNCTION_NAME(I NUMBER):ARG_NAME(38,0)",
  "snow.executable.type": "FUNCTION",
  "snow.owner.id": 2,
  "snow.owner.name": "MY_ROLE",
  "snow.query.id": "01ab0f07-0000-15c8-0000-0129000592c2",
  "snow.schema.id": 16,
  "snow.schema.name": "PUBLIC",
  "snow.session.id": 1275605667850,
  "snow.session.role.primary.id": 2,
  "snow.session.role.primary.name": "MY_ROLE",
  "snow.user.id": 25,
  "snow.warehouse.id": 5,
  "snow.warehouse.name": "MYWH",
  "telemetry.sdk.language": "python"
}

Copy

SCOPE 列¶

ログイベントの場合は、ログエントリを作成するクラスの名前など、イベントを出力したコードの名前空間。これはトレースイベントには使用されません。

次のテーブルに、この列に含めることができる属性をリストします。

スコープ値¶

属性	型	説明	例
`name`	文字列	イベントを出力するコードの名前空間。	`com.sample.MyClass`

例¶

{
  "name": "com.sample.MyClass"
}

Copy

SCOPE_ATTRIBUTES 列¶

今後の使用のために予約されています。

START_TIMESTAMP 列¶

UTC タイムスタンプとしてスパンが開始された時刻。

RECORD_TYPE 列の値	START_TIMESTAMP 値の説明
`LOG`	不使用。
`SPAN`	スパンの開始時刻。
`SPAN_EVENT`	不使用。
`METRIC`	RECORD 列 `metric_type` 値が `sum` の場合、これはメトリックが収集された時間です。`metric_type` の値が `gauge` の場合は使用されません。

TIMESTAMP 列¶

イベントが出力された時刻。次のテーブルにリストするように、値の意味は、行が表す記録の型によって異なります。

RECORD_TYPE 列の値	TIMESTAMP 値の説明
`LOG`	イベントが出力されたウォールクロック時刻。
`SPAN`	実行が終了した時刻。
`SPAN_EVENT`	イベントが出力されたウォールクロック時刻。

TRACE 列¶

関数とプロシージャの実行を表す一意の識別子。

RECORD_TYPE 列の値	TRACE 値の説明
`LOG`	不使用。
`SPAN`	`trace_id` および `span_id`
`SPAN_EVENT`	`trace_id` および `span_id`

トレース値¶

次のテーブルに、この列に含めることができる属性をリストします。

属性	型	説明	例
`span_id`	16進数文字列	スレッドモデルに関連付けられた一意の識別子。プロシージャはシングルスレッドであり、単一の `span_id` 値を持ちます。Snowflakeによって複数のスレッド（複数の行など）で実行される関数には、複数の `span_id` 値が含まれる場合があります。現在のスパンが、トレース内の別のプロシーや UDF を呼び出したプロシージャーのものである場合、この `span_id` の値は、呼び出したプロシージャや UDF のスパンの RECORD 列 `parent_span_id` の値と同じになります。	`b4c28078330873a2`
`trace_id`	16進数文字列	クエリからの呼び出しに対する一意の識別子。ストアド・プロシージャが呼び出しの連鎖の中で呼び出されていない場合、各呼び出しはそれ自身の `trace_id` 値を持ちます。クエリ内では、クエリから行われたすべての関数の呼び出しは同じ `trace_id` 値を共有します。プロシージャーがコールチェーン内の他のプロシージャや UDF から呼び出される場合、そのプロシージャは、チェーン内の他のプロシージャや UDFs と同じ `trace_id` 値を持ちます。この値はクエリごとに一意であり、クエリ内のすべてのスパンで同一です。これを使用して、単一のクエリ実行内のイベントをグループ化できます。	`6992e9febf0b97f45b34a62e54936adb`

属性

型

説明

例

span_id

16進数文字列

スレッドモデルに関連付けられた一意の識別子。プロシージャはシングルスレッドであり、単一の span_id 値を持ちます。Snowflakeによって複数のスレッド（複数の行など）で実行される関数には、複数の span_id 値が含まれる場合があります。

現在のスパンが、トレース内の別のプロシーや UDF を呼び出したプロシージャーのものである場合、この span_id の値は、呼び出したプロシージャや UDF のスパンの RECORD 列 parent_span_id の値と同じになります。

b4c28078330873a2

trace_id

16進数文字列

クエリからの呼び出しに対する一意の識別子。ストアド・プロシージャが呼び出しの連鎖の中で呼び出されていない場合、各呼び出しはそれ自身の trace_id 値を持ちます。クエリ内では、クエリから行われたすべての関数の呼び出しは同じ trace_id 値を共有します。

プロシージャーがコールチェーン内の他のプロシージャや UDF から呼び出される場合、そのプロシージャは、チェーン内の他のプロシージャや UDFs と同じ trace_id 値を持ちます。

この値はクエリごとに一意であり、クエリ内のすべてのスパンで同一です。これを使用して、単一のクエリ実行内のイベントをグループ化できます。

6992e9febf0b97f45b34a62e54936adb

例¶

次の例のコードは、スパンまたはスパンイベントに存在する属性を示しています。

{
  "span_id": "b4c28078330873a2",
  "trace_id": "6992e9febf0b97f45b34a62e54936adb"
}

Copy

VALUE 列¶

ログイベントの場合、通常、ログメッセージになります。ログに記録されたイベントが未処理の例外の場合、この列の値は単に exception となります。
メトリクスの場合、これはメトリクスの数値です。

VALUE 列の型は（STRING ではなく） VARIANT であるため、 JavaScript などの一部の言語では文字列以外の値を持つことができることに注意してください。

Iceberg自動リフレッシュイベントの :code:`EVENT`VALUE の場合¶

キー	型	説明	例
`metadata_file_location`	VARCHAR	Icebergメタデータファイルの場所。自動リフレッシュプロセスが失敗した場合は NULL です。	`"s3://my_bucket/iceberg_snapshots/metadata/...metadata.json"`
`snapshot_state`	VARCHAR	自動リフレッシュプロセスの状態。以下の値のいずれかです。 `started`:Snowflakeはスナップショットの処理を開始しました。 `completed`:Snowflakeはスナップショットの処理を完了しました `errored`:Snowflakeはスナップショットの処理に失敗しました。	`"errored"`
`error_message`	VARCHAR	`snapshot_state` の値が :code:`errored`の場合、この列にはエラーメッセージが含まれます。	「Icebergの自動リフレッシュで致命的なエラーが発生しました。自動リフレッシュを無効にし、自動リフレッシュを再度有効にする前にテーブルを手動でリフレッシュしてください。FailedMetadataFile: s3://my_bucket/...、 FailedSnapshotId：null.n」

キー

型

説明

例

metadata_file_location

VARCHAR

Icebergメタデータファイルの場所。自動リフレッシュプロセスが失敗した場合は NULL です。

"s3://my_bucket/iceberg_snapshots/metadata/...metadata.json"

snapshot_state

VARCHAR

自動リフレッシュプロセスの状態。以下の値のいずれかです。

started:Snowflakeはスナップショットの処理を開始しました。
completed:Snowflakeはスナップショットの処理を完了しました
errored:Snowflakeはスナップショットの処理に失敗しました。

"errored"

error_message

VARCHAR

snapshot_state の値が :code:`errored`の場合、この列にはエラーメッセージが含まれます。

「Icebergの自動リフレッシュで致命的なエラーが発生しました。自動リフレッシュを無効にし、自動リフレッシュを再度有効にする前にテーブルを手動でリフレッシュしてください。FailedMetadataFile: s3://my_bucket/...、 FailedSnapshotId：null.n」

例¶

{
  "metadata_file_location": "<path>",
  "snapshot_state": "errored",
  "error_message": "<error_message>"
}

Copy

イベントテーブル列¶