Integrieren von Arbeitsbereichen in ein Git-Repository¶

Wichtig

Ab September 2025 führt Snowflake bei Konten schrittweise ein Upgrade von Arbeitsblättern auf Arbeitsbereiche durch. Arbeitsbereiche werden zum Standard-SQL-Editor. Weitere Informationen dazu finden Sie unter Ändern der Standardeinstellung für Konten von Arbeitsblättern zu Arbeitsbereichen.

Übersicht¶

Arbeitsbereiche können in Snowflake lokal sein, oder Sie können Arbeitsbereiche in der Entwicklung mit einem Zweig in einem Git-Repository synchronisieren. In Arbeitsbereiche können Sie:

Einen Arbeitsbereich erstellen, der mit einem Git-Repository verbunden ist.
Einen neuen Zweig erstellen, den Zweig wechseln, oder einen Remote-Zweig abrufen.
Die neuesten Änderungen aus Ihrem Git-Repository in Ihren Arbeitsbereich ziehen.
Alle hinzugefügten, aktualisierten oder gelöschten Dateien verfolgen.
Commit und Push der aktualisierten Dateien zurück in Ihr Git-Repository durchführen.
Alle Konflikte anzeigen und lösen, direkt in Arbeitsbereiche.

Einen Git-Arbeitsbereich erstellen¶

Zum Entwickeln und Verwalten von Dateien direkt in Snowsight können Sie einen Arbeitsbereich erstellen, der mit einem Git-Repository verbunden ist.

Bemerkung

Ein Git-Repository muss mindestens einen Zweig enthalten. Leere Repositorys werden nicht unterstützt.

Um einen neuen, mit Git synchronisierten Arbeitsbereich zu erstellen, gehen Sie wie folgt vor:

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie im Menü Workspaces die Option From Git repository.
Kopieren Sie die URL aus Ihrem Git-Repository (z. B. https://www.github.com/my-user/my-repo-name), und fügen Sie sie in das Feld Repository URL ein.
Optional: Benennen Sie den neuen Git-synchronisierten Arbeitsbereich um.
Wählen Sie im Menü API Integration eine API-Integration aus.

API-Integrationen werden vom Kontoadministrator erstellt und müssen den Zugriff auf die Git-Repository-URL ermöglichen, die Sie in Schritt 4 verwenden. Weitere Details dazu finden Sie unter Einrichten von Snowflake für Verwendung von Git.

Wenn Sie außerdem GitHub als Git-Anbieter verwenden und OAuth für die Authentifizierung bevorzugen, muss der Kontoadministrator eine API-Integration erstellen, die OAuth unterstützt. Beispiel:
```
CREATE OR REPLACE API INTEGRATION api_integration_name
   API_PROVIDER = git_https_api
   API_ALLOWED_PREFIXES = ('https://github.com/')
   API_USER_AUTHENTICATION = (
      TYPE = snowflake_github_app
   )
   ENABLED = TRUE;
```
Copy
Wählen Sie unter API-Integration eine Authentifizierungsmethode aus:
- OAuth2 – Wählen Sie Sign in, um sich mit Ihrem GitHub-Repository zu authentifizieren. Nach der Anmeldung müssen Sie bei zukünftigen Sitzungen keine Anmeldeinformationen mehr angeben. Beachten Sie, dass OAuth2 nicht für PrivateLink-Umgebungen verfügbar ist.
- Personal access token – Wählen Sie die Datenbank und das Schema, in dem das Objekt mit Ihrem Token gespeichert ist. Um ein neues Geheimnis zu erstellen, wählen Sie + Secret und geben Sie die erforderlichen Details ein. Die API-Integration muss so konfiguriert werden, dass der Zugriff auf dieses Geheimnis oder auf alle Geheimnisse möglich ist.
- Public repository – Wählen Sie diese Option, wenn Sie ein öffentliches Repository verwenden, für das keine Authentifizierung erforderlich ist. Beachten Sie, dass es nicht möglich ist, Änderungen aus Ihrem Arbeitsbereich in dieses öffentliche Repository zu übertragen und zu pushen.
Wählen Sie Create aus.

Aktualisieren Sie Autorendaten und Anmeldeinformationen für eine Zweigstelle¶

Standardmäßig werden Ihre Snowflake-E-Mail und Ihr Benutzername für das Übertragen von Änderungen an Ihr Git-Repository verwendet. Sie können diese jederzeit aktualisieren.

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie die Registerkarte Changes aus.
Markieren Sie die Ellipse und wählen Sie dann Edit credentials.
Geben Sie einen Autorennamen und eine E-Mail-Adresse an.
Wählen Sie Update aus.

Einen neuen Zweig erstellen¶

Sie können von Ihrem aktuellen Zweig aus einen neuen Zweig erstellen, um unabhängig von diesem an Änderungen zu arbeiten.

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie die Registerkarte Changes aus.
Wählen Sie das Dropdown-Menü Repository.
Wählen Sie + New aus.
Geben Sie einen neuen Zweignamen an, und wählen Sie dann Create.

Zu einem anderen Zweig wechseln¶

Wenn Sie gespeicherte, aber noch nicht übertragene Änderungen haben, müssen Sie vor dem Wechsel des Zweigs festlegen, wie diese behandelt werden sollen.

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie in der Git-Arbeitsbereich-Ansicht Changes.
Wählen Sie im Zweig-Menü den Zweig aus, zu dem Sie wechseln möchten.

Tipp

Um die Liste zu filtern, beginnen Sie mit der Eingabe eines Zweignamens.

Remote-Zweige abrufen¶

Wenn ein neuer Zweig außerhalb von Snowsight erstellt wurde (z. B. ein Zweig, der in Ihrem Git-Anbieter erstellt wurde), können Sie ihn mit der Option Fetch All in Ihren Git-synchronisierten Arbeitsbereich holen. Dies aktualisiert Ihre Liste der verfügbaren Remote-Zweige.

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie in der Git-Arbeitsbereich-Ansicht Changes.
Klicken Sie auf den Abwärtspfeil neben dem Menü Pull und wählen Sie dann Fetch All. Wenn der Abruf beendet ist, erscheinen die neu erstellten Remote-Zweige in der Zweigliste und können ausgecheckt werden.

Aktualisierte Dateien anzeigen¶

Um alle Dateien anzuzeigen, die seit Ihrem letzten erfolgreichen Commit und Push hinzugefügt, gelöscht oder geändert wurden, führen Sie die folgenden Schritte aus:

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie oben in der Ordneransicht Changes. Geänderte Dateien sind mit einem M gekennzeichnet, hinzugefügte Dateien mit einem A und gelöschte Dateien mit einem D.
Um eine visuelle Übersicht über die Änderungen im Editor zu erhalten, wählen Sie eine Datei aus.

Übertragen und Veröffentlichen von Updates¶

Nachdem Sie Ihre Änderungen überprüft haben, können Sie sie vom Arbeitsbereich aus comitten und in Ihr Remote-Git-Repository pushen.

Führen Sie die folgenden Schritte aus, um Ihre aktualisierten Dateien festzuschreiben und in das externe Git-Repository zu übertragen:

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Workspaces aus.
Wählen Sie Changes am oberen Rand der Ordneransicht.
Schreiben Sie eine Commit-Nachricht in das Feld Commit message.
Wählen Sie Push aus.
Schreiben Sie eine Commit-Nachricht und wählen Sie Push, um Ihre Aktualisierungen in das Git-Repository zu pushen.

Bemerkung

Wenn Konflikte erkannt werden, werden Sie aufgefordert, zuerst abzurufen. Wählen Sie Pull, um eine Liste der Dateien mit Konflikten anzuzeigen.

Konflikte anzeigen und lösen¶

Wenn während eines Push-Vorgangs ein Konflikt auftritt, können Sie ihn direkt im Arbeitsbereich anzeigen und lösen, bevor Sie ihn erneut comitten.

Wählen Sie in Arbeitsbereiche oben in der Ordneransicht Changes. Wenn eine oder mehrere Dateien einen Konflikt aufweisen, wird oben in der Ansicht eine Meldung angezeigt. Dateien, die einen Konflikt aufweisen, sind mit einem roten M gekennzeichnet.
Um eine visuelle Darstellung des Konflikts im Editor anzuzeigen, wählen Sie eine Datei aus. Unter File with conflicts werden die Unterschiede inline hervorgehoben.
Akzeptieren Sie die aktuelle Änderung, eine eingehende Änderung oder beide Änderungen. Das Ergebnis der Zusammenführung wird angezeigt.
Unter Diff View können Sie die aktuelle und die Remote-Version nebeneinander sehen.
Wählen Sie Accept all current oder Accept all remote aus.
Nachdem Sie die Konflikte behoben haben, wählen Sie Push.
Schreiben Sie eine Commit-Nachricht.
Wählen Sie Push aus.