Private Notebooks¶

Voraussetzungen für die Verwendung privater Notebooks¶

Bevor Sie private Notebooks erstellen und verwenden können, muss ein Administrator mit der Rolle ACCOUNTADMIN die folgenden Aufgaben erledigen:

• Aktivieren Sie das Feature „persönlichen Datenbank“ entweder auf der Kontoebene oder für bestimmte Benutzer.

  Persönliche Datenbanken sind Snowflake-Objekte, die es ermöglichen, dass sich Notebooks wie private Notebooks verhalten. Informationen zur Durchführung dieser Aufgabe finden Sie in den folgenden Abschnitten:

  • Private Notebooks für das Konto aktivieren und deaktivieren

  • Aktivieren und Deaktivieren privater Notebooks für einzelne Benutzer

• Legen Sie ggf. sekundäre Rollen für Benutzer fest, die private Notebooks erstellen werden.

  Informationen zum Abschluss dieser Aufgabe, die von der Aktivierung der neuesten BCR-Bundles abhängen kann, finden Sie unter Aktivieren aller sekundären Rollen für private Benutzer von Notebooks.

Einzelheiten zum Erstellen eines privaten Notebooks finden Sie unter Neues Notebook erstellen.

Aktivieren aller sekundären Rollen für private Benutzer von Notebooks¶

Bevor Sie ein privates Notebook erstellen, müssen alle Sekundärrollen aktiviert sein. Das liegt daran, dass private Notebooks dem Benutzer gehören und nicht seiner Hauptrolle.

Um alle Sekundärrollen eines Benutzers standardmäßig zu aktivieren, kann der Benutzer oder ein Administrator den Befehl ALTER USER verwenden, um die Objekteigenschaft DEFAULT_SECONDARY_ROLES entweder zu deaktivieren oder für den Benutzer auf (‚ALL‘) zu setzen.

Beispiel:

ALTER USER my_user UNSET DEFAULT_SECONDARY_ROLES;
ALTER USER my_user SET DEFAULT_SECONDARY_ROLES = ('ALL');

Nachdem der Benutzer oder ein Administrator die obige Anweisung SQL ausgeführt hat, kann der Benutzer ein privates Notebook in Snowsight (Projekte » Notebooks) oder durch die Ausführung von SQL Befehlen in einem neuen Arbeitsblatt erstellen.

Ein Benutzer, der SQL-Befehle in einem bestehenden Arbeitsblatt ausführen möchte, muss die folgende SQL-Anweisung ausführen, bevor er ein privates Notebook erstellt:

USE SECONDARY ROLES ALL;

Private Notebooks für das Konto aktivieren und deaktivieren¶

Um private Notebooks für ein Snowflake-Konto zu aktivieren oder zu deaktivieren, verwenden Sie den Parameter ENABLE_PERSONAL_DATABASE.

Eigenschaften von ENABLE_PERSONAL_DATABASE:

Typ:

Benutzer – Kann für Konto > Benutzer festgelegt werden

Datentyp:

Boolesch

Beschreibung:

Steuert, ob Benutzer Zugriff auf private Notebooks haben.

Werte:

TRUE: Ermöglicht Benutzern den Zugriff auf ihre persönlichen Datenbanken.

FALSE: Verhindert, dass Benutzer auf ihre persönlichen Datenbanken zugreifen können.

Standard:

FALSE

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = TRUE;

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = FALSE;

SHOW PARAMETERS LIKE 'ENABLE_PERSONAL_DATABASE' IN ACCOUNT;

USE DATABASE USER$;

USE DATABASE USER$bobr;

USE DATABASE USER$jlap;

ERROR: Insufficient privileges to operate on database 'USER$JLAP'

Aktivieren und Deaktivieren privater Notebooks für einzelne Benutzer¶

Administratoren möchten vielleicht, dass bestimmte Benutzer des Kontos persönlichen Datenbankzugriff haben und nicht alle Benutzer des Kontos. Um den Zugriff für bestimmte Benutzer zu ermöglichen, verwenden Sie den Befehl ALTER USER, um den Parameter ENABLE_PERSONAL_DATABASE für diese Benutzer auf TRUE zu setzen. Aktivieren Sie zum Beispiel den Zugriff für drei Benutzer:

ALTER USER bobr SET ENABLE_PERSONAL_DATABASE = TRUE;
ALTER USER amya SET ENABLE_PERSONAL_DATABASE = TRUE;
ALTER USER jlap SET ENABLE_PERSONAL_DATABASE = TRUE;

Wenn Sie persönliche Datenbanken auf der Ebene des Kontos aktivieren, können Sie bei Bedarf persönliche Datenbanken für einzelne Benutzer deaktivieren. Um Benutzer zu deaktivieren, führen Sie denselben Befehl aus, setzen aber den Parameter auf FALSE. Beispiel:

ALTER USER jlap SET ENABLE_PERSONAL_DATABASE = FALSE;

Wenn der Benutzer jlap das Präfix USER$ in einem Befehl angibt, schlägt der Befehl fehl, weil die persönliche Datenbank nicht existiert.

NotebookSqlException: Failed to fetch a pandas Dataframe. The error is: 060109 (0A000): Personal Database is not enabled for user JLAP.
Please contact an account administrator to enable it and try again.

Ein privates Notebook erstellen¶

Um ein neues privates Notebook zu erstellen, gehen Sie folgendermaßen vor:

1. Melden Sie sich bei Snowsight an.

2. Wählen Sie im Navigationsmenü auf der linken Seite Projects » Notebooks aus.

3. Wählen Sie + Notebook aus.

4. Wählen Sie Ihren Benutzernamen aus der Liste Owner aus.

5. Geben Sie einen Namen für Ihr Notebook ein.

   Bemerkung

   Wenn Sie eine AWS-Region verwenden, können Sie die Laufzeitumgebung für Ihr Notebook angeben: entweder Warehouse Runtime oder Container Runtime.

6. Wählen Sie Notebook location aus. Dies sind die Datenbank und das Schema, in dem Sie Ihr Notebook speichern. Dieser Parameter kann nach dem Erstellen des Notebooks nicht mehr geändert werden. Wenn Sie ein privates Notebook erstellen, nachdem persönliche Datenbanken für Ihr Konto aktiviert wurden, wird Ihre persönliche Datenbank standardmäßig unter Notebook location vorausgefüllt. Wenn Sie jedoch ein privates Notebook erstellen und es nur ein Schema in Ihrer persönlichen Datenbank gibt, sind die Optionen von Notebook location nicht verfügbar.

   Bemerkung

   In der Dropdown-Liste Notebook location werden möglicherweise keine Datenbanken angezeigt, die erstellt wurden, nachdem Sie das Dialogfeld Create Notebook geöffnet haben. Wenn Sie Ihre kürzlich erstellte Datenbank, Ihr Schema oder Ihr Warehouse nicht finden können, versuchen Sie, Ihr Browserfenster neu zu laden.

   Die Abfrage von Daten im Notebook ist nicht auf diesen Speicherort beschränkt. Im Notebook können Sie Daten von jedem Speicherort abfragen, auf den Sie Zugriff haben. Um den Speicherort anzugeben, führen Sie USE WAREHOUSE und USE SCHEMA aus.

7. Wählen Sie Run on warehouse oder Run on container als Ihre Python-Umgebung.

8. Optional Wählen Sie ein Query warehouse, um alle vom Notebook ausgegebenen SQL- und Snowpark-Abfragen auszuführen.

9. Wählen Sie ein Notebook warehouse, um notebook-spezifische Aufgaben auszuführen. Snowflake empfiehlt, dass Sie SYSTEM$STREAMLIT_NOTEBOOK_WH verwenden, ein von Snowflake verwaltetes Warehouse, das in jedem Konto für die Ausführung von Notebooks bereitgestellt wird.

10. Wählen Sie Create aus, um Ihr Notebook zu erstellen und zu öffnen.

Organisieren Sie Ihre privaten Notebooks¶

Sie können Schemas erstellen und verwenden, um Ihre privaten Notebooks zu organisieren. Persönliche Datenbanken enthalten standardmäßig die Standardschemas PUBLIC und INFORMATION_SCHEMA.

Erstellen und verwenden Sie neue Schemas auf die übliche Weise, aber stellen Sie sicher, dass Sie Ihre persönliche Datenbank verwenden, wenn Sie Schemas erstellen. Beispiel:

USE DATABASE USER$bobr;
CREATE SCHEMA bobr_schema;
USE SCHEMA bobr_schema;

Sie können den Befehl ALTER SCHEMA auch für Schemas in persönlichen Datenbanken verwenden, und Sie können den Befehl SHOW SCHEMAS verwenden, um die Schemas anzuzeigen, die zu persönlichen Datenbanken gehören. Beispiel:

ALTER SCHEMA bobr_schema RENAME TO bobr_personal_schema;
SHOW TERSE SCHEMAS;

+-------------------------------+----------------------+------+---------------+-------------+
| created_on                    | name                 | kind | database_name | schema_name |
|-------------------------------+----------------------+------+---------------+-------------|
| 2024-10-28 19:33:18.437 -0700 | BOBR_PERSONAL_SCHEMA | NULL | USER$BOBR     | NULL        |
| 2024-10-29 14:11:33.267 -0700 | INFORMATION_SCHEMA   | NULL | USER$BOBR     | NULL        |
| 2024-10-28 12:47:21.502 -0700 | PUBLIC               | NULL | USER$BOBR     | NULL        |
+-------------------------------+----------------------+------+---------------+-------------+

Ein privates Notebook für den allgemeinen Gebrauch zur Verfügung stellen¶

An einem bestimmten Punkt der Entwicklung möchten Sie Ihr Notebook vielleicht außerhalb Ihrer persönlichen Datenbank neu erstellen. Um diese Änderung vorzunehmen, duplizieren Sie das ursprüngliche Notebook mit dem Befehl CREATE NOTEBOOK. Wenn Sie dies tun, wird das Notebook für andere Benutzer sichtbar.

Beispiel:

CREATE NOTEBOOK bobr_prod_notebook
  FROM 'snow://notebook/USER$BOBR.PUBLIC.bobr_private_notebook/versions/version$1/'
  QUERY_WAREHOUSE = 'PUBLIC_WH'
  MAIN_FILE = 'notebook_app.ipynb'
  COMMENT = 'Duplicated from personal database';

Notebook BOBR_PROD_NOTEBOOK successfully created.

Sie können ein privates Notebook auch aus einem Notebook erstellen, das in einer Produktionsdatenbank angelegt wurde.

FROM 'source_location'

Gibt an, dass das Notebook aus einer .ipynb-Datei im angegebenen Stagingbereich erstellt werden soll:

• Um das Notebook aus einer Datei in einem Stagingbereich zu erstellen, legen Sie source_location für den Stagingbereich-Speicherort der Datei und den Parameter MAIN_FILE für den Namen der Datei fest.

• Um das Notebook aus einem privaten Notebook zu erstellen (z. B. um ein privates Notebook für die gemeinsame Nutzung verfügbar zu machen), setzen Sie diesen Parameter auf:

  'snow://notebook/USER$username.schema.notebook/versions/version$1/'

  Wobei:

  • username ist Ihr Benutzername.

  • schema ist der Name des Schemas, das das private Notebook enthält.

  • notebook ist der Name des privaten Notebooks.

Wenn dieser Parameter nicht angegeben wird, wird das Notebook-Objekt aus einer Notebook-Vorlage erstellt.

Informationen über private Notebooks und persönliche Datenbanken anzeigen¶

Einzelne Benutzer können Snowsight verwenden, um Informationen über ihre Notebook einzusehen. Rufen Sie Projects » Notebooks auf. Der Eigentümer des Notebooks wird als Benutzer aufgeführt.

Informationen über Datenbanken, einschließlich persönlicher Datenbanken, finden Sie unter Data » Databases. Sie können leicht erkennen, welche Datenbanken persönliche Datenbanken sind, da sie das Präfix USER$ tragen.

Sichtbarkeit für Administratoren¶

Rollen mit der Berechtigung MANAGE GRANTS haben Einblick in alle Objekte innerhalb des Kontos, einschließlich persönlicher Objekte, die einzelnen Benutzern gehören. Rollen wie ACCOUNTADMIN können beispielsweise standardmäßig alle Datenbanken, einschließlich persönlicher Datenbanken, einsehen. Diese Rollen können auch auf Details zu Schemata und privaten Notebooks in persönlichen Datenbanken zugreifen.

Um Details für alle persönlichen Datenbanken innerhalb eines Kontos anzuzeigen, fragen Sie die DATABASES Ansicht Kontonutzung ab:

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.DATABASES;

Administratoren können DESCRIBE NOTEBOOK verwenden, um die Eigenschaften eines bestimmten privaten Notebooks anzuzeigen:

DESCRIBE NOTEBOOK USER$.PUBLIC.bobr_private_notebook;

Auf der Seite Projects » Notebooks in Snowsight können Administratoren keine privaten Notebook-Objekte sehen, die anderen Benutzern in der Liste Notebooks gehören.

So zeigen Sie die persönliche Datenbank des aktuellen Benutzers an:

SHOW DATABASES LIKE 'USER$BOBR';

Für persönliche Datenbanken lautet der Wert in der kind-Spalte PERSONAL DATABASE.

Einschränkungen¶