カテゴリ:

Information Schema、 テーブル関数

STAGE_STORAGE_USAGE_HISTORY

このテーブル関数は、指定した日付範囲内のアカウントの すべての アカウントのSnowflakeステージの1日あたりの平均データストレージ使用量をバイト単位でクエリするために使用できます。出力には、次のストレージが含まれます。

  • 名前付き内部ステージ。

  • デフォルトのステージング領域（テーブルとユーザー用）。

注釈

この関数は、過去6か月以内のステージストレージ使用量を返します。

こちらもご参照ください。

DATABASE_STORAGE_USAGE_HISTORY、 WAREHOUSE_METERING_HISTORY

構文

STAGE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )
Copy

引数

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

DATE_RANGE_START => constant_expr、 . DATE_RANGE_END => constant_expr

ステージストレージの使用状況を取得するための、過去6か月以内の日付範囲です。

  • 終了日が指定されていない場合は、 CURRENT_DATE が範囲の終了として使用されます。

  • 開始日が指定されていない場合は、 DATE_RANGE_END が範囲の開始として使用されます（つまり、デフォルトは1日分のストレージ使用量）。

範囲が過去6か月外の場合、エラーが返されます。

使用上の注意

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

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

出力

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

列名

データ型

説明

USAGE_DATE

DATE

このストレージ使用記録の日付（ UTC タイムゾーン）

AVERAGE_STAGE_BYTES

NUMBER

使用されるステージストレージのバイト数

例

アカウントのすべての内部ステージについて、過去10日間の1日の平均ストレージ使用量を取得します。

select *
from table(information_schema.stage_storage_usage_history(dateadd('days',-10,current_date()),current_date()));
Copy
言語: 日本語