ディレクトリテーブル¶

ディレクトリテーブルとは¶

ディレクトリテーブルは、ステージで複数層になった暗黙のオブジェクトで（独立したデータベースオブジェクトではない）、ステージ内のデータファイルに関するファイルレベルのメタデータを格納するため、概念的には外部テーブルに似ています。ディレクトリテーブルには、独自の付与可能な権限はありません。

外部（外部クラウドストレージ）ステージと内部（Snowflake）ステージの両方でディレクトリテーブルをサポートします。ディレクトリテーブルは、ステージの作成時（CREATE STAGE を使用）またはそれ以降（ALTER STAGE を使用）にステージに追加できます。

特に、ディレクトリテーブルを使用すると、以下のような非構造化データのタスクを達成できます。

• ステージにあるすべての非構造化ファイルのリストをクエリする。ディレクトリテーブルをクエリして、ステージにあるすべてのファイルのリストを取得できます。クエリ出力には、サイズ、最終更新日時のタイムスタンプ、および Snowflakeファイル URL などの各ファイルに関する情報が含まれます。

• 非構造化データのビューを作成する。非構造化ファイルに関する追加データとメタデータを含んだSnowflakeテーブルとディレクトリテーブルを結合して、非構造化ファイルとその関連データを単一のビューで表示することができます。

• ファイル処理パイプラインを構築する。ディレクトリテーブルをSnowpark API または外部関数で使用して、ファイル処理パイプラインを作成できます。

ステージにファイルへの変更を登録するには、 ディレクトリテーブルのメタデータをリフレッシュ できます。

ディレクトリテーブルの請求¶

ディレクトリテーブルのメタデータの自動更新に関するイベント通知を管理するためのオーバーヘッドは料金に含まれています。このオーバーヘッドは、ディレクトリテーブルを含むステージのために、クラウドストレージに追加されるファイルの数に関連して増加します。Snowpipeはディレクトリテーブルの自動更新のイベント通知に使用されるため、このオーバーヘッド料金は請求明細書にSnowpipe料金として表示されます。この料金は、 PIPE_USAGE_HISTORY 関数をクエリするか、Account Usage PIPE_USAGE_HISTORY ビュー を調べると見積もることができます。

さらに、ディレクトリテーブルのメタデータを手動で更新する場合（ALTER STAGE ... REFRESH を使用）は、メンテナンスオーバーヘッドが若干請求されます。このオーバーヘッドは、Snowflakeにおける他の類似のアクティビティすべてと同様に、標準の クラウドサービス課金モデル に従って課金されます。ディレクトリテーブルメタデータの手動リフレッシュは、 PIPE_USAGE_HISTORY 関数へのクエリにも、Account Usage PIPE_USAGE_HISTORY ビュー にも表示されません。

ACCOUNTADMIN ロールを持つユーザー、または MONITOR USAGE グローバル権限を持つロールは、 AUTO_REFRESH_REGISTRATION_HISTORY テーブル関数にクエリを実行して、指定されたオブジェクトのメタデータに登録されているデータファイルの履歴と、これらの操作に対して請求されるクレジットを取得できます。

ディレクトリテーブルのアクセス制御要件¶

次の表は、ディレクトリテーブルを操作するときに一般的な SQL コマンドの実行に必要となる、ステージの 権限 をまとめたものです。

情報スキーマ¶

Snowflake Snowflake Information Schema には、ディレクトリテーブルに関する情報を取得するためにクエリできるテーブル関数が含まれています。