Snowflake Notebooks einrichten¶

Location¶

Der Speicherort ist der Ort, an dem ein Notebookobjekt gespeichert wird. Der Benutzer kann jede Datenbank und jedes Schema abfragen, auf die seine Rolle Zugriff hat.

• Um den Kontext auf eine andere Datenbank oder ein anderes Schema zu ändern, verwenden Sie die Befehle USE DATABASE oder USE SCHEMA in einer SQL-Zelle.

In der Laufzeit des Containers benötigt die Rolle, die das Notizbuch erstellt, auch die CREATE SERVICE-Berechtigung für das Schema.

Rollen, die Eigentümer eines Schemas sind, haben automatisch die Berechtigung, Notebooks innerhalb dieses Schemas zu erstellen, denn Eigentümer können jede Art von Objekt erstellen, auch Notebooks.

Erlauben Sie allen, Notebooks an einem bestimmten Speicherort zu erstellen¶

Die folgenden Schritte beschreiben, wie Sie den Zugriff für die Erstellung von Notebooks an einem bestimmten Speicherort konfigurieren, indem Sie die Nutzung einer Datenbank und eines Schemas erlauben. Alternativ können Sie auch private Notebooks aktivieren, für die diese Zugriffsrechte nicht erforderlich sind. Weitere Informationen über private Notebooks finden Sie unter Private Notebooks.

Ersetzen Sie <database> und <database.schema> durch die spezifische Datenbank und das Schema, in dem Sie Ihre Notebooks erstellen möchten:

----------------------------------
--       Location Setup         --
----------------------------------
GRANT USAGE ON DATABASE <database> TO ROLE PUBLIC;
GRANT USAGE ON SCHEMA <database.schema> TO ROLE PUBLIC;
GRANT CREATE NOTEBOOK ON SCHEMA <database.schema> TO ROLE PUBLIC;

-- For Notebooks on Container runtime, run the following:
GRANT CREATE SERVICE ON SCHEMA <database.schema> TO ROLE PUBLIC;

----------------------------------
--    Compute Resource Setup    --
----------------------------------
GRANT USAGE ON WAREHOUSE <warehouse> TO ROLE PUBLIC;

-- For Notebooks on Container runtime:
CREATE COMPUTE POOL CPU_XS
  MIN_NODES = 1
  MAX_NODES = 15
  INSTANCE_FAMILY = CPU_X64_XS;

CREATE COMPUTE POOL GPU_S
  MIN_NODES = 1
  MAX_NODES = 5
  INSTANCE_FAMILY = GPU_NV_S;

GRANT USAGE ON COMPUTE POOL CPU_XS TO ROLE PUBLIC;
GRANT USAGE ON COMPUTE POOL GPU_S TO ROLE PUBLIC;

-------------------------------------
-- Optional: External Access --
-------------------------------------

-- Example EAI
CREATE OR REPLACE NETWORK RULE allow_all_rule
MODE = 'EGRESS'
TYPE = 'HOST_PORT'
VALUE_LIST = ('0.0.0.0:443','0.0.0.0:80');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION allow_all_integration
ALLOWED_NETWORK_RULES = (allow_all_rule)
ENABLED = true;

GRANT USAGE ON INTEGRATION allow_all_integration TO ROLE PUBLIC;

Erstellen Sie eine dedizierte Rolle¶

Wenn Sie möchten, dass nur bestimmte Benutzer Notebooks erstellen können (vorausgesetzt, sie haben noch keine OWN Schemata), können Sie eine spezielle Rolle zur Zugriffskontrolle erstellen. Beispiel:

CREATE ROLE notebooks_rl;

Gewähren Sie bestimmten Benutzern die ROLE notebook_rl. Verwenden Sie dann das obige Skript, um Ressourcen zu erstellen und dieser Rolle Berechtigungen zu erteilen (ersetzen Sie ROLE PUBLIC durch ROLE notebook_rl).

Notebook-Engine¶

Die Notebook-Engine („Kernel“) und die Python-Prozesse laufen auf dem Notebook Warehouse. Snowflake empfiehlt, dass Sie mit einem X-Small Warehouse beginnen, um den Credit-Verbrauch zu minimieren.

Während Sie das Notebook verwenden (z. B. Code bearbeiten, Zellen ausführen, neu anordnen oder löschen) oder wenn das Notebook innerhalb seiner Leerlauf-Timeout-Einstellung aktiv bleibt, wird eine EXECUTE NOTEBOOK-Abfrage kontinuierlich ausgeführt, um anzuzeigen, dass die Notebook-Engine aktiv ist und eine Notebook-Sitzung verwendet wird. Sie können den Status dieser Abfrage unter Query history überprüfen. Während EXECUTE NOTEBOOK läuft, wird auch das Notebook Warehouse ausgeführt. Wenn EXECUTE NOTEBOOK beendet ist und keine anderen Abfragen oder Aufträge auf dem Warehouse laufen, wird es gemäß seiner Auto-Suspend-Richtlinie heruntergefahren.

Um die EXECUTE NOTEBOOK-Abfrage zu beenden (die Notebook-Sitzung zu beenden), gehen Sie wie folgt vor:

1. Wählen Sie Active oder wählen Sie End session aus dem Dropdown-Menü Active.

2. Suchen Sie in Query history die entsprechende Abfrage EXECUTE NOTEBOOK, und wählen Sie Cancel query.

3. Lassen Sie das Notebook aufgrund von Inaktivität entsprechend der eingestellten Leerlaufzeit auslaufen. Wenn die Parameter STATEMENT_TIMEOUT_IN_SECONDS und STATEMENT_QUEUED_TIMEOUT_IN_SECONDS auf dem Notebook Warehouse auf einen kleinen Wert eingestellt sind, könnte das Notebook unabhängig von der Aktivität des Benutzers schnell herunterfahren oder nicht starten.

Abfragen¶

SQL- und Snowpark-Abfragen (z. B. session.sql) werden an das Abfrage-Warehouse weitergeleitet, das bei Bedarf verwendet wird. Wenn die SQL- und Snowpark-Abfragen beendet sind, wird das Abfrage-Warehouse angehalten, wenn keine anderen Aufträge außerhalb des Notebooks darauf laufen. Wählen Sie eine Warehouse-Größe, die Ihren Anforderungen an Abfrageleistung am besten entspricht. Vielleicht möchten Sie zum Beispiel große SQL-Abfragen durchführen oder rechenintensive Operationen mit Snowpark Python ausführen, die ein größeres Warehouse erfordern. Für Operationen, die einen hohen Speicherbedarf erfordern, sollten Sie ein Snowpark-optimiertes Warehouse verwenden.

Sie können das Abfrage-Warehouse in Notebook Settings ändern. Alternativ können Sie den folgenden Befehl in einer beliebigen SQL-Zelle des Notebooks ausführen, um das Abfrage-Warehouse für alle nachfolgenden Abfragen in der aktuellen Notebooksitzung zu ändern:

USE WAREHOUSE <warehouse_name>;

Leerlaufzeit und Wiederherstellung der Verbindung¶

Jedes Notebook hat eine Leerlaufzeit-Eigenschaft namens IDLE_AUTO_SHUTDOWN_TIME_SECONDS mit einem Standardwert von 30 Minuten. Sie können die Leerlaufzeit für jedes Notebook unter Snowsight konfigurieren.

1. Melden Sie sich bei Snowsight an.

2. Wählen Sie Projects » Notebooks aus.

3. Wählen Sie das vertikale Ellipsenmenü , um eine neue Zeit zu konfigurieren.

4. Wählen Sie Notebook settings aus.

5. Starten Sie die Sitzung manuell neu, damit die neue Leerlaufzeit wirksam wird.

Leerlaufzeit sammelt sich immer dann an, wenn keine Aktivität des Benutzers stattfindet, wie z. B. das Bearbeiten von Code, das Ausführen von Zellen, das Neuordnen oder Löschen von Zellen. Jedes Mal, wenn Sie die Aktivität wieder aufnehmen, wird die Leerlaufzeit zurückgesetzt. Sobald die Leerlaufzeit die Timeout-Einstellung erreicht, wird die Notebook-Sitzung automatisch beendet.

Vor dem Leerlauf-Timeout bleibt Ihre Notebook-Sitzung aktiv, bis der Leerlauf-Timeout erreicht ist, auch wenn Sie die Seite aktualisieren, andere Bereiche von Snowsight, Ihren Computer herunterfahren oder in den Ruhezustand versetzen. Wenn Sie dasselbe Notebook erneut öffnen, verbinden Sie sich wieder mit derselben Sitzung, wobei alle Sitzungszustände und Variablen erhalten bleiben, sodass Sie nahtlos weiterarbeiten können. Beachten Sie jedoch, dass der Status Ihrer Streamlit-Widgets nicht beibehalten wird.

Jeder einzelne Benutzer, der mit demselben Notebook arbeitet, hat seine eigene unabhängige Sitzung. Sie beeinträchtigen sich nicht gegenseitig.

Empfehlungen zur Kostenoptimierung¶

Als Kontoadministrator sollten Sie die folgenden Empfehlungen berücksichtigen, um die Kosten für den Betrieb von Notebooks zu kontrollieren:

• Bitten Sie Ihre Teams, dasselbe Warehouse (X-Small wird empfohlen) als spezielles „Notebook-Warehouse“ für die Ausführung der Notebook-Sitzungen zu verwenden, um die Parallelität zu erhöhen. Beachten Sie, dass dies zu langsameren Sitzungsstarts (in der Warteschlange des Warehouse) oder Out-of-Memory-Fehlern führen kann, wenn zu viele Notebooks gleichzeitig ausgeführt werden sollen.

• Erlauben Sie Ihren Teams, ein Warehouse mit einem niedrigeren STATEMENT_TIMEOUT_IN_SECONDS-Wert zu verwenden, um Notebooks zu betreiben. Dieser Warehouse-Parameter steuert, wie lange Abfragen dauern können, einschließlich Notebook-Sitzungen. Wenn der Parameter beispielsweise auf 10 Minuten eingestellt ist, kann die Notebook-Sitzung maximal 10 Minuten lang laufen, unabhängig davon, ob der Benutzer während dieser Zeit in der Notebook-Sitzung aktiv ist.

• Bitten Sie Ihre Teams, ihre Notebook-Sitzungen zu beenden, wenn sie nicht vorhaben, aktiv an der Sitzung mitzuarbeiten.

• Bitten Sie Ihre Teams, die Leerlauf-Timeout-Einstellung zu minimieren (z. B. auf 15 Minuten), wenn die Sitzung nicht über einen längeren Zeitraum laufen muss.

• Alternativ können Sie auch ein Support-Ticket erstellen, um einen Standardwert für die Leerlaufzeit festzulegen, der für Ihr gesamtes Konto gilt. Dieser Wert kann auf Notebook-Ebene vom Eigentümer des Notebooks noch überschrieben werden.