カテゴリ:

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

STAGE_STORAGE_USAGE_HISTORY

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

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

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

注釈

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

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

DATABASE_STORAGE_USAGE_HISTORYWAREHOUSE_METERING_HISTORY

構文

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

引数

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

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

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

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

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

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

使用上の注意

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

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