DYNAMIC_TABLE_REFRESH_HISTORY¶

構文¶

DYNAMIC_TABLE_REFRESH_HISTORY(
  [ DATA_TIMESTAMP_START => <constant_expr> ]
  [ , DATA_TIMESTAMP_END => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , NAME => '<string>' ]
  [ , NAME_PREFIX => '<string>' ]
  [ , ERROR_ONLY => { TRUE | FALSE } ]
)

引数¶

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

DATA_TIMESTAMP_START => constant_expr、 . DATA_TIMESTAMP_END => constant_expr

リフレッシュが発生した時間範囲（TIMESTAMP_LTZ形式）。

• 開始バージョンも終了バージョンも指定されていない場合、デフォルトの範囲は過去1日です。

• 終了バージョンが指定されていない場合は、 CURRENT_TIMESTAMP が範囲の終了として使用されます。

• 開始バージョンが指定されていない場合、範囲は DATE_TIMESTAMP_END の開始1日前から始まります。

RESULT_LIMIT => integer

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

結果にフィルターを適用するには、すべての動的テーブルにフィルターが適用されるように、 RESULT_LIMIT の制限値も十分に大容量に指定してください。

範囲: 1 ～ 10000

デフォルト: 100。

NAME => string

動的テーブルの名前。

名前は一重引用符で囲む必要があり、大文字と小文字は区別されません。

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

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

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

NAME_PREFIX => string

動的テーブルのプレフィックス。

名前のプレフィックスは一重引用符で囲む必要があり、大文字と小文字は区別されません。

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

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

ERROR_ONLY => TRUE | FALSE

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

出力¶

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

これらの列を表示するには、 MONITOR 権限を持つロールを使用する必要があります。詳細については、 動的テーブルのメタデータを表示する権限 をご参照ください。

使用上の注意¶

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

例¶

失敗したかキャンセルされたリフレッシュを取得します。

SELECT
  name,
  state,
  state_code,
  state_message,
  query_id,
  data_timestamp,
  refresh_start_time,
  refresh_end_time
FROM
  TABLE (
    INFORMATION_SCHEMA.DYNAMIC_TABLE_REFRESH_HISTORY (
      NAME_PREFIX => 'MYDB.MYSCHEMA.', ERROR_ONLY => TRUE
    )
  )
ORDER BY
  name,
  data_timestamp;

Copy