Configuration d’un référentiel Git

Vous pouvez intégrer votre référentiel Git distant à Snowflake afin que les fichiers du référentiel soient synchronisés vers une zone de préparation spéciale appelée zone de préparation de référentiel. La zone de préparation du référentiel agit comme un référentiel Git local avec un clone complet du référentiel distant, y compris les branches, les balises et les validations.

Pour plus d’informations, voir Utilisation d’un référentiel Git dans Snowflake.

Avant de commencer

Avant de créer un référentiel Git, vous devez disposer des informations suivantes :

  • URL du référentiel distant (également appelé origin dans Git).

  • Identifiants de connexion facultatifs pour se connecter à Git, y compris un secret, un nom d’utilisateur et un mot de passe.

  • ID d’intégration d’API en option.

  • Rôle ou utilisateur ayant les privilèges nécessaires pour créer des intégrations d’API, si vous n’avez pas encore d’intégration API.

Pour plus d’informations sur ces informations, voir Créer un secret avec des identifiants de connexion pour l’authentification.

Configurer un référentiel Git

Pour cloner un référentiel Git dans la zone de préparation du référentiel Git, utilisez la commande snow git setup, comme indiqué :

snow git setup <REPO_NAME>
Copy

où :

  • <REPO_NAME> est l’ID de la zone de préparation du référentiel que vous souhaitez créer. Notez que si la zone de préparation de référentiel existe déjà, la commande échoue.

La commande snow git setup fournit une série d’invites pour collecter les informations nécessaires, comme le montrent les exemples suivants :

  • Créez un référentiel qui nécessite un secret et des identifiants de connexion :

    $ 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. |
+------------------------------------------------------+

  • Créez un référentiel sans secret et un ID d’intégration d’API existant :

    $ 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. |
+------------------------------------------------------+

Si le rôle ou l’utilisateur spécifié dans votre connexion n’a pas été accordé, l’exécution de cette commande génère une erreur similaire à la suivante :

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

Dans cette situation, vous devez vérifier la configuration de votre connexion ou demander à l’administrateur de votre compte de vous accorder les privilèges nécessaires ou de créer l’intégration pour vous. Pour plus d’informations, voir Créer une API d’intégration pour interagir avec l’API du référentiel.

Langage: Français