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 zu diesen Informationen finden Sie unter Geheimnis mit Anmeldeinformationen für Authentifizierung erstellen.

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>
Copy

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]:
    
    Copy
    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
    
    Copy
    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
Copy

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 API-Integration für Interaktion mit der Repository-API erstellen.