Opérations Git dans Snowflake¶

Lorsque vous souhaitez actualiser votre zone de préparation de référentiel, vous pouvez récupérer le contenu du référentiel Git intégré dans la zone de préparation de référentiel à l’aide de la commande ALTER GIT REPOSITORY.

Le code de l’exemple suivant met à jour la zone de préparation du référentiel avec le contenu du référentiel :

ALTER GIT REPOSITORY snowflake_extensions FETCH;

Vous pouvez utiliser Snowsight pour actualiser la zone de préparation du référentiel (qui contient un clone du référentiel distant) à partir du référentiel distant.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data » Databases.

3. Dans l’explorateur d’objets, sélectionnez la base de données et le schéma qui contiennent la zone de préparation du référentiel Git que vous souhaitez actualiser.

4. Dans le schéma, ouvrez Git Repositories.

5. Dans Git Repositories, sélectionnez le référentiel pour voir la page de détails.

6. Dans les détails du référentiel, sur l’onglet Files Explorer, sélectionnez le bouton Fetch pour actualiser la zone de préparation du référentiel.

Vous pouvez afficher les branches et les balises en utilisant les commandes SHOW GIT BRANCHES et SHOW GIT TAGS.

L’exemple suivant génère une liste des branches du référentiel Git snowflake_extensions :

SHOW GIT BRANCHES IN snowflake_extensions;

La commande précédente génère une sortie similaire à la suivante :

--------------------------------------------------------------------------------
| name | path           | checkouts | commit_hash                              |
--------------------------------------------------------------------------------
| main | /branches/main |           | 0f81b1487dfc822df9f73ac6b3096b9ea9e42d69 |
--------------------------------------------------------------------------------

Vous pouvez utiliser Snowsight pour voir la liste des fichiers de votre référentiel Git.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data » Databases.

3. Dans l’explorateur d’objets, sélectionnez la base de données et le schéma qui contiennent la zone de préparation du référentiel Git que vous souhaitez voir.

4. Dans le schéma, ouvrez Git Repositories.

5. Localisez et sélectionnez le référentiel pour voir sa page de détails.

6. Dans la page de détails du référentiel, dans l’onglet Files Explorer, sélectionnez le bouton Branch.

7. Dans le menu déroulant Branch, effectuez l’une des opérations suivantes :

   • Pour voir la liste des branches clonées à partir du référentiel, sélectionnez Branches.

   • Pour voir la liste des balises clonées à partir du référentiel, sélectionnez Tags.

Vous pouvez voir une liste des fichiers du référentiel en utilisant la commande LIST sous les formes suivantes (vous pouvez abréger LIST en LS) :

• Affichage par nom de branche :

  LS @repository_stage_name/branches/branch_name;
  

  Copy

• Affichage par nom de balise :

  LS @repository_stage_name/tags/tag_name;
  

  Copy

• Affichage par hash de validation :

  LS @repository_stage_name/commits/commit_hash;
  

  Copy

L’exemple suivant génère une sortie qui affiche les fichiers de la branche principale du référentiel Git snowflake_extensions :

LS @snowflake_extensions/branches/main;

La commande précédente génère une sortie similaire à la suivante :

-------------------------------------------------------------------------------------------------------------------------------------------------------
| name                                                         | size | md5 | sha1                                     | last_modified                |
-------------------------------------------------------------------------------------------------------------------------------------------------------
| snowflake_extensions/branches/main/.gitignore                | 10   |     | e43b0f988953ae3a84b00331d0ccf5f7d51cb3cf | Wed, 5 Jul 2023 22:42:34 GMT |
-------------------------------------------------------------------------------------------------------------------------------------------------------
| snowflake_extensions/branches/main/python-handlers/filter.py | 169  |     | c717137b18d7b75005849d76d89037fafc7b5223 | Wed, 5 Jul 2023 22:42:34 GMT |
-------------------------------------------------------------------------------------------------------------------------------------------------------

Vous pouvez utiliser Snowsight pour voir une liste des branches et des balises dans votre référentiel Git.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data » Databases.

3. Dans l’explorateur d’objets, sélectionnez la base de données et le schéma qui contiennent la zone de préparation du référentiel Git que vous souhaitez voir.

4. Dans le schéma, ouvrez Git Repositories.

5. Dans Git Repositories, sélectionnez un référentiel pour voir sa page de détails.

6. Dans la page de détails du référentiel, dans l’onglet Files Explorer, sélectionnez le bouton Branch.

7. Dans le menu déroulant Branch, sélectionnez l’une des options suivantes :

   • Pour voir la liste des branches clonées à partir du référentiel, sélectionnez Branches.

   • Pour voir la liste des balises clonées à partir du référentiel, sélectionnez Tags.

8. Sélectionnez la branche ou la balise dont vous souhaitez afficher les fichiers.

9. Sous le nom du référentiel, affichez la liste des dossiers et des fichiers correspondant à la sélection que vous avez effectuée.

Vous pouvez voir les propriétés des zones de préparation du référentiel en utilisant les commandes SQL SHOW GIT REPOSITORIES et DESCRIBE GIT REPOSITORY.

Les informations sur les propriétés comprennent l’URL Git d’origine, le nom de l’intégration de l’API et ses identifiants de connexion (spécifiés sous la forme d’un secret) utilisées pour se connecter au référentiel distant, etc.

DESCRIBE GIT REPOSITORY snowflake_extensions;

La commande précédente génère une sortie similaire à la suivante :

--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| CREATED_ON                    | NAME                 | DATABASE_NAME | SCHEMA_NAME | ORIGIN                                                 | API_INTEGRATION     | GIT_CREDENTIALS           | OWNER        | OWNER_ROLE_TYPE | COMMENT |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| 2023-06-28 08:46:10.886 -0700 | SNOWFLAKE_EXTENSIONS | MY_DB         | MAIN        | https://github.com/my-account/snowflake-extensions.git | GIT_API_INTEGRATION | MY_DB.MAIN.GIT_SECRET     | ACCOUNTADMIN | ROLE            |         |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Vous pouvez utiliser Snowsight pour voir les propriétés du référentiel.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data » Databases.

3. Dans l’explorateur d’objets, sélectionnez la base de données et le schéma qui contiennent la zone de préparation du référentiel Git que vous souhaitez voir.

4. Dans le schéma, ouvrez Git Repositories.

5. Dans Git Repositories, sélectionnez un référentiel pour voir sa page de détails.

6. Dans la page de détails du référentiel, sélectionnez l’onglet Git Repository Details pour voir les informations suivantes qui incluent ce qui suit :

   • L’origine du référentiel

   • L”intégration de l’API et les identifiants de connexion (spécifiés sous la forme d’un secret) utilisés par Snowflake pour interagir avec le référentiel distant

   • Les privilèges accordés sur la zone de préparation du référentiel

Vous pouvez utiliser EXECUTE IMMEDIATE FROM pour exécuter du code dans une zone de préparation de référentiel.

Le code de l’exemple suivant exécute le code de create-database.sql à partir de la zone de préparation du référentiel snowflake_extensions :

EXECUTE IMMEDIATE FROM @snowflake_extensions/branches/main/sql/create-database.sql;

Vous pouvez utiliser Snowsight pour exécuter du code SQL à partir d’un référentiel Git.

Notez que lorsque vous exécutez du code de cette manière, vous ne verrez pas la sortie générée par l’exécution du code.

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data » Databases.

3. Dans l’explorateur d’objets, sélectionnez la base de données et le schéma qui contiennent la zone de préparation du référentiel Git que vous souhaitez voir.

4. Dans le schéma, ouvrez Git Repositories.

5. Dans Git Repositories, sélectionnez un référentiel pour voir sa page de détails.

6. Dans la page de détails du référentiel, dans l’onglet Files Explorer, sélectionnez le bouton Branch.

7. Dans le menu déroulant Branch, sélectionnez l’une des options suivantes :

   • Branches pour voir la liste des branches clonées à partir du référentiel.

   • Tags pour voir la liste des balises clonées à partir du référentiel.

8. Sélectionnez la branche ou la balise contenant le fichier dont vous voulez exécuter le code.

9. Sous le nom du référentiel, sélectionnez le dossier contenant le fichier à exécuter.

10. Localisez le fichier dont vous voulez exécuter le code et sélectionnez » Execute immediate.

11. Dans la zone qui s’affiche, examinez le code contenu dans le fichier.

    Il s’agit du code que Snowflake exécutera.

12. Pour exécuter le code affiché, sélectionnez Execute Immediate.

    La page de détails affiche une notification indiquant que l’exécution du code a été lancée. Elle indique ensuite si l’exécution a réussi ou échoué.