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:

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 more actions for worksheet 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:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.

  3. Öffnen Sie das Arbeitsblatt.

  4. Öffnen Sie die Kontextauswahl.

  5. Wählen Sie die Rolle aus, mit der das Arbeitsblatt ausgeführt werden soll.

  6. Wählen Sie ein Warehouse aus, für das die Rolle Berechtigungen hat.

  7. Wählen Sie eine beliebige Stelle außerhalb der Dropdown-Liste aus, um die Kontextauswahl wieder zu schließen.

Bemerkung

Jedes Arbeitsblatt hat eine eigene Sitzung und kann andere Rollen verwenden als die, die Sie im user menu festgelegt haben (Ihre aktive Rolle). Wenn Sie Ihre aktive Rolle ändern, ändert dies nicht die Rolle, die dem Arbeitsblatt mit der context selector 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:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.

  3. Öffnen Sie das Arbeitsblatt.

  4. Öffnen Sie die Kontextauswahl.

  5. Wählen Sie das Symbol Show warehouse details aus.

  6. Wählen Sie für die Option Status den Status aus, und wählen Sie Resume aus, falls das Warehouse gerade angehalten ist.

  7. Wählen Sie für die Option Size die Größe aus, und wählen Sie eine andere Größe.

  8. 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 more actions for worksheet aus, die sichtbar ist, wenn Sie den Mauszeiger über die Registerkarte eines Arbeitsblatts bewegen, um das geöffnete Arbeitsblatt auf folgende Weise zu verwalten:

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 More options 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.

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Worksheets aus.

  3. Wählen Sie ein Arbeitsblatt aus, um es zu öffnen.

  4. Bewegen Sie den Mauszeiger über die Registerkarte des Arbeitsblatts, und wählen Sie more actions for worksheet aus.

  5. 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.

Freigeben von Arbeitsblättern und Ordnern

Sie können Arbeitsblätter und Ordner mit Arbeitsblättern für andere Snowflake-Benutzer in Ihrem Konto freigeben. Sie können Arbeitsblätter nur direkt für Benutzer freigeben, die sich zuvor bei Snowsight angemeldet haben. Wenn Sie Daten für jemanden freigeben möchten, der noch nicht bei Snowsight angemeldet ist, geben Sie stattdessen einen Link frei.

Durch das Freigeben eines Arbeitsblatts oder eines Arbeitsblattordners können Sie mit Ihren Kollegen gemeinsam an diesem Arbeitsblatt arbeiten. Die Empfänger eines freigegebenen Arbeitsblatts können den Inhalt des Arbeitsblatts bearbeiten oder anzeigen, die Ergebnisse anzeigen, das Arbeitsblatt ausführen oder das freigegebene Arbeitsblatt duplizieren. Siehe Berechtigungen für freigegebene Arbeitsblätter.

Berechtigungen für freigegebene Arbeitsblätter

Wenn Sie ein Arbeitsblatt für jemanden freigeben, können Sie den Zugriff auf das Arbeitsblatt und dessen Inhalt verwalten, indem Sie auswählen, welche Berechtigungen Sie dem anderen Benutzer erteilen möchten. Diese Berechtigungen werden auch für das Freigeben von Dashboards verwendet. Eigentümer von Arbeitsblättern haben dieselben Berechtigungen wie die Bearbeiter von Arbeitsblättern.

Jedes Arbeitsblatt in Snowsight verwendet eindeutige Sitzungen mit bestimmten Rollen und Warehouses, die im Kontext des Arbeitsblatts zugewiesen werden. Die Arbeitsblattrolle ist die Primärrolle, die zuletzt für die Ausführung des Arbeitsblatts verwendet wurde und die für die Ausführung des Arbeitsblatts erforderlich ist. Die Arbeitsblattrolle kann sich ändern, wenn der Eigentümer oder Bearbeiter des Arbeitsblatts das Arbeitsblatt mit einer anderen Rolle ausführt.

Um die Ergebnisse einer früheren Arbeitsblattversion anzuzeigen, müssen Sie über die Arbeitsblattrolle verfügen, mit der diese Arbeitsblattversion ausgeführt und die Ergebnisse generiert worden waren. Siehe Anzeigen von Ergebnissen für Arbeitsblattversionen.

Erteilte Berechtigungen

Der Empfänger kann:

Bearbeiten

  • Inhalte des Arbeitsblatts bearbeiten.

  • Arbeitsblatt ausführen, auch in einer anderen Rolle.

  • Frühere Versionen des Arbeitsblatts anzeigen.

  • Ergebnisse früherer Versionen des Arbeitsblatts anzeigen, wenn sie die Rolle haben, mit der die Ergebnisse generiert wurden.

  • Arbeitsblatt für andere freigeben.

  • Frühere Versionen des Arbeitsblatts anzeigen.

  • Arbeitsblatt zu einem anderen Ordner hinzufügen.

Anzeigen + Ausführen

  • Mit Arbeitsblattrolle:

    • Arbeitsblatt ausführen.

    • Ergebnisse der letzten Arbeitsblattversion anzeigen.

  • Inhalte des Arbeitsblatts anzeigen.

  • Arbeitsblatt mit eigener Rolle duplizieren und ausführen.

Ergebnisse anzeigen

  • Ergebnisse der letzten Arbeitsblattversion anzeigen, wenn sie die Arbeitsblattrolle haben.

  • Inhalte des Arbeitsblatts anzeigen.

  • Arbeitsblatt mit eigener Rolle duplizieren und ausführen.

Verknüpfung mit Anzeigen + Ausführen

  • Mit Arbeitsblattrolle:

    • Arbeitsblatt ausführen.

    • Ergebnisse der letzten Arbeitsblattversion anzeigen.

  • Inhalte des Arbeitsblatts anzeigen. Benutzer mit diesem Link können das Arbeitsblatt weder duplizieren noch ausführen.

Link mit Ergebnisse anzeigen

  • Ergebnisse der letzten Arbeitsblattversion anzeigen, wenn sie die Arbeitsblattrolle haben.

  • Inhalte des Arbeitsblatts anzeigen. Benutzer mit diesem Link können das Arbeitsblatt weder duplizieren noch ausführen.

Der Arbeitsblatteigentümer ist der Benutzer, der das Arbeitsblatt erstellt hat; er hat die gleichen Rechte wie ein Arbeitsblattbearbeiter. Der Arbeitsblatteigentümer ändert sich, wenn ein Arbeitsblatteigentümer oder -bearbeiter das Arbeitsblatt einem Ordner hinzufügt, der einem anderen Benutzer gehört.

Wenn der Arbeitsblatteigentümer in Snowflake gelöscht wird, bleibt der gelöschte Benutzer der Eigentümer des Arbeitsblatts, aber Benutzer mit Bearbeitungsberechtigungen können das Arbeitsblatt weiterhin verwenden.

Anzeigen von Ergebnissen für Arbeitsblattversionen

Arbeitsblatteigentümer und -benutzer mit Bearbeitungsberechtigungen für ein Arbeitsblatt können frühere Arbeitsblattversionen und in einigen Fällen auch die Ergebnisse dieser Arbeitsblattversionen anzeigen. Benutzer mit der Berechtigung zum Anzeigen und Ausführen sowie zum Anzeigen von Ergebnissen können die Ergebnisse der letzten Arbeitsblattversion anzeigen.

Um die Ergebnisse früherer Versionen eines Arbeitsblatts anzuzeigen, muss Folgendes zutreffen:

Vorsicht

Wenn Sie für Ihren Benutzer Sekundärrollen aktiviert haben, könnten die bei Ausführung eines Arbeitsblatts generierten Arbeitsblattergebnisse Ergebnisse enthalten, die aufgrund von Berechtigungen verfügbar sind, die einer Sekundärrolle erteilt wurden, nicht aber der Primärrolle, mit der das Arbeitsblatt ausgeführt wurde. Jeder, der die Arbeitsblattrolle für diese Arbeitsblattversion hat, kann alle Ergebnisse einsehen, einschließlich derer, die nur aufgrund von Berechtigungen sichtbar sind, die Sekundärrollen erteilt wurden.

Arbeitsblatt freigeben

Um ein Arbeitsblatt freizugeben, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.

  3. Öffnen Sie das Arbeitsblatt.

  4. Wählen Sie in der rechten oberen Ecke des Arbeitsblatts die Option Share aus.

  5. Geben Sie die Namen oder Benutzernamen der Snowflake-Benutzer ein, die Sie zur Nutzung Ihres Arbeitsblatts einladen möchten. In der Liste werden nur Benutzer angezeigt, die bereits bei Snowsight angemeldet sind. Wenn Sie Daten für jemanden freigeben möchten, der noch nicht bei Snowsight angemeldet ist, geben Sie stattdessen einen Link frei.

  6. Wählen Sie die Berechtigungen aus, die Sie Benutzern erteilen möchten, für die das Arbeitsblatt freigegeben werden soll.

  7. Legen Sie optional die Berechtigungen für Objekte fest, auf die Personen mit dem Link zum Arbeitsblatt zugreifen können.

  8. Optional können Sie Get Link auswählen, um einen Link zu Ihrem Arbeitsblatt zu erhalten, den Sie für andere freigeben können.

  9. Wählen Sie Done aus.

Bemerkung

Die zuletzt ausgeführte Version eines Arbeitsblatts ist die Arbeitsblattversion, die freigegeben wird. Wenn Sie das Arbeitsblatt noch nicht ausgeführt haben, wird ein leeres Arbeitsblatt freigegeben.

Alle Änderungen, die Sie an Ihrer Arbeitsblattversion vornehmen, unabhängig davon, ob Sie Bearbeiter oder Eigentümer des Arbeitsblatts sind, werden Mitbenutzern erst dann angezeigt, wenn Sie den Code des Arbeitsblatts ganz oder teilweise ausführen.

Ordner mit Arbeitsblättern freigeben

Um einen Ordner mit allen darin enthaltenen Arbeitsblättern freizugeben, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.

  3. Öffnen Sie einen Ordner.

  4. Wählen Sie in der rechten oberen Ecke der Worksheets page die Option Share aus.

  5. Geben Sie die Namen oder Benutzernamen der Snowflake-Benutzer ein, die Sie zur Nutzung Ihres Ordners einladen möchten. In der Liste werden nur Benutzer angezeigt, die bereits bei Snowsight angemeldet sind. Wenn Sie Daten für jemanden freigeben möchten, der noch nicht bei Snowsight angemeldet ist, geben Sie stattdessen einen Link frei.

  6. Wählen Sie die Berechtigungen aus, die Sie Benutzern erteilen möchten, für die der Ordner freigegeben werden soll.

  7. Legen Sie optional die Berechtigungen für Objekte fest, auf die Personen mit dem Link zum Ordner zugreifen können.

  8. Optional können Sie Get Link auswählen, um einen Link zu Ihrem Ordner zu erhalten, den Sie für andere freigeben können.

  9. Wählen Sie Done aus.

Wenn Sie ein Arbeitsblatt zu einem freigegebenen Ordner hinzufügen, erbt das Arbeitsblatt die Freigabeeinstellungen des Ordners. Wenn der Ordner nicht dem Arbeitsblatteigentümer gehört, wird der Benutzer, dem das Arbeitsblatt gehört, zum Eigentümer des Ordners, und der ursprüngliche Arbeitsblatteigentümer erbt die Freigabeberechtigungen des Ordners.

Wenn z. B. ein Arbeitsblatteigentümer ein Arbeitsblatt zu einem Ordner hinzufügt, für den er Bearbeitungsberechtigungen hat, wird das Arbeitsblatt aktualisiert und gehört nun dem Ordnereigentümer, während der ursprüngliche Arbeitsblatteigentümer dann Bearbeitungsberechtigungen für das Arbeitsblatt hat.

Kontoübergreifendes Freigeben von Arbeitsblättern

Arbeitsblätter sind keine Snowflake-Objekte und können daher nicht repliziert oder für andere Konten freigegeben werden. Wenn Sie den Inhalt eines Arbeitsblatts für Benutzer in einem anderen Snowflake-Konto freigeben möchten, müssen Sie die Inhalte kopieren und diesen dann für Benutzer von Konten außerhalb von Snowflake freigeben.

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. Benutzer mit Anzeige- und Ausführungsberechtigungen für das Arbeitsblatt können auch die Ergebnisse der neuesten 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 sowie die entsprechenden Ergebnisse anzeigen möchten, gehen Sie wie folgt vor:

  1. Melden Sie sich bei Snowsight an.

  2. Wählen Sie Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.

  3. Öffnen Sie das Arbeitsblatt.

  4. Wählen Sie für das Arbeitsblatt die Option Latest Code Version aus.

  5. Wählen Sie in der Dropdown-Liste der Arbeitsblattversionen den Zeitstempel der Version aus, die Sie öffnen möchten.

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.

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.