Einrichten eines Git-Repositorys

Sie können Ihr externes Git-Repository in Snowflake integrieren, sodass Dateien aus dem Repository mit einem speziellen Stagingbereich, dem Repository-Stagingbereich, synchronisiert werden. Der Repository-Stagingbereich fungiert als lokales Git-Repository mit einem vollständigen Klon des externen Repositorys, einschließlich Zweigen, Tags und Commits.

Weitere Informationen dazu finden Sie unter Verwenden eines Git-Repositorys in Snowflake.

Bevor Sie beginnen

Bevor Sie ein Git-Repository einrichten, benötigen Sie die folgenden Informationen:

  • URL des externen Repositorys (in Git auch origin genannt).

  • Optional Anmeldeinformationen für die Verbindung zu Git, einschließlich Geheimnis, Benutzername und Kennwort.

  • Optional die API-Integrations-ID.

  • Rolle oder Benutzer mit Berechtigungen zum Erstellen von API-Integrationen, wenn Sie noch keine API-Integration haben.

Weitere Informationen dazu finden Sie unter Einrichten von Snowflake für Verwendung von Git.

Git-Repository einrichten

Um ein Git-Repository in den Stagingbereich zu klonen, verwenden Sie den snow git setup Befehl wie folgt:

snow git setup <REPO_NAME>

Wobei:

  • <REPO_NAME> ist die ID des Repository-Stagingbereichs, das Sie erstellen möchten. Beachten Sie, dass der Befehl fehlschlägt, wenn der Repository-Stagingbereich bereits existiert.

Der snow git setup-Befehl stellt eine Reihe von Eingabeaufforderungen zur Verfügung, um die erforderlichen Informationen zu sammeln, wie in den folgenden Beispielen gezeigt:

  • Erstellen eines Repositorys, für das ein Geheimnis und Anmeldeinformationen erforderlich sind:

    $ snow git setup snowcli_git
Origin url: https://github.com/snowflakedb/snowflake-cli.git
Use secret for authentication? [y/N]: y
Secret identifier (will be created if not exists) [snowcli_git_secret]: new_secret
Secret 'new_secret' will be created
username: john_doe
password/token: ****
API integration identifier (will be created if not exists) [snowcli_git_api_integration]:

    Secret 'new_secret' successfully created.
API integration snowcli_git_api_integration successfully created.
+------------------------------------------------------+
| status                                               |
|------------------------------------------------------|
| Git Repository SNOWCLI_GIT was successfully created. |
+------------------------------------------------------+

  • Erstellen eines Repositorys ohne Geheimnis und einer bestehende API-Integrations-ID:

    $ snow git setup snowcli_git
Origin url: https://github.com/snowflakedb/snowflake-cli.git
Use secret for authentication [y/N]: n
API integration identifier (will be created if not exists) [snowcli_git_api_integration]: EXISTING_INTEGRATION

    Using existing API integration 'EXISTING_INTEGRATION'.
+------------------------------------------------------+
| status                                               |
|------------------------------------------------------|
| Git Repository SNOWCLI_GIT was successfully created. |
+------------------------------------------------------+

Wenn die Rolle oder der Benutzer, die oder der in Ihrer Verbindung angegeben ist, nicht zugewiesen wurde, generiert die Ausführung dieses Befehls eine Fehlermeldung ähnlich der folgenden:

003001 (42501): 01b2f095-0508-c66d-0001-c1be009a66ee: SQL access control error: Insufficient privileges to operate on account XXX

In diesem Fall sollten Sie Ihre Verbindungskonfiguration überprüfen oder Ihren Kontoadministrator bitten, Ihnen die erforderlichen Berechtigungen zu erteilen oder die Integration für Sie zu erstellen. Weitere Informationen dazu finden Sie unter Einrichten von Snowflake für Verwendung von Git.