Bereitstellen von Dateien im Stagingbereich mit Snowsight

Mit Snowsight können Sie benannte Stagingbereiche erstellen und verwalten, ohne SQL-Code schreiben zu müssen. Sie können auch Dateien in einen benannten internen Stagingbereich hochladen, sodass Sie Ihre Dateien anzeigen, referenzieren oder in einem Python-Arbeitsblatt verwenden können. Oder Sie Laden die Daten aus den Dateien in eine Tabelle.

Sie können mit Snowsight keine Dateien in Benutzer-Stagingbereiche oder Tabellen-Stagingbereiche hochladen. Weitere Informationen zu Stagingbereichen finden Sie unter Übersicht zum Laden von Daten.

Unter diesem Thema:

Erstellen eines Stagingbereichs

Sie können Snowsight verwenden, um einen benannten internen oder externen Stagingbereich zu erstellen.

Bemerkung

Sie müssen eine Rolle verwenden, der die USAGE-Berechtigung für die Datenbank und das Schema, in denen der Stagingbereich gespeichert ist, sowie die CREATE STAGE-Berechtigung für das Schema erteilt wurden oder die diese Berechtigungen geerbt hat.

Weitere Informationen zu CREATE STAGE finden Sie unter Anforderungen an die Zugriffssteuerung.

Benannten internen Stagingbereich erstellen

Um mit Snowsight einen benannten internen Stagingbereich zu erstellen, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Data » Databases aus.

  3. Wählen Sie die Datenbank und das Schema aus, in denen Sie einen Stagingbereich erstellen möchten.

  4. Wählen Sie Create » Stage » Snowflake Managed aus.

  5. Geben Sie einen Stage Name ein.

  6. Optional können Sie Directory table deaktivieren. Verzeichnistabellen ermöglichen das Anzeigen von Dateien im Stagingbereich, erfordern jedoch ein Warehouse und sind daher mit Kosten verbunden. Sie können diese Option vorerst deaktivieren und eine Verzeichnistabelle später aktivieren.

  7. Wählen Sie unter Encryption den Typ der Verschlüsselung aus, der für alle in Ihrem Stagingbereich gespeicherten Dateien unterstützt wird. Weitere Informationen dazu finden Sie unter Verschlüsselung für interne Stagingbereiche. Sie können den Verschlüsselungstyp nicht mehr ändern, nachdem Sie den Stagingbereich erstellt haben.

    Bemerkung

    Um den Datenzugriff zu ermöglichen, empfehlen wir die Verwendung der serverseitigen Verschlüsselung. Andernfalls werden Stagingdateien standardmäßig clientseitig verschlüsselt und sind beim Herunterladen nicht lesbar. Weitere Informationen dazu finden Sie unter Serverseitige Verschlüsselung für Zugriff auf unstrukturierte Daten.

  8. Füllen Sie die Felder zur Beschreibung Ihres Stagingbereichs aus. Weitere Informationen dazu finden Sie unter CREATE STAGE.

  9. Wählen Sie Create aus.

Benannten externen Stagingbereich erstellen

Um mit Snowsight einen benannten externen Stagingbereich zu erstellen, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie im Navigationsmenü die Option Data » Databases aus.

  3. Wählen Sie die Datenbank und das Schema aus, in denen Sie einen Stagingbereich erstellen möchten.

  4. Wählen Sie Create » Stage aus.

  5. Wählen Sie den unterstützten Cloudspeicherdienst aus, in dem Ihre Dateien gespeichert sind.

  6. Geben Sie einen Stage Name ein.

  7. Geben Sie die URL Ihres externen Cloudspeicherortes ein.

  8. Wenn Ihr externer Speicher nicht öffentlich ist, aktivieren Sie Authentication, und geben Sie Ihre Daten ein. Weitere Informationen dazu finden Sie unter CREATE STAGE.

  9. Optional können Sie Directory table deaktivieren. Verzeichnistabellen ermöglichen das Anzeigen von Dateien im Stagingbereich, erfordern jedoch ein Warehouse und sind daher mit Kosten verbunden. Sie können diese Option vorerst deaktivieren und eine Verzeichnistabelle später aktivieren.

    Wenn Sie Directory table aktivieren, wählen Sie optional Enable auto-refresh aus, und wählen Sie die Ereignisbenachrichtigung oder Benachrichtigungsintegration aus, um die Verzeichnistabelle automatisch zu aktualisieren, wenn Dateien hinzugefügt oder entfernt werden. Weitere Informationen dazu finden Sie unter Automatisiertes Aktualisieren der Metadaten von Verzeichnistabellen.

  10. Wenn Ihre Dateien verschlüsselt sind, aktivieren Sie Encryption, und geben Sie Ihre Daten ein.

  11. Erweitern Sie optional SQL Preview (SQL-Vorschau), um eine generierte SQL-Anweisung anzuzeigen. Um für Ihren Stagingbereich zusätzliche Optionen wie AUTO_REFRESH festzulegen, können Sie die SQL-Vorschau in einem Arbeitsblatt öffnen.

  12. Wählen Sie Create aus.

Hochladen von Dateien in einen Stagingbereich

Sie können Snowsight verwenden, um Dateien in einen benannten internen Stagingbereich hochzuladen.

Zum Hochladen von Dateien in externe Stagingbereiche von Diensten wie Amazon S3, Microsoft Azure oder Google Cloud Storage verwenden Sie die jeweiligen Tools dieser Clouddienste.

Dateien in einen benannten internen Stagingbereich hochladen

Bemerkung

Die maximale Dateigröße beträgt 50 MB.

Um diese Schritte ausführen zu können, müssen Sie eine Rolle verwenden, der die USAGE-Berechtigung für die Datenbank und das Schema sowie die WRITE-Berechtigung für den Stagingbereich erteilt wurden oder die diese Berechtigungen geerbt hat. Weitere Informationen dazu finden Sie unter Berechtigungen von Stagingbereichen.

Um Dateien in Ihren Stagingbereich hochzuladen, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Data » Databases aus.

  3. Wählen Sie das Datenbankschema aus, in dem Sie den Stagingbereich erstellt haben, und wählen Sie den Stagingbereich aus.

  4. Wählen Sie + Files aus, um Dateien in den Stagingbereich hochzuladen.

  5. Wählen Sie im angezeigten Dialogfeld Upload Your Files die Dateien aus, die Sie hochladen möchten. Sie können mehrere Dateien auf einmal hochladen.

  6. Optional können Sie einen Pfad auswählen oder erstellen, in den Sie Ihre Dateien innerhalb des Stagingbereichs speichern möchten.

  7. Wählen Sie Upload aus.

Nachdem Sie Dateien in den Stagingbereich hochgeladen haben, können Sie je nach Datei eine der folgenden Aktionen durchführen:

Anzeigen von Stagingdateien

Sie können Stagingdateien mit Snowsight anzeigen. Sie können Dateien sowohl aus internen als auch aus externen Stagingbereichen anzeigen.

Bemerkung

Um diese Schritte ausführen zu können, müssen Sie eine Rolle verwenden, der die USAGE-Berechtigung für die Datenbank und das Schema sowie die READ-Berechtigung für den Stagingbereich erteilt wurden oder die diese Berechtigungen geerbt hat.

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Data » Databases aus.

  3. Wählen Sie die Datenbank und das Schema aus, die den Stagingbereich enthalten.

  4. Wählen Sie Stages aus, und wählen Sie den Stagingbereich aus, dessen Dateien Sie anzeigen möchten.

  5. Wenn Sie dazu aufgefordert werden, wählen Sie Enable Directory Table aus, um eine Verzeichnistabelle für den Stagingbereich zu aktivieren, damit Sie Dateien sehen können.

  6. Wenn Sie dazu aufgefordert werden, wählen Sie ein Warehouse aus, um die Verzeichnistabelle zu aktualisieren.

Um die Verzeichnistabelle eines Stagingbereichs zu aktualisieren, wählen Sie das Aktualisierungssymbol aus.

Verwalten von Stagingdateien

Sie können Snowsight verwenden, um die folgenden Aktionen auf Stagingdateien auszuführen:

Für Dateien in einem internen Stagingbereich können Sie auch die folgenden Aktionen ausführen:

  • Wählen Sie More options » Download aus, um die Datei aus dem Stagingbereich herunterzuladen.

  • Wählen Sie More options » Remove aus, um die Datei aus dem Stagingbereich zu entfernen.

Bemerkung

Informationen zum Herunterladen von Dateien aus einem externen Stagingbereich finden Sie unter Herunterladen von Stagingdateien in Snowsight.

Verwalten von Stagingbereichen

Um einen Stagingbereich in Snowsight zu verwalten, gehen Sie wie folgt vor:

Bemerkung

Um diese Schritte ausführen zu können, müssen Sie eine Rolle verwenden, der die USAGE-Berechtigung für die Datenbank und das Schema sowie die OWNERSHIP-Berechtigung für den Stagingbereich erteilt wurden oder die diese Berechtigungen geerbt hat.

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Data » Databases aus.

  3. Wählen Sie die Datenbank und das Schema aus, die den Stagingbereich enthalten.

  4. Wählen Sie Stages aus, und wählen Sie dann den Stagingbereich aus.

  5. Wählen Sie Stage Details aus.

Sie können den Stagingbereich auf folgende Weise verwalten:

  • Wählen Sie More options » Edit aus, um Eigenschaften zu bearbeiten oder eine Verzeichnistabelle für das Stagingobjekt zu aktivieren.

  • Wählen Sie More options » Clone aus, um den Stagingbereich zu klonen.

  • Wählen Sie More options » Drop aus, um den Stagingbereich zu löschen bzw. zu entfernen.

  • Wählen Sie More options » Transfer Ownership aus, um die OWNERSHIP-Berechtigungen des Stagingbereichs auf eine andere Rolle zu übertragen.

Wenn Sie Berechtigungen für den Stagingbereich verwalten möchten, verwenden Sie den Abschnitt Privileges, wo Sie Berechtigungen anzeigen, erteilen und entziehen können.

Problembehandlung

Dateien in externem Stagingbereich werden nicht angezeigt

Dieses Problem kann auftreten, wenn für einen externen Stagingbereich keine Verzeichnistabelle aktiviert ist oder wenn die Informationen zum externen Speicherort nicht korrekt sind.

Um dieses Problem zu beheben, versuchen Sie Folgendes:

  • Stellen Sie sicher, dass der Eigentümer des Stagingbereichs eine Verzeichnistabelle im Stagingbereich aktiviert hat.

  • Vergewissern Sie sich, dass die Verzeichnistabelle aktualisiert wurde. Um die Verzeichnistabelle zu aktualisieren, wählen Sie den Stagingbereich in Snowsight aus, und klicken Sie dann auf das Aktualisierungssymbol.

  • Überprüfen Sie, ob die Cloudanbieter-URL korrekt ist. Wenn die URL einen Unterpfad enthält, vergewissern Sie sich, dass ein abschließender Schrägstrich vorhanden ist.

Schaltfläche zum Hochladen der Dateien ist nicht verfügbar (inaktiv)

Dieses Problem kann auftreten, wenn Sie nicht über die erforderlichen Berechtigungen zum Hochladen von Dateien in einen internen Stufe Stagingbereich verfügen oder wenn gerade ein anderer Upload ausgeführt wird.

Um dieses Problem zu beheben, versuchen Sie Folgendes:

  • Vergewissern Sie sich, dass Sie einen internen Stagingbereich ausgewählt haben.

  • Sie müssen eine Rolle verwenden, der die USAGE-Berechtigung für die Datenbank und das Schema sowie die WRITE-Berechtigung für den Stagingbereich erteilt wurden oder die diese Berechtigungen geerbt hat.

  • Prüfen Sie, ob ein gerade ein anderer Upload ausgeführt wird. Wenn Sie den Mauszeiger über die inaktive Schaltfläche bewegen, werden Informationen zu laufenden Uploads angezeigt. Snowsight zeigt auch eine Benachrichtigung für laufende Uploads an. Wenn gerade ein anderer Upload ausgeführt wird, muss dieser abgeschlossen werden, bevor Sie weitere Dateien in den Stagingbereich hochladen können.