PIPE_USAGE_HISTORY ビュー¶

このAccount Usageビューを使用して、過去365日間（1年間）以内にSnowflakeテーブルにロードされたデータの履歴を Snowpipe を使用してクエリできます。ビューには、ロードされたデータの履歴と、Snowflakeアカウント全体の請求されたクレジットが表示されます。

列¶

列名	データ型	説明
PIPE_ID	NUMBER	データのロードに使用されるパイプの内部/システム生成識別子。クエリでパイプ名が指定されなかった場合、 NULL を表示します。各行には、時間範囲内で使用中のすべてのパイプの合計が含まれます。
PIPE_NAME	TEXT	パイプの名前。外部テーブルのメタデータを更新するために使用される、内部（非表示）パイプオブジェクトの NULL を表示します。
START_TIME	TIMESTAMP_LTZ	データのロードが行われた開始時間（ローカルタイムゾーン）。
END_TIME	TIMESTAMP_LTZ	データのロードが行われた終了時間（ローカルタイムゾーン）。
CREDITS_USED	NUMBER	START_TIME および END_TIME ウィンドウ中にSnowpipeデータのロードに対して請求されたクレジットの数。
BYTES_INSERTED	FLOAT	START_TIME および END_TIME ウィンドウ中にロードされたバイト数。
FILES_INSERTED	VARIANT	START_TIME および END_TIME ウィンドウ中にロードされたファイルの数。

ビューの待機時間は最大180分（3時間）です。
このビューのデータを ORGANIZATION USAGE スキーマの対応するビューと一致させるには、まずセッションのタイムゾーンを UTC に設定する必要があります。Account Usageビューをクエリする前に、次を実行します。
ALTER SESSION SET TIMEZONE = UTC;
Copy
データ圧縮とメンテナンスの過程で、Snowflakeクレジットが消費されることがあります。たとえば、返された結果が、0 BYTES_INSERTED と0 FILES_INSERTED でクレジットを消費したことを示す場合があります。これは、データがロードされてはいないものの、データの圧縮とメンテナンスのプロセスでクレジットが消費されていることを意味します。

Snowflakeは、Snowpipeファイル料金と同等の料金で、外部テーブルおよび外部ステージでのディレクトリテーブルの自動更新通知分を請求します。この PIPE_USAGE_HISTORY ビューまたは PIPE_USAGE_HISTORY 関数をクエリすると、外部テーブルとディレクトリテーブルの自動更新通知によって発生する料金を見積もることができます。自動更新パイプは NULL パイプ名の下にリストされることに注意してください。Information Schemaテーブル関数 AUTO_REFRESH_REGISTRATION_HISTORY を使用して、テーブルレベル/ステージレベルの粒度で外部テーブルの自動更新通知履歴を表示することもできます。

自動更新通知の課金を回避するには、外部テーブルとディレクトリテーブルの手動更新を実行します。外部テーブルの場合は、 ALTER EXTERNAL TABLE <名前> REFRESH ... ステートメントを使用して、外部テーブルを外部ストレージに手動で同期できます。ディレクトリテーブルの場合は、 ALTER STAGE <名前> REFRESH ... ステートメントを使用して、ディレクトリを外部ストレージに手動で同期できます。