Snowflake Notebooks mit Git-Repository synchronisieren¶
Um die Versionskontrolle mit Ihren Snowflake Notebooks zu nutzen, können Sie die Entwicklung Ihres Notebooks mit einem Zweig in einem Git-Repository synchronisieren.
Sie müssen Ihr Snowflake-Konto bereits so eingerichtet haben, dass es mit einem Git-Repository verbunden ist, und Sie müssen einen Zweig in diesem Repository erstellt haben, den Sie für die Entwicklung mit Ihrem Notebook verwenden. Siehe Einrichten von Snowflake für Verwendung von Git.
Notebook aus Datei in Git-Repository erstellen¶
Bemerkung
Bei der Datei muss es sich um eine .ipynb
-Datei handeln, die das Notebook-Format (nbformat) 4.0 oder höher verwendet.
Um ein Snowflake Notebook aus einer Datei in einem Git-Repository zu erstellen, gehen Sie wie folgt vor:
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Notebooks aus.
Öffnen Sie neben + Notebook das Dropdown-Menü, und wählen Sie Create from repository aus.
Wählen Sie unter File location in repository das Repository und den Zweig in dem Repository aus, die die Notebook-Datei enthalten, und wählen dann die spezifische
.ipynb
-Datei aus.Wählen Sie unter Notebook location eine Datenbank und ein Schema aus, die das Notebook enthalten sollen. Dieser Parameter kann nach dem Erstellen des Notebooks nicht mehr geändert werden.
Wählen Sie unter Notebook warehouse ein Warehouse aus.
Wählen Sie Create aus, um aus der
.ipynb
-Datei in Ihrem Git-Repository ein Snowflake Notebook zu erstellen.
Vorhandenes Notebook mit Git-Repository verbinden¶
Um ein bestehendes Snowflake-Notebook mit einem Git-Repository zu verbinden, gehen Sie wie folgt vor:
Bemerkung
Sie müssen eine Rolle mit mindestens den folgenden Berechtigungen verwenden:
Berechtigung OWNERSHIP oder READ für das Git-Repository.
USAGE-Berechtigung für das Schema, das das Git-Repository enthält.
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Notebooks aus, und öffnen oder erstellen Sie ein Snowflake Notebook.
Wählen Sie auf der Registerkarte Files neben dem Datenbank-Objekt-Explorer die Option Connect Git Repository aus.
Wählen Sie unter File location in repository das Repository und den Zweig im Repository aus, mit dem Sie das Notebook synchronisieren möchten.
Wählen Sie Select Folder aus.
Als Nächstes werden Sie aufgefordert, Ihr Notebook an das Git-Repository zu übergeben (Commit). Führen Sie die im Abschnitt Änderungen an einem Zweig des Git-Repositorys committen beschriebenen Commit-Schritte aus.
Nachdem Sie Ihr Notebook mit einem Git-Repository verbunden haben, können Sie den Namen des Zweigs auswählen und die Repository-Details in Snowflake oder auf Github öffnen.
Änderungen an einem Zweig des Git-Repositorys committen¶
Wenn ein Snowflake Notebook mit einem Zweig in einem Git-Repository verbunden ist, können Sie, nachdem Sie Änderungen am Snowflake Notebook vorgenommen haben, Ihre Änderungen an den Zweig übertragen (committen).
Sie müssen eine Rolle mit der Berechtigung OWNERSHIP oder WRITE für das Git-Repository verwenden, um Ihre Änderungen übertragen zu können. Siehe Anforderungen an die Zugriffssteuerung.
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Notebooks aus, und öffnen Sie ein Snowflake Notebook.
Nehmen Sie alle relevanten Änderungen am Notebook vor.
Wählen Sie Commit aus.
Im angezeigten Dialogfeld Commit to Repository können Sie den Benutzernamen und die E-Mail-Adresse überprüfen, die zum Übertragen der Änderungen an den angegebenen Zweig und das Repository verwendet werden. Wenn Sie den Benutzernamen und die E-Mail-Adresse aktualisieren müssen, erweitern Sie den Abschnitt Credentials, und aktualisieren Sie die Felder Author name und Author email.
Geben Sie unter Commit message eine Nachricht ein, die Sie Ihrem Commit beifügen.
Erweitern Sie den Abschnitt Credentials, um die Anmeldeinformationen zu konfigurieren. Geben Sie Ihr persönliches Zugriffstoken für das Git-Repository in das Feld Personal access token ein. Dieses Zugriffstoken stammt von dem externen Git-Anbieter, z. B. Github.
Dieses Token ist erforderlich, um sich beim Git-Repository zu authentifizieren.
Der Token muss Lese- und Schreibzugriff auf den Inhalt des Repositorys haben, damit das Commit funktioniert.
Sobald Sie den Token eingegeben haben, wird er für zukünftige Commits gespeichert. Sie können es bei allen zukünftigen Commits aktualisieren.
Wählen Sie Commit aus.
Eine Bestätigungsmeldung besagt, dass Ihre Änderungen in Ihren Zweig übertragen (committet) wurden.
Notebook mit externem Zweig des Git-Repositorys synchronisieren¶
Nachdem Sie Ihr Notebook mit einem Zweig in einem Git-Repository verbunden haben, können Sie alle Änderungen im externen Zweig mit Ihrem Snowflake Notebook synchronisieren.
Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Notebooks aus, und öffnen oder erstellen Sie ein Snowflake Notebook.
Wählen Sie im Datenbank-Objekt-Explorer auf der Registerkarte Files die Option Pull aus.
Snowflake ruft alle Änderungen aus dem externen Repository-Zweig ab und führt den Inhalt des Notebooks mit diesen Änderungen zusammen.
Zusammenführungskonflikte¶
Snowflake versucht, Zusammenführungskonflikte aufzulösen, die während einer Synchronisierung auftreten. Wenn Merge-Konflikte auftreten, die Snowflake nicht auflösen kann, erhalten Sie eine Meldung, in der Sie aufgefordert werden, Ihre Änderungen zu verwerfen oder sie in einen neuen Zweig zu übertragen. Wenn sie in einen neuen Zweig übertragen werden, verwenden Sie Ihren Git-Anbieter, um Ihre Änderungen aus dem neuen Zweig manuell mit dem ursprünglichen Zweig zusammenzuführen. Dann sollten Sie die neuesten Updates auf Ihr Snowflake-Notebook ziehen.