PUT¶

Syntax¶

PUT file://<path_to_file>/<filename> internalStage
    [ PARALLEL = <integer> ]
    [ AUTO_COMPRESS = TRUE | FALSE ]
    [ SOURCE_COMPRESSION = AUTO_DETECT | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE ]
    [ OVERWRITE = TRUE | FALSE ]

Wobei:

internalStage ::=
    @[<namespace>.]<int_stage_name>[/<path>]
  | @[<namespace>.]%<table_name>[/<path>]
  | @~[/<path>]

Copy

Erforderliche Parameter¶

file://path_to_file/filename

Gibt die URI für die Datendateien auf dem Clientcomputer an. Dabei gilt Folgendes:

• path_to_file ist der Pfad zum lokalen Verzeichnis mit den hochzuladenden Dateien.

• filename ist der Name der hochzuladenden Datei. Sie können Platzhalter (*, ?) verwenden, um mehrere Dateien hochzuladen. Wenn der Verzeichnispfad oder der Dateiname Sonderzeichen oder Leerzeichen enthält, schließen Sie die gesamte Datei-URI in einfache Anführungszeichen ein.

Die URI-Formatierung ist je nach Client-Betriebssystem unterschiedlich.

Linux/macOS:

Sie müssen den ersten Schrägstrich in den Pfad einbeziehen. Für eine Datei mit dem Namen load verwenden Sie zum Beispiel file:///tmp/load.

Windows:

Sie müssen das Laufwerk und den Backslash in den Pfad einschließen und Backslash-Zeichen durch Schrägstriche ersetzen. Für eine Datei mit dem Namen load data verwenden Sie zum Beispiel file://C:/temp/load data.

internalStage

Gibt den Ort in Snowflake an, an den die Dateien hochgeladen werden sollen:

@[namespace.]int_stage_name[/path]	Dateien werden in den angegebenen benannten internen Stagingbereich hochgeladen.
@[namespace.]%table_name[/path]	Dateien werden für die angegebene Tabelle in den Stagingbereich hochgeladen.
@~[/path]	Dateien werden für den aktuellen Benutzer in den Stagingbereich hochgeladen.

Wobei:

• namespace ist die Datenbank oder das Schema, die/das den benannten internen Stagingbereich oder die Tabelle enthält. Die Angabe ist optional, wenn in der Sitzung eine Datenbank und ein Schema verwendet werden.

• path ist ein optionaler Pfad mit Unterscheidung von Groß-/Kleinschreibung für Dateien am Cloudspeicherort, wodurch der Zugriff auf bestimmte Dateien eingegrenzt wird. Pfade werden von den verschiedenen Cloudspeicherdiensten alternativ als Präfixe oder Ordner bezeichnet.

Bemerkung

Wenn der Stagingbereichsname oder der Pfad Leerzeichen oder Sonderzeichen enthält, muss er in einfache Anführungszeichen eingeschlossen werden. Verwenden Sie zum Beispiel '@"my stage"' für einen Stagingbereich namens "my stage".

Optionale Parameter¶

PARALLEL = integer

Gibt die Anzahl der Threads an, die zum Hochladen von Dateien verwendet werden sollen. Beim Hochladen werden die Batches der Datendateien nach Größe getrennt:

• Kleine Dateien (<64 MB komprimiert oder unkomprimiert) werden parallel als einzelne Dateien bereitgestellt.

• Größere Dateien werden automatisch in Blöcke aufgeteilt, gleichzeitig bereitgestellt und im Ziel-Stagingbereich wieder zusammengefügt. Ein einzelner Thread kann mehrere Blöcke hochladen.

Wenn Sie die Anzahl der Threads erhöhen, kann die Leistung beim Hochladen großer Dateien verbessert werden.

Unterstützte Werte: Jeder ganzzahlige Wert von 1 (keine Parallelität) bis 99 (99 Threads zum Hochladen von Dateien verwenden).

Standard: 4

Bemerkung

Für ältere Versionen von Snowflake-Treibern gilt ein Limit von 16 MB. Dazu zählen:

• JDBC-Treiberversionen vor 3.12.1

• ODBC-Treiberversionen vor 2.20.5

• Python-Konnektorversionen vor 2.2.0

AUTO_COMPRESS = TRUE | FALSE

Gibt an, ob Snowflake während des Uploads Dateien mit gzip komprimiert:

• TRUE: Snowflake komprimiert die Dateien (wenn sie nicht bereits komprimiert sind).

• FALSE: Snowflake komprimiert die Dateien nicht.

Diese Option unterstützt keine anderen Komprimierungstypen. Wenn Sie einen anderen Komprimierungstyp verwenden möchten, komprimieren Sie die Datei separat, bevor Sie den Befehl PUT ausführen. Identifizieren Sie dann den Komprimierungstyp mit der Option SOURCE_COMPRESSION.

Stellen Sie sicher, dass in Ihrem lokalen Ordner ausreichend Speicherplatz für Snowflake vorhanden ist, um die Datendateien vor dem Staging zu komprimieren. Stellen Sie bei Bedarf die Umgebungsvariable TEMP, TMPDIR oder TMP in Ihrem Betriebssystem so ein, dass sie auf einen lokalen Ordner verweist, der zusätzlichen freien Speicherplatz enthält.

Standard: TRUE

SOURCE_COMPRESSION = AUTO_DETECT | GZIP | BZ2 | BROTLI | ZSTD | DEFLATE | RAW_DEFLATE | NONE

Gibt die Komprimierungsmethode für bereits komprimierte Dateien an, die im Stagingbereich bereitgestellt werden:

Unterstützte Werte	Anmerkungen
AUTO_DETECT	Der Komprimierungsalgorithmus wird automatisch erkannt, mit Ausnahme von Brotli-komprimierten Dateien, die derzeit nicht automatisch erkannt werden können. Wenn Sie Brotli-komprimierte Dateien laden, verwenden Sie explizit BROTLI anstelle von AUTO_DETECT.
GZIP
BZ2
BROTLI	Muss beim Laden von Brotli-komprimierten Dateien verwendet werden.
ZSTD	Zstandard v0.8 (und höher) wird unterstützt.
DEFLATE	Deflate-komprimierte Dateien (mit zlib-Header, RFC1950).
RAW_DEFLATE	Raw Deflate-komprimierte Dateien (ohne Header, RFC1951).
NONE	Zu ladende Datendateien wurden nicht komprimiert.

Standard: AUTO_DETECT

Bemerkung

Snowflake verwendet diese Option, um zu ermitteln, wie die Datendateien komprimiert wurden, sodass sie dekomprimiert und die Daten zum Laden extrahiert werden können. Diese Option wird nicht verwendet, um die Dateien zu komprimieren.

Das Hochladen von Dateien, die mit anderen Dienstprogrammen komprimiert wurden, wird derzeit nicht unterstützt.

OVERWRITE = TRUE | FALSE

Gibt an, ob Snowflake beim Hochladen eine vorhandene Datei mit demselben Namen überschreibt:

• TRUE: Eine vorhandene Datei mit demselben Namen wird überschrieben.

• FALSE: Eine vorhandene Datei mit demselben Namen wird nicht überschrieben.

  Beachten Sie, dass eine LIST-Operation im Stagingbereich im Hintergrund ausgeführt wird, was die Leistung der PUT-Operation beeinträchtigen kann.

  Wenn der Versuch, PUT auf einer Datei auszuführen, fehlschlägt, weil eine Datei mit demselben Namen im Ziel-Stagingbereich vorhanden ist, stehen die folgenden Optionen zur Verfügung:

  • Laden Sie die Daten aus der vorhandenen Datei in eine oder mehrere Tabellen, und entfernen Sie die Datei aus dem Stagingbereich. Führen Sie den PUT-Befehl erneut auf einer Datei aus, die neue oder aktualisierte Daten enthält, um sie in den Stagingbereich hochzuladen.

  • Benennen Sie die lokale Datei um, und führen Sie dann die PUT-Operation erneut aus.

  • Verwenden Sie die PUT-Anweisung mit OVERWRITE = TRUE. Tun Sie dies nur, wenn es tatsächlich sicher ist, eine Datei mit Daten zu überschreiben, die möglicherweise noch nicht in Snowflake geladen wurden.

Beachten Sie, dass bei Hosting Ihres Snowflake-Kontos auf Google Cloud Platform PUT-Anweisungen nicht erkannt werden, wenn der Parameter OVERWRITE auf TRUE gesetzt ist. Eine PUT-Operation überschreibt immer alle vorhandenen Dateien im Ziel-Stagingbereich mit den lokalen Dateien, die Sie hochladen.

Die folgenden Clients unterstützen die OVERWRITE-Option bei Snowflake-Konten, die auf Amazon Web Services oder Microsoft Azure gehostet werden:

• SnowSQL

• Snowflake-ODBC-Treiber:

• Snowflake-JDBC-Treiber:

• Snowflake-Konnektor für Python

Unterstützte Werte: TRUE, FALSE.

Standard: FALSE.

Nutzungshinweise¶

• Der Befehl kann nicht über die Seite Worksheets der Snowflake-Weboberfläche ausgeführt werden. Verwenden Sie stattdessen den SnowSQL-Client oder Treiber, um Datendateien hochzuladen, oder informieren Sie sich in der Dokumentation des jeweiligen Snowflake-Clients über die Verwendung dieses Befehls.

• Der Befehl unterstützt nicht das Hochladen mehrerer Dateien mit abweichenden Verzeichnispfaden, da die Verzeichnisstruktur des Dateisystems beim Hochladen von Dateien in Ihren Stagingbereich nicht erhalten bleibt.

  Die folgende PUT-Anweisung gibt zum Beispiel einen Fehler zurück, da Sie nicht mehrere Dateien in verschachtelten Unterverzeichnissen angeben können.

  PUT file:///tmp/data/** @my_int_stage AUTO_COMPRESS=FALSE;
  

  Copy

• Datei-Globbing-Muster werden wie Platzhalter unterstützt, es sei denn, die Dateien, die dem Muster entsprechen, haben abweichende Verzeichnispfade.

• Mit diesem Befehl können Dateien nicht erstellt oder umbenannt werden.

• Alle Dateien, die in internen Stagingbereichen zum Laden/Entladen von Daten gespeichert werden, werden serverseitig automatisch mit starker AES-256-Verschlüsselung verschlüsselt. Snowflake bietet standardmäßig eine zusätzliche clientseitige Verschlüsselung mit einem 128-Bit-Schlüssel (mit der Option, einen 256-Bit-Schlüssel zu konfigurieren). Weitere Informationen dazu finden Sie unter Verschlüsselungstypen für interne Stagingbereiche.

• Der Befehl ignoriert alle doppelten Dateien, die Sie in denselben Stagingbereich hochladen möchten. Eine doppelte Datei ist eine nicht geänderte Datei, die den gleichen Namen wie eine bereits vorhandene Stagingdatei hat.

  Um eine bereits vorhandene Stagingdatei zu überschreiben, müssen Sie die hochgeladene Datei so ändern, dass sie sich von der Stagingdatei unterscheidet. Dies führt zu einer neuen Prüfsumme für die neue bereitgestellte Stagingdatei.

Beispiele¶

Laden Sie eine Datei mit dem Namen mydata.csv im Verzeichnis /tmp/data (in einer Linux- oder macOS-Umgebung) in einen internen Stagingbereich mit dem Namen my_int_stage hoch:

PUT file:///tmp/data/mydata.csv @my_int_stage;

Copy

Laden Sie eine Datei mit dem Namen orders_001.csv im Verzeichnis /tmp/data (in einer Linux- oder macOS-Umgebung) in den Stagingbereich der Tabelle orderstiny_ext hoch, wobei die automatische Datenkomprimierung deaktiviert ist:

PUT file:///tmp/data/orders_001.csv @%orderstiny_ext AUTO_COMPRESS=FALSE;

Copy

Gleiches Beispiel wie oben, jedoch mit Platzhalterzeichen im Dateinamen zum Hochladen mehrerer Dateien:

PUT file:///tmp/data/orders_*01.csv @%orderstiny_ext AUTO_COMPRESS=FALSE;

Copy

Laden Sie eine Datei mit dem Namen mydata.csv in das Verzeichnis C:\temp\data (in einer Windows-Umgebung) im Stagingbereich des aktuellen Benutzers unter Verwendung der automatischen Datenkomprimierung hoch:

PUT file://C:/temp/data/mydata.csv @~ AUTO_COMPRESS=TRUE;

Copy

Ähnlich wie im vorherigen Beispiel, aber laden Sie die Datei aus dem Verzeichnis C:\temp\load data hoch (in einer Windows-Umgebung):

PUT 'file://C:/temp/load data/mydata.csv' @~ AUTO_COMPRESS=TRUE;

Copy