ONLINE_FEATURE_TABLE_REFRESH_HISTORY¶

このテーブル関数は、オンライン機能テーブルの各リフレッシュ（完了および実行中）に関する情報を返します。

このテーブル関数は、現在進行中のすべてのリフレッシュと、現時刻から7日以内に REFRESH_START_TIME のあるすべてのリフレッシュを返します。

こちらもご参照ください。: CREATE ONLINE FEATURE TABLE、 ALTER ONLINE FEATURE TABLE、 DESCRIBE ONLINE FEATURE TABLE、 DROP ONLINE FEATURE TABLE、 SHOW ONLINE FEATURE TABLES

構文¶

ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  [ REFRESH_START_TIMESTAMP => <constant_expr> ]
  [ , REFRESH_END_TIMESTAMP => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , NAME => '<string>' ]
  [ , NAME_PREFIX => '<string>' ]
  [ , ERROR_ONLY => { TRUE | FALSE } ]
)

Copy

引数¶

すべての引数はオプションです。引数が提供されない場合は、アカウント内にあるすべてのオンライン機能テーブルから100個のリフレッシュが返されます。

REFRESH_START_TIMESTAMP => constant_expr 、 REFRESH_END_TIMESTAMP => constant_expr

リフレッシュが開始された時間範囲（TIMESTAMP_LTZ形式）。終了バージョンが指定されていない場合は、 CURRENT_TIMESTAMP が範囲の終了として使用されます。

RESULT_LIMIT => integer

関数によって返される行の最大数を指定する数です。一致する行の数がこの制限よりも大きい場合は、指定された制限まで、最新（およびまだ実行中）のリフレッシュが返されます。

範囲:1～10000

デフォルト：100

NAME => 'string'

オンライン機能テーブルの名前。

非修飾名（online_feature_table_name）、部分修飾名（schema_name.online_feature_table_name）、または完全修飾名（database_name.schema_name.online_feature_table_name）を指定できます。

オブジェクト名解決の詳細については、オブジェクト名の解決をご参照ください。

関数は、このテーブルのリフレッシュを返します。

NAME_PREFIX => 'string'

オンライン機能テーブルのプレフィックス。

この関数は、このプレフィックスで始まる名前のテーブルのリフレッシュを返します。

この引数を使用して、特定のデータベースまたはスキーマのオンライン機能テーブルのリフレッシュを返すことができます。

ERROR_ONLY => { TRUE | FALSE }

TRUE に設定すると、この関数は失敗したかキャンセルされたリフレッシュのみを返します。

デフォルト: FALSE

出力¶

コマンドの出力には、オブジェクトのプロパティとメタデータを説明する以下の列が含まれます。

列	データ型	説明
`NAME`	TEXT	オンライン機能テーブルの名前。
`SCHEMA_NAME`	TEXT	オンライン機能テーブルを含むスキーマの名前。
`DATABASE_NAME`	TEXT	オンライン機能テーブルを含むデータベースの名前。
`QUALIFIED_NAME`	TEXT	オンライン機能テーブルの完全修飾名。
`STATE`	TEXT	オンライン機能テーブルのリフレッシュのステータス。ステータスは、次のいずれかになります。 `EXECUTING`: リフレッシュが進行中です。 `SUCCEEDED`: リフレッシュは正常に完了しました。 `FAILED` ：実行中にリフレッシュに失敗しました。 `CANCELLED` ：完了前にリフレッシュがキャンセルされました。
`REFRESH_START_TIME`	TIMESTAMP_LTZ	リフレッシュジョブの開始時刻。
`REFRESH_END_TIME`	TIMESTAMP_LTZ	リフレッシュの完了時刻。
`REFRESH_TRIGGER`	TEXT	次のいずれか: `SCHEDULED` ：ターゲットラグを満たすための通常のバックグラウンドリフレッシュ。 `MANUAL` ：ユーザー/タスクが `ALTER ONLINE FEATURE TABLE <name> REFRESH` コマンドを実行しました。 `CREATION` ：オンライン機能テーブルの作成でトリガーされる、作成 DDL ステートメント中に実行される更新。
`REFRESH_ACTION`	TEXT	次のいずれか: `NO_DATA` ：ベーステーブルに新しいデータはありません。ベーステーブルにデータがあるかどうかに関係なく、新しく作成されたオンライン機能テーブルの最初のリフレッシュには適用されません。 `REINITIALIZE` ：ベーステーブルが変更されました。 `FULL`:オンライン機能テーブルのリフレッシュモードが FULL に設定されているため、フルリフレッシュ。 `INCREMENTAL` ：通常の増分リフレッシュ。
`QUERY_ID`	TEXT	オンライン機能テーブルの結果を生成した ID ステートメントの SQL。
`STATE_CODE`	TEXT	リフレッシュの現行状態を表すコード。
`STATE_MESSAGE`	TEXT	リフレッシュの現行状態の説明。

アクセス制御の要件¶

権限	オブジェクト	メモ
MONITOR	オンライン機能テーブル	オンライン機能テーブルで MONITOR 権限を持つロール。

指定された権限のセットを使用してカスタムロールを作成する手順については、カスタムロールの作成をご参照ください。

セキュリティ保護可能なオブジェクトに対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、アクセス制御の概要をご参照ください。

使用上の注意¶

この関数は INFORMATION_SCHEMA で使用できます。
この関数によって返される情報は最新です。この ACCOUNT_USAGE ONLINE_FEATURE_TABLE_REFRESH_HISTORY ビューでのオンライン機能テーブルの更新履歴は、最大3時間遅延する場合があります。

例¶

以下の例は、アカウント内のすべてのオンライン機能テーブルのリフレッシュ履歴を返します。

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY());

Copy

以下の例は、 my_feature_table という名前の特定のオンライン機能テーブルのリフレッシュ履歴を返します。

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME => 'my_feature_table'
));

Copy

次の例は、過去24時間に失敗したリフレッシュのみを返します。

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  REFRESH_START_TIMESTAMP => CURRENT_TIMESTAMP - INTERVAL '1 DAY',
  ERROR_ONLY => TRUE
));

Copy

次の例は、 feature_ で始まる名前のオンライン機能テーブルのリフレッシュを返し、結果は50行に制限されます。

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME_PREFIX => 'feature_',
  RESULT_LIMIT => 50
));

Copy