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:
Melden Sie sich bei Snowsight an.
Wählen Sie Data » Databases aus.
Wählen Sie die Datenbank und das Schema aus, in denen Sie einen Stagingbereich erstellen möchten.
Wählen Sie Create » Stage » Snowflake Managed aus.
Geben Sie einen Stage Name ein.
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.
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.
Füllen Sie die Felder zur Beschreibung Ihres Stagingbereichs aus. Weitere Informationen dazu finden Sie unter CREATE STAGE.
Wählen Sie Create aus.
Benannten externen Stagingbereich erstellen¶
Um mit Snowsight einen benannten externen Stagingbereich zu erstellen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Data » Databases aus.
Wählen Sie die Datenbank und das Schema aus, in denen Sie einen Stagingbereich erstellen möchten.
Wählen Sie Create » Stage aus.
Wählen Sie den unterstützten Cloudspeicherdienst aus, in dem Ihre Dateien gespeichert sind.
Geben Sie einen Stage Name ein.
Geben Sie die URL Ihres externen Cloudspeicherortes ein.
Wenn Ihr externer Speicher nicht öffentlich ist, aktivieren Sie Authentication, und geben Sie Ihre Daten ein. Weitere Informationen dazu finden Sie unter CREATE STAGE.
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.
Wenn Ihre Dateien verschlüsselt sind, aktivieren Sie Encryption, und geben Sie Ihre Daten ein.
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.
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 250 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:
Melden Sie sich bei Snowsight an.
Wählen Sie Data » Databases aus.
Wählen Sie das Datenbankschema aus, in dem Sie den Stagingbereich erstellt haben, und wählen Sie den Stagingbereich aus.
Wählen Sie + Files aus, um Dateien in den Stagingbereich hochzuladen.
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.
Optional können Sie einen Pfad auswählen oder erstellen, in den Sie Ihre Dateien innerhalb des Stagingbereichs speichern möchten.
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:
Verwenden der Dateien in einem Python-Arbeitsblatt. Weitere Informationen dazu finden Sie unter Python-Datei aus einem Stagingbereich zu einem Arbeitsblatt hinzufügen.
Kopieren der Daten aus den Stagingdateien in eine Tabelle. Weitere Informationen dazu finden Sie unter Dateien aus einem Stagingbereich in eine Tabelle laden oder Kopieren von Daten aus einem internen Stagingbereich.
Abfragen der Daten im Stagingbereich. Weitere Informationen dazu finden Sie unter Abfragen von Daten in Stagingdateien.
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.
Melden Sie sich bei Snowsight an.
Wählen Sie Data » Databases aus.
Wählen Sie die Datenbank und das Schema aus, die den Stagingbereich enthalten.
Wählen Sie Stages aus, und wählen Sie den Stagingbereich aus, dessen Dateien Sie anzeigen möchten.
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.
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:
Wählen Sie
» Load into table aus, um die Datei aus dem Stagingbereich in eine Tabelle zu laden.Wählen Sie
» Copy path aus, um den Pfad zur Datei zu kopieren und an anderer Stelle, z. B. in einem Arbeitsblatt, zu verwenden.
Für Dateien in einem internen Stagingbereich können Sie auch die folgenden Aktionen ausführen:
Wählen Sie
» Download aus, um die Datei aus dem Stagingbereich herunterzuladen.Wählen Sie
» 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.
Melden Sie sich bei Snowsight an.
Wählen Sie Data » Databases aus.
Wählen Sie die Datenbank und das Schema aus, die den Stagingbereich enthalten.
Wählen Sie Stages aus, und wählen Sie dann den Stagingbereich aus.
Wählen Sie Stage Details aus.
Sie können den Stagingbereich auf folgende Weise verwalten:
Wählen Sie
» Edit aus, um Eigenschaften zu bearbeiten oder eine Verzeichnistabelle für das Stagingobjekt zu aktivieren.Wählen Sie
» Clone aus, um den Stagingbereich zu klonen.Wählen Sie
» Drop aus, um den Stagingbereich zu löschen bzw. zu entfernen.Wählen Sie
» 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.