- スキーマ:
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;
Snowflakeは、Snowpipeファイル料金と同等の料金で、外部テーブルおよび外部ステージでのディレクトリテーブルの自動更新通知分を請求します。この PIPE_USAGE_HISTORY ビューまたは PIPE_USAGE_HISTORY 関数をクエリすると、外部テーブルとディレクトリテーブルの自動更新通知によって発生する料金を見積もることができます。自動更新パイプは NULL パイプ名の下にリストされることに注意してください。Information Schemaテーブル関数 AUTO_REFRESH_REGISTRATION_HISTORY を使用して、テーブルレベル/ステージレベルの粒度で外部テーブルの自動更新通知履歴を表示することもできます。
自動更新通知の課金を回避するには、外部テーブルとディレクトリテーブルの手動更新を実行します。外部テーブルの場合は、 ALTER EXTERNAL TABLE <名前> REFRESH ... ステートメントを使用して、外部テーブルを外部ストレージに手動で同期できます。ディレクトリテーブルの場合は、 ALTER STAGE <名前> REFRESH ... ステートメントを使用して、ディレクトリを外部ストレージに手動で同期できます。