カテゴリ:

Information Schemaテーブル関数

MATERIALIZED_VIEW_REFRESH_HISTORY

このテーブル関数は、指定された日付範囲内にある指定されたマテリアライズドビューの マテリアライズドビュー 更新履歴のクエリに使用されます。関数によって返される情報には、マテリアライズドビューが更新されるたびに消費されるビュー名とクレジットが含まれます。

構文

MATERIALIZED_VIEW_REFRESH_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , MATERIALIZED_VIEW_NAME => '<string>' ] )
Copy

引数

すべての引数はオプションです。

DATE_RANGE_START => constant_expr. DATE_RANGE_END => constant_expr

マテリアライズドビューのメンテナンス履歴を表示する日付/時刻範囲。たとえば、開始日を2019-04-03、終了日を2019-04-05と指定すると、4月3日、4月4日、4月5日のデータが取得されます。(エンドポイントを含む。)

  • 開始日も終了日も指定されていない場合、デフォルトは過去12時間です。

  • 終了日は指定されていないが、開始日は指定されている場合、 CURRENT_DATE の午前0時が範囲の終了として使用されます。

  • 開始日は指定されていないが、終了日は指定されている場合、範囲は DATE_RANGE_END の開始12時間前に開始します。

MATERIALIZED_VIEW_NAME => string

マテリアライズドビュー名。指定した場合は、指定したマテリアライズドビューの履歴のみを表示します。名前には、スキーマ名とデータベース名を含めることができます。

名前が指定されていない場合、結果には、指定された時間範囲内に維持されている各マテリアライズドビューのデータが含まれます。

使用上の注意

  • ACCOUNTADMIN ロールまたは MONITOR USAGE グローバル権限が明示的に付与されているロールの結果のみを返します。

    注釈

    MONITOR USAGE 権限を持つロールは、オブジェクトごとのクレジット使用状況を表示できますが、オブジェクト名は表示できません。この関数によって名前が返されるようにするには、オブジェクトのロールに SELECT も付与する必要があります。ロールにオブジェクト名を表示するための十分な権限がない場合、オブジェクト名は「unknown_#」などの代替名で表示される場合があります。「#」は1桁以上を表します。

  • 情報スキーマテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマ または 完全修飾の関数名が必要です。詳細については、 Snowflake Information Schema をご参照ください。

  • 履歴は1時間単位で表示されます。

出力

この関数は、次の列を返します。

列名

データ型

説明

START_TIME

TIMESTAMP_LTZ

指定された時間範囲の開始です。

END_TIME

TIMESTAMP_LTZ

指定された時間範囲の終了です。

CREDITS_USED

TEXT

START_TIME および END_TIME の期間中にマテリアライズドビューのメンテナンスに対して請求されたクレジットの数。

MATERIALIZED_VIEW_NAME

TEXT

マテリアライズドビューの名前。

アカウントの1時間範囲の更新履歴を取得します。

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>'2019-05-22 19:00:00.000',
    date_range_end=>'2019-05-22 20:00:00.000'));
Copy

出力例を次に示します。

+-------------------------------+-------------------------------+--------------+-----------------------------------------+
| START_TIME                    | END_TIME                      | CREDITS_USED | MATERIALIZED_VIEW_NAME                  |
|-------------------------------+-------------------------------+--------------+-----------------------------------------|
| 2019-05-22 19:00:00.000 -0700 | 2019-05-22 20:00:00.000 -0700 |  0.223276651 | TEST_DB.TEST_SCHEMA.MATERIALIZED_VIEW_1 |
+-------------------------------+-------------------------------+--------------+-----------------------------------------+
Copy

アカウントの過去12時間の履歴を取得します。

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));
Copy

アカウントの過去1週間の履歴を取得します。

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date));
Copy

アカウント内にある指定されたマテリアライズドビューの過去1週間のメンテナンス履歴を取得します。

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date,
    materialized_view_name=>'mydb.myschema.my_materialized_view'));
Copy