Einrichten einer IDE für die Nutzung von Snowpark Checkpoints¶

Der Snowflake Extension for Visual Studio-Code bietet Unterstützung für die Snowpark Checkpoints Bibliothek, um die Nutzung des Frameworks zu verbessern. Es gibt Ihnen eine abgestufte Kontrolle über die collect- und validate-Anweisungen, die in Ihren Code eingefügt werden, und überprüft den Status der Verhaltensäquivalenz-Assertionen Ihres konvertierten Codes.

Snowpark Checkpoints aktivieren¶

Um Snowpark Checkpoints zu aktivieren, gehen Sie zu den Erweiterungseinstellungen von Snowflake und aktivieren Sie Snowpark Checkpoints: Enabled.

Ansicht¶

Wenn Sie die Eigenschaft Snowpark Checkpoints auf Enabled setzen, öffnet sich in der Erweiterung eine neue Registerkarte namens SNOWPARK CHECKPOINTS. Es zeigt alle Checkpoints im Arbeitsbereich an und ermöglicht mehrere Aktionen, wie z. B. das Aktivieren/Deaktivieren aller oder einzelner Checkpoints, das Löschen aller Checkpoints aus Dateien und das Navigieren zu der Datei und der Codezeile, in der der Prüfpunkt definiert ist, indem Sie auf den jeweiligen Checkpoint doppelklicken.

Alle Checkpoints umschalten¶

Diese Option befindet sich in der rechten oberen Ecke der Registerkarte Snowpark Checkpoints und schaltet die aktivierte Eigenschaft in allen Checkpoints um.

Aktivierte Checkpoints:

Die Deaktivierung eines Checkpoints führt dazu, dass er zur Laufzeit übersprungen wird.

Alle Checkpoints bereinigen¶

Befindet sich in der oberen rechten Ecke der Registerkarte Snowpark Checkpoints. Dadurch werden Checkpoints aus allen Python-Dateien, einschließlich Jupyter-Notebooks, in Ihrem Arbeitsbereich entfernt, aber nicht aus dem Vertrag und dem Panel gelöscht. Das heißt, sie können mit dem Befehl Snowflake: Restore All Checkpoints wiederhergestellt werden.

Einfügen von Checkpoints in eine Datei¶

Wenn Sie mit der rechten Maustaste in eine Datei klicken, wird ein Kontextmenü mit der Option Snowpark Checkpoints angezeigt, mit der Sie Collection- und Validation-Checkpoints hinzufügen können.

Option Snowpark-Checkpoints im Kontextmenü:

Collector/Validator hinzugefügt:

Einen einzelnen Checkpoint ausführen¶

Sie können einen einzelnen Checkpoint ausführen, indem Sie auf die Code-Lense-Option klicken, die über jedem Checkpoint angezeigt wird. Wenn Sie es ausführen, wird eine Ausgabekonsole angezeigt, die den Fortschritt anzeigt. Sobald es beendet ist, wird die Ergebnisansicht aufgerufen. Sogar wenn der Checkpoint in der Vertragsdatei deaktiviert ist, wird er nur für seine Ausführung aktiviert.

Wenn ein Einstiegspunkt nicht in der Vertragsdatei deklariert ist, wird die Fehlermeldung: Einstiegspunkt für den Checkpoint nicht gefunden. angezeigt.

Ausführen aller aktivierten Snowpark Checkpoints in einer Datei¶

In der oberen rechten Ecke jeder Datei finden Sie die Schaltfläche Run all checkpoints from the current file.

Wenn Sie darauf klicken, erscheint ein Ausgabekanal, der den Fortschritt der Ausführung anzeigt.

Zeitleistenansicht¶

Zeigt eine Zeitleiste mit den Ergebnissen der Checkpoint-Ausführung an.

Befehle¶

Die folgenden Befehle sind für Snowpark Checkpoints verfügbar. Um sie zu verwenden, geben Sie Snowflake: [command name] in die Befehlspalette ein.

Snowpark Checkpoints-Befehle¶
Befehl	Beschreibung
Snowflake: Checkpoint umschalten	Schaltet die Eigenschaft „aktiviert“ für alle Checkpoints um.
Snowflake: Snowpark Checkpoints – Projektinitialisierung	Triggert die Projektinitialisierung und legt eine Vertragsdatei an, wenn sie nicht vorhanden ist. Falls er existiert, wird ein Popup-Fenster angezeigt, in dem Sie gefragt werden, ob Sie den Checkpoint in die Vertragsdatei laden möchten.
Snowflake: Alle Checkpoints löschen	Löscht alle Checkpoints aus allen Dateien im Arbeitsbereich.
Snowflake: Alle Checkpoints wiederherstellen	Stellen Sie Checkpoints wieder her, die zuvor aus Dateien gelöscht wurden und noch in der Vertragsdatei vorhanden sind.
Snowflake: Validierungs-/Erfassungs-Checkpoint hinzufügen	Fügt einen Validator oder Collector mit seinen obligatorischen Parametern an der Cursorposition ein.
Snowflake: Fokus auf Snowpark Checkpoints-Ansicht	Verschiebt den Fokus auf den Bereich SNOWPARK CHECKPOINTS.
Snowflake: Zeitleiste der offenen Checkpoints	Zeigt eine Zeitleiste der Checkpoint-Ausführungen an.
Snowflake: Alle Checkpoints aus der aktuellen Datei ausführen	Führt alle aktivierten Checkpoints in der aktuellen Datei aus.
Snowflake: Alle Checkpoints im Arbeitsbereich ausführen	Führt alle aktivierten Checkpoints aus dem Arbeitsbereich aus.
Snowflake: Alle Snowpark Checkpoint-Ergebnisse anzeigen	Zeigt eine Registerkarte mit den Ergebnissen aller Checkpoints an.

Warnungen¶

Duplikat: Wenn in einem Sammlungsprojekt zwei Checkpoints mit demselben Namen zugewiesen werden, erscheint eine Warnung: „Ein weiterer Checkpoint mit identischem Namen wurde entdeckt und wird überschrieben.“ Validierungsprojekte können mehrere Checkpoints mit demselben Namen haben, es wird keine Warnung angezeigt.
Falscher Typ: Wenn Sie einen Checkpoint mit einem anderen Typ als dem Projekttyp hinzufügen, wird er mit der folgenden Fehlermeldung unterstrichen: „Stellen Sie sicher, dass Sie die richtige Snowpark-Checkpoints-Anweisung verwenden. Diese spezielle Checkpoint-Anweisung unterscheidet sich von den anderen in diesem Projekt verwendeten Anweisungen. Anweisungen, die nicht dem Projekttyp entsprechen, werden bei der Ausführung ignoriert.
Ungültiger Checkpoint-Name: Es gibt ungültige Möglichkeiten, einen Parameter für den Checkpoint-Namen hinzuzufügen. Wenn dies geschieht, wird eine Warnmeldung angezeigt: „Ungültiger Checkpoint-Name.“ Checkpoint-Namen müssen mit einem Buchstaben beginnen und dürfen nur Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten.