ディレクトリテーブルの管理¶

構文¶

-- Internal stage
CREATE [ OR REPLACE ] [ TEMPORARY ] STAGE [ IF NOT EXISTS ] <internal_stage_name>
  [ DIRECTORY = ( { ENABLE = TRUE | FALSE } ) ]
  [ ENCRYPTION = (TYPE = 'SNOWFLAKE_FULL' | TYPE = 'SNOWFLAKE_SSE') ]
  [ FILE_FORMAT = ( { FORMAT_NAME = '<file_format_name>' | TYPE = { CSV | JSON | AVRO | ORC | PARQUET | XML } [ formatTypeOptions ] } ) ]
  [ COPY_OPTIONS = ( copyOptions ) ]
  [ COMMENT = '<string_literal>' ]

-- External stage
CREATE [ OR REPLACE ] [ TEMPORARY ] STAGE [ IF NOT EXISTS ] <external_stage_name>
      <cloud_storage_access_settings>
    [ DIRECTORY = ( { ENABLE = TRUE | FALSE } ) ]
    [ FILE_FORMAT = ( { FORMAT_NAME = '<file_format_name>' | TYPE = { CSV | JSON | AVRO | ORC | PARQUET | XML } [ formatTypeOptions ] } ) ]
    [ COPY_OPTIONS = ( copyOptions ) ]
    [ COMMENT = '<string_literal>' ]

条件:

ENABLE = TRUE | FALSE

ディレクトリテーブルをステージに追加するかどうかを指定します。値が TRUE の場合は、ステージとともにディレクトリテーブルが作成されます。

デフォルト: FALSE

[ ENCRYPTION = (TYPE = 'SNOWFLAKE_FULL' | TYPE = 'SNOWFLAKE_SSE') ]

ステージに格納されているすべてのファイルでサポートされている暗号化の型を指定します。

TYPE = ...

使用される暗号化タイプを指定します。可能な値は次のとおりです。

• SNOWFLAKE_FULL: クライアント側の暗号化。ファイルは、クライアントが PUT を使用して内部ステージにアップロードするときに暗号化されます。

• SNOWFLAKE_SSE: サーバー側の暗号化。ファイルは、ステージに着信した時に暗号化されます。

  ステージングされたファイルに対して事前署名されたURLsをクエリする場合は、サーバー側の暗号化を指定します。

  ステージ内のファイルがクライアント側で暗号化されている場合、ユーザーは暗号化キーにアクセスせずにステージングされたファイルを読み取ることはできません。

  サーバー側の暗号化のみを使用する内部の名前付きステージの詳細については、 CREATE STAGE をご参照ください。

デフォルト: SNOWFLAKE_FULL

使用上の注意¶

• ディレクトリテーブルを使用してステージを作成した後、 ALTER STAGE ... REFRESH を実行して、ディレクトリテーブルのメタデータを手動で更新する 必要 があります。

例¶

ディレクトリテーブルを含む mystage という名前の内部ステージを作成します。ステージは myformat という名前のファイル形式を参照します。

CREATE STAGE mystage
  DIRECTORY = (ENABLE = TRUE)
  FILE_FORMAT = myformat;

Copy

ディレクトリテーブルを含む mystage という名前の外部ステージを作成します。ステージは、パスが files で load という名前のバケットまたはコンテナーを参照します。 my_storage_int ストレージ統合により、クラウドストレージの場所への安全なアクセスが提供されます。

Amazon S3

CREATE STAGE mystage
  URL='s3://load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (ENABLE = TRUE);

Google Cloud Storage

CREATE STAGE mystage
  URL='gcs://load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (ENABLE = TRUE);

Microsoft Azure

CREATE STAGE mystage
  URL='azure://myaccount.blob.core.windows.net/load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (ENABLE = TRUE);

ディレクトリテーブルの手動更新¶

ALTER STAGE コマンドを使用して、ディレクトリテーブルのメタデータを手動で更新します。

例:

ALTER STAGE mystage REFRESH;

出力¶

ディレクトリテーブルのクエリからの出力には、次の列が含まれる場合があります。

列	データ型	説明
RELATIVE_PATH	TEXT	ファイル URL を使用してアクセスするファイルへのパス。
SIZE	NUMBER	ファイルのサイズ（バイト単位）
LAST_MODIFIED	TIMESTAMP_LTZ	ステージでファイルが最後に更新されたときのタイムスタンプ。
MD5	HEX	ファイル用 MD5 チェックサム。
ETAG	HEX	ファイル用 ETag ヘッダー。
FILE_URL	TEXT	ファイルに対するSnowflakeホストファイルの URL。 ファイル URL の形式は次のとおりです。 https://<account_identifier>/api/files/<db_name>.<schema_name>.<stage_name>/<relative_path> Copy 条件: account_identifier 使用するステージのSnowflakeアカウントのホスト名。ホスト名は、アカウントロケーター（Snowflakeが提供）で始まり、Snowflakeドメイン（snowflakecomputing.com）で終わります。 account_locator.snowflakecomputing.com 詳細については、 アカウント識別子 をご参照ください。 注釈 Business Critical アカウントの場合は、アカウントでSnowflakeサービスへのプライベート接続が有効になっていなくても、 snowflakecomputing.com （privatelink.snowflakecomputing.com）の直前の URL に privatelink セグメントが追加されます。 db_name ファイルが配置されているステージを含むデータベースの名前。 schema_name ファイルが配置されているステージを含むスキーマの名前。 stage_name ファイルが配置されているステージの名前。 relative_path ファイル URL を使用してアクセスするファイルへのパス。

使用上の注意¶

• 内部ステージからダウンロードしたファイルが破損している場合は、ステージに ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE') が設定されていることをステージの作成者で確認してください。

例¶

mystage という名前のステージのディレクトリテーブル内にあるすべてのメタデータ列を取得します。

SELECT * FROM DIRECTORY(@mystage);

同じディレクトリテーブルから FILE_URL 列の値を返します。サイズが100 Kバイトより大きいファイルの場合にのみファイル URLs を返します。

SELECT FILE_URL FROM DIRECTORY(@mystage) WHERE SIZE > 100000;

同じディレクトリテーブルから FILE_URL 列の値を返します。コンマ区切りの値ファイルの場合にのみ、ファイル URLs を返します。

SELECT FILE_URL FROM DIRECTORY(@mystage) WHERE RELATIVE_PATH ILIKE '%.csv';