Verwalten von Verzeichnistabellen¶

Syntax¶

-- 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>' ]

Wobei:

ENABLE = TRUE | FALSE

Gibt an, ob eine Verzeichnistabelle zum Stagingbereich hinzugefügt werden soll. Wenn der Wert TRUE ist, wird beim Erstellen des Stagingbereichs auch eine Verzeichnistabelle erstellt.

Standard: FALSE

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

Gibt den Typ der Verschlüsselung an, der für alle im Stagingbereich gespeicherten Dateien unterstützt wird.

TYPE = ...

Gibt den verwendeten Verschlüsselungstyp an. Mögliche Werte sind:

• SNOWFLAKE_FULL: Clientseitige Verschlüsselung. Die Dateien werden von einem Client verschlüsselt, wenn dieser sie mit PUT in den internen Stagingbereich hochlädt.

• SNOWFLAKE_SSE: Serverseitige Verschlüsselung. Die Dateien sind verschlüsselt, wenn sie im Stagingbereich ankommen.

  Geben Sie die serverseitige Verschlüsselung an, wenn Sie für Ihre Stagingdateien vorsignierte URLs abfragen möchten.

  Wenn die Dateien in einem Stagingbereich clientseitig verschlüsselt sind, können Benutzer die Stagingdateien nur lesen, wenn sie Zugriff auf den Verschlüsselungsschlüssel haben.

  Weitere Informationen zu internen benannten Stagingbereichen mit ausschließlich serverseitiger Verschlüsselung finden Sie unter CREATE STAGE.

Standard: SNOWFLAKE_FULL

Nutzungshinweise¶

• Nachdem Sie einen Stagingbereich mit einer Verzeichnistabelle erstellt haben, müssen Sie ALTER STAGE … REFRESH ausführen, um die Metadaten der Verzeichnistabelle manuell zu aktualisieren.

Beispiele¶

Erstellen Sie einen internen Stagingbereich namens mystage, der eine Verzeichnistabelle enthält. Der Stagingbereich verweist auf ein Dateiformat mit dem Namen myformat:

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

Copy

Erstellen Sie einen externen Stagingbereich namens mystage, die eine Verzeichnistabelle enthält. Der Stagingbereich verweist auf einen Bucket oder Container mit dem Namen load und dem Pfad files. Sicherer Zugriff auf den Cloudspeicherort wird über die Speicherintegration my_storage_int bereitgestellt:

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);

Manuelles Aktualisieren von Verzeichnistabellen¶

Aktualisieren Sie die Metadaten in einer Verzeichnistabelle manuell mit dem Befehl ALTER STAGE.

Beispiel:

ALTER STAGE mystage REFRESH;

Ausgabe¶

Die Ausgabe einer Verzeichnistabellenabfrage kann die folgenden Spalten enthalten:

Spalte	Datentyp	Beschreibung
RELATIVE_PATH	TEXT	Pfad zu den Dateien, auf die mit der Datei-URL zugegriffen werden soll.
SIZE	NUMBER	Größe der Datei (in Byte)
LAST_MODIFIED	TIMESTAMP_LTZ	Zeitstempel, wann die Datei im Stagingbereich zuletzt aktualisiert wurde
MD5	HEX	MD5-Prüfsumme für die Datei
ETAG	HEX	ETag-Header für die Datei
FILE_URL	TEXT	Snowflake-gehostete Datei-URL zu der Datei. Die Datei-URL hat das folgende Format: https://<account_identifier>/api/files/<db_name>.<schema_name>.<stage_name>/<relative_path> Copy Wobei: account_identifier Hostname des Snowflake-Kontos für Ihren Stagingbereich. Der Hostname beginnt mit einem eindeutigen Konto-Locator (von Snowflake bereitgestellt) und endet mit der Snowflake-Domain (snowflakecomputing.com): account_locator.snowflakecomputing.com Weitere Details dazu finden Sie unter Kontobezeichner. Bemerkung Für Business Critical-Konten wird der URL direkt vor snowflakecomputing.com ein privatelink-Segment vorangestellt (privatelink.snowflakecomputing.com), auch wenn private Konnektivität zum Snowflake-Dienst für Ihr Konto nicht aktiviert ist. db_name Name der Datenbank, die den Stagingbereich enthält, in dem sich Ihre Dateien befinden. schema_name Name des Schemas, das den Stagingbereich enthält, in dem sich Ihre Dateien befinden. stage_name Name des Stagingbereichs, in dem sich Ihre Dateien befinden. relative_path Pfad zu den Dateien, auf die mit der Datei-URL zugegriffen werden soll.

Nutzungshinweise¶

• Wenn aus einem internen Stagingbereich heruntergeladene Dateien beschädigt sind, überprüfen Sie mit dem Ersteller des Stagingbereichs, ob ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE') für den Stagingbereich eingestellt ist.

Beispiele¶

Abrufen aller Metadatenspalten in der Verzeichnistabelle eines Stagingbereichs namens mystage:

SELECT * FROM DIRECTORY(@mystage);

Rückgabe der FILE_URL-Spaltenwerte aus der gleichen Verzeichnistabelle. Gibt die Datei-URLs nur für Dateien zurück, die größer als 100 KB sind:

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

Rückgabe der FILE_URL-Spaltenwerte aus der gleichen Verzeichnistabelle. Gibt nur die Datei-URLs für kommagetrennte Wertedateien zurück:

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