カテゴリ:

情報スキーマテーブル関数

MATERIALIZED_VIEW_REFRESH_HISTORY

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

構文

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

引数

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

DATE_RANGE_START => 定数式. DATE_RANGE_END => 定数式

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

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

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

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

MATERIALIZED_VIEW_NAME => 文字列

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

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

使用上の注意

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

    注釈

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

  • 情報スキーマテーブル関数を呼び出す場合、セッションには使用中の 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'));

出力例を次に示します。

+-------------------------------+-------------------------------+--------------+-----------------------------------------+
| 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 |
+-------------------------------+-------------------------------+--------------+-----------------------------------------+

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

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

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

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

アカウント内の指定されたマテリアライズドビューの過去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'));