Verwalten und Verwenden von Arbeitsblättern in Snowsight¶
Arbeitsblätter bieten eine leistungsfähige und vielseitige Methode zum Ausführen von SQL-Abfragen oder Python-Code oder zum Durchführen anderer Snowflake-Aufgaben wie Laden von Daten, Datendefinition und Datenbearbeitung.
Nachdem Sie ein Arbeitsblatt in Snowsight geöffnet haben, können Sie folgende Aktionen ausführen:
Arbeitsblätter in Ordnern organisieren und Änderungen vornehmen, z. B. die Aktualisierung des Namens
Arbeitsblätter wiederherstellen, die einem gelöschten Benutzer gehören
Außerdem können Sie SQL-Anweisungen schreiben und die Ergebnisse visualisieren. Sie können auch Python-Code schreiben.
Andere Arbeitsblätter von einem Arbeitsblatt aus durchsuchen¶
Wenn Sie ein Arbeitsblatt öffnen, können Sie auch andere Arbeitsblätter im Worksheets-Explorer anzeigen. Sie können im Worksheets-Explorer nach anderen Arbeitsblättern suchen und Arbeitsblätter verwalten.
Anzeigen von Arbeitsblattinhalten in der Vorschau¶
Um den Inhalt eines Arbeitsblatts in der Vorschau anzuzeigen, können Sie im Worksheets-Explorer den Mauszeiger auf den Namen des Arbeitsblatts führen. In der Vorschau wird auch die Rolle angezeigt, die zum Ausführen des Arbeitsblatts verwendet wird.
In der Vorschau können Sie auch die Inhalte des Arbeitsblatts kopieren. Bewegen Sie den Mauszeiger über die Vorschau des Arbeitsblattinhalts, und wählen Sie die angezeigte Schaltfläche Copy aus.
Arbeitsblätter mit Tastaturkürzeln aktualisieren¶
Snowsight bietet Tastenkombinationen, mit denen Sie in Arbeitsblättern schnell in Abfragen navigieren und die Abfragen bearbeiten können. So können Sie beispielsweise mithilfe der Tastaturkürzel den Cursor innerhalb des Arbeitsblatts bewegen, „Suchen und Ersetzen“ ausführen, Zeilen kopieren, Abfragen formatieren und vieles mehr.
Um alle verfügbaren Tastaturkürzel anzuzeigen, öffnen Sie ein Arbeitsblatt und drücken Sie [CMD] + [SHIFT] + [?] auf einer Mac-Tastatur bzw. [STRG] + [SHIFT] + [?] auf einer Windows-Tastatur.
Sie können auch den Mauszeiger über die Registerkarte des Arbeitsblatts bewegen und und dann Show Shortcuts wählen, um die Tastenkombinationen anzuzeigen.
Sitzungskontext für ein Arbeitsblatt ändern¶
Legen Sie den Sitzungskontext für ein Arbeitsblatt fest, indem Sie die Rolle und das Warehouse definieren, die zur Ausführung der Abfragen bzw. des Codes in einem Arbeitsblatt verwendet werden sollen. Der Kontext des Arbeitsblatts bleibt für zukünftige Sitzungen erhalten.
Bemerkung
Beachten Sie, dass Sie immer nur eine Rolle auswählen können. Die Kontextauswahl unterstützt keine Sekundärrollen. Um Sekundärrollen in einem SQL-Arbeitsblatt zu aktivieren, führen Sie USE SECONDARY ROLES aus.
Der Rollenkontext eines Arbeitsblatts bestimmt anhand der Zugriffssteuerungsrechte, die der Rolle erteilt wurden, welche Operationen auf Snowflake-Objekten ausgeführt werden dürfen.
Um den Sitzungskontext für ein Arbeitsblatt festzulegen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Öffnen Sie die Kontextauswahl.
Wählen Sie die Rolle aus, mit der das Arbeitsblatt ausgeführt werden soll.
Wählen Sie ein Warehouse aus, für das die Rolle Berechtigungen hat.
Wählen Sie eine beliebige Stelle außerhalb der Dropdown-Liste aus, um die Kontextauswahl wieder zu schließen.
Bemerkung
Jedes Arbeitsblatt hat eine eindeutige Sitzung und kann andere Rollen verwenden als die, die Sie im Kontomenü festgelegt haben (Ihre aktive Rolle). Wenn Sie Ihre aktive Rolle ändern, ändert dies nicht die Rolle, die dem Arbeitsblatt mit der Kontextauswahl zugewiesen wurde.
Anhalten und Fortsetzen von Warehouses¶
Vor oder nach Ausführung Ihres Arbeitsblatts müssen Sie Ihr Warehouse möglicherweise fortsetzen oder dessen Größe ändern.
Sie müssen über MODIFY- oder OWNERSHIP-Berechtigungen für das Warehouse verfügen, um Warehouse-Details zu ändern.
Gehen Sie wie folgt vor, um Warehouse-Details über die Kontextauswahl anzuzeigen und anzupassen:
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Öffnen Sie die Kontextauswahl.
Wählen Sie das Symbol Show warehouse details aus.
Wählen Sie für die Option Status den Status aus, und wählen Sie Resume aus, falls das Warehouse gerade angehalten ist.
Wählen Sie für die Option Size die Größe aus, und wählen Sie eine andere Größe.
Wählen Sie eine beliebige Stelle außerhalb der Dropdown-Liste aus, um die Kontextauswahl wieder zu schließen.
Verwalten von geöffneten Arbeitsblättern¶
Wählen Sie nach dem Öffnen eines Arbeitsblatts die Option aus, die sichtbar ist, wenn Sie den Mauszeiger über die Registerkarte eines Arbeitsblatts bewegen, um das geöffnete Arbeitsblatt auf folgende Weise zu verwalten:
Benennen Sie das Arbeitsblatt um.
Verschieben Sie das Arbeitsblatt in einen Ordner oder ein Dashboard.
Duplizieren Sie das Arbeitsblatt.
Löschen Sie das Arbeitsblatt.
Wenn ein Arbeitsblatt geöffnet ist, können Sie auch andere Arbeitsblätter im Worksheets-Explorer anzeigen und verwalten:
Suche Sie nach anderen Arbeitsblättern.
Um ein Arbeitsblatt umzubenennen, zu duplizieren, zu löschen oder zu verschieben, wählen Sie aus, das angezeigt wird, wenn Sie den Mauszeiger über den Namen des Arbeitsblatts bewegen.
Ermitteln Sie anhand des Arbeitsblattsymbols, welche Arbeitsblätter auf einer Registerkarte geöffnet sind. Ein ausgefülltes Symbol zeigt an, dass ein Arbeitsblatt auf einer Registerkarte geöffnet ist.
Organisieren von Arbeitsblättern in Ordnern¶
Mit Snowsight können Sie Arbeitsblätter in Ordnern organisieren und verwalten.
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus.
Wählen Sie ein Arbeitsblatt aus, um es zu öffnen.
Bewegen Sie den Mauszeiger über die Registerkarte des Arbeitsblatts, und wählen Sie aus.
Wählen Sie in der Dropdown-Liste die Option Move aus, und wählen Sie dann einen Ordner oder ein Dashboard aus, wohin das Arbeitsblatt verschoben werden soll, oder erstellen Sie einen Ordner oder ein Dashboard.
Verwalten von Arbeitsblattverlauf und Versionen¶
Neue Versionen eines Arbeitsblatts werden gespeichert, wenn Sie Änderungen an einer SQL-Abfrage oder dem Code im Worksheet vornehmen oder die Abfrage bzw. den Code ausführen.
Wenn Sie Änderungen an Arbeitsblättern vornehmen und Arbeitsblattversionen verwalten, müssen Sie Folgendes beachten:
Wenn Sie ein Arbeitsblatt für andere Benutzer freigeben, können Benutzer mit Bearbeitungsberechtigung frühere Versionen des Arbeitsblatts einsehen. Alle Benutzer, für die Sie ein Arbeitsblatt freigeben, können die Ergebnisse der aktuellsten Version des Arbeitsblatts anzeigen.
Jedes Mal, wenn jemand mit den entsprechenden Berechtigungen ein Arbeitsblatt ausführt, wird eine neue Version des Arbeitsblatts gespeichert.
Wenn Sie Änderungen an dem Arbeitsblatt vornehmen und diese scheinbar verschwinden, verwenden Sie den Versionsverlauf, um den gespeicherten Entwurf mit Ihren Änderungen zu öffnen.
Die zuletzt ausgeführte Version des Arbeitsblatts ist die Version, die für die anderen Mitbenutzer sichtbar ist.
Wenn Sie an einem Arbeitsblatt Änderungen vornehmen, die für die Benutzer, für die Sie das Arbeitsblatt freigegeben haben, sichtbar sein sollen, müssen Sie das Arbeitsblatt ausführen.
Wenn ein freigegebenes Arbeitsblatt von mehreren Benutzern gleichzeitig bearbeitet und ausgeführt wird, wird bei jeder Ausführung des Arbeitsblatts eine neue Version erstellt. Die zuletzt ausgeführte Version des Arbeitsblatts ist diejenige, die angezeigt wird, wenn Sie das Arbeitsblatt öffnen oder aktualisieren.
Umschalten zwischen Versionen des Arbeitsblatts¶
Wenn Sie frühere Versionen eines Arbeitsblatts anzeigen möchten, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Wählen Sie für das Arbeitsblatt die Option Code Versions aus.
Wählen Sie in der Liste der Arbeitsblattversionen den Zeitstempel der Version aus, die Sie anzeigen möchten.
Überprüfen Sie die Arbeitsblattdetails dieser Version, und erstellen Sie optional eine Kopie.
Wählen Sie Close aus, um zur aktuellen Version des Arbeitsblatts zurückzukehren.
Wenn Sie die Ergebnisse einer früheren Ausführung des Arbeitsblatts anzeigen möchten, öffnen Sie den Abfrageverlauf für das Arbeitsblatt. Siehe Abfrageverlauf anzeigen.
Gespeicherte Ergebnisse von früheren Arbeitsblattversionen¶
Die Ergebnisse von Abfragen, die in Arbeitsblättern ausgeführt werden, werden bis zu 90 Tage oder 25 Arbeitsblattversionen zwischengespeichert, je nachdem, welcher Wert größer ist. Dieser Cache ist in der Datenspeichernutzung für Ihr Konto enthalten.
Arbeitsblätter wiederherstellen, die einem gelöschten Benutzer gehören¶
Wenn Sie einen Benutzer löschen, können Sie bis zu 500 Arbeitsblätter wiederherstellen, die diesem Benutzer gehören. Um die Arbeitsblätter wiederherzustellen, gehen Sie wie folgt vor:
Laden Sie die wiederhergestellten Arbeitsblättern herunter, die einem gelöschten Benutzer gehören.
Erstellen Sie Arbeitsblätter aus einer SQL-Datei, um die wiederhergestellten Arbeitsblätter wieder zu Snowflake hinzuzufügen.
Wenn Sie die Eigentümerschaft der Arbeitsblätter ändern oder den Zugriff auf die Arbeitsblätter beibehalten möchten, bevor Sie einen Benutzer löschen, bitten Sie diesen Benutzer, die Arbeitsblätter freizugeben. Siehe Freigeben von Arbeitsblättern und Ordnern.
Wiederhergestellte Arbeitsblätter herunterladen, die einem gelöschten Benutzer gehören¶
Um Arbeitsblätter wiederherzustellen, die einem gelöschten Benutzer gehören, laden Sie eine .tar.gz
-Archivdatei mit bis zu 500 Arbeitsblättern herunter, die diesem Benutzer gehören.
Bemerkung
Sie müssen über die Rolle ACCOUNTADMIN verfügen, um Arbeitsblätter von gelöschten Benutzern wiederherzustellen.
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus.
Geben Sie im Dialogfeld den Benutzernamen des in Ihrem Konto gelöschten Benutzers ein.
Wichtig
Die Groß-/Kleinschreibung des Benutzernamens muss genau mit dem Benutzernamen übereinstimmen, wie er in Snowflake gespeichert wurde.
Wählen Sie Recover aus.
Ihr Webbrowser lädt eine
.tar
-Datei mit bis zu 500 Arbeitsblättern herunter. Wenn der gelöschte Benutzer mehr als 500 Arbeitsblätter hat, werden nur die 500 zuletzt geänderten Arbeitsblätter heruntergeladen.
Nach dem Herunterladen von Arbeitsblättern, die einem gelöschten Benutzer gehören, fügen Sie die wiederhergestellten Arbeitsblätter zu Snowsight hinzu, indem Sie Arbeitsblätter aus den SQL-Dateien erstellen.
Sie müssen die heruntergeladene .tar
-Datei erst in einen Ordner mit .sql
-Dateien extrahieren, bevor Sie wiederhergestellte Arbeitsblätter zu Snowsight hinzufügen können. Sie können jeweils nur ein Arbeitsblatt zu Snowsight hinzufügen, und der Benutzer, der die wiederhergestellten Arbeitsblätter zu Snowsight hinzufügt, wird der neue Eigentümer der Arbeitsblätter.
Weitere Informationen dazu finden Sie unter Arbeitsblätter aus einer SQL-Datei erstellen.
Hinweise zum Wiederherstellen von Arbeitsblättern, die gelöschten Benutzern gehören¶
Hinweise zum Wiederherstellen von Arbeitsblättern:
Es werden nur der Titel und der Inhalt der zuletzt ausgeführten Version eines Arbeitsblatts wiederhergestellt. Arbeitsblattversionsverlauf, Freigabeempfänger und -berechtigungen, Abfrageergebnisse und Arbeitsblattmetadaten werden nicht wiederhergestellt.
Es werden maximal 500 Arbeitsblätter wiederhergestellt. Bei gelöschten Benutzern mit mehr als 500 Arbeitsblättern werden nur die 500 zuletzt geänderten Arbeitsblätter wiederhergestellt.
Nur Arbeitsblätter in Snowsight werden wiederhergestellt. Arbeitsblätter der klassischen Weboberfläche, die gelöschten Benutzern gehören, können mit dieser Methode nicht wiederhergestellt werden.
Wenn mehrere gelöschte Benutzer denselben Benutzernamen haben, werden die Arbeitsblätter wiederhergestellt, die allen gelöschten Benutzern mit diesem Benutzernamen gehören.
Wenn das Wiederherstellen des Arbeitsblatts aus unerwarteten Gründen fehlschlägt, wenden Sie sich an den Snowflake-Support.
Interne Snowflake-Objekte für Arbeitsblätter¶
Snowflake erstellt die folgenden internen Objekte, um die Verwendung von Arbeitsblättern über die Snowsight zu unterstützen:
Objekttyp |
Name |
---|---|
Sicherheitsintegration |
WORKSHEETS |
Blobs |
WORKSHEETS_APP |
Datenbank |
WORKSHEETS_APP |
Benutzer |
WORKSHEETS_APP_USER |
Rollen |
APPADMIN, WORKSHEETS_APP_RL |
Diese internen Objekte werden verwendet, um Abfrageergebnisse in einem internen Stagingbereich Ihres Kontos zwischenzuspeichern. Diese zwischengespeicherten Daten sind verschlüsselt und durch die Schlüsselhierarchie des Kontos geschützt.
Die eingeschränkten Berechtigungen, die der internen Rolle zugewiesen werden, erlauben Snowsight nur den Zugriff auf den internen Stagingbereich, um diese Ergebnisse zu speichern. Die Rolle darf keine Objekte in Ihrem Konto auflisten oder auf Daten in Ihren Tabellen zugreifen.
Derzeit werden Snowsight-Benutzer und -Rolle zurückgegeben, wenn Benutzer die Ansichten USERS bzw. ROLES im Schema ACCOUNT_USAGE der freigegebenen SNOWFLAKE-Datenbank abfragen. SHOW <Objekte>-Anweisungen geben diese internen Objekte nicht zurück.