Operações Git no Snowflake¶

Quando você quiser atualizar o estágio do seu repositório, você pode buscar o conteúdo do repositório Git integrado para o estágio do repositório usando o comando ALTER GIT REPOSITORY.

O código no exemplo a seguir atualiza o estágio do repositório com o conteúdo do repositório:

ALTER GIT REPOSITORY snowflake_extensions FETCH;

Você pode usar Snowsight para atualizar o estágio do repositório (que contém um clone do repositório remoto) a partir do repositório remoto.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Data » Databases.

3. No explorador de objetos, selecione o banco de dados e o esquema que contêm o estágio do repositório Git que você deseja atualizar.

4. Dentro do esquema, abra Git Repositories.

5. Em Git Repositories, selecione o repositório para visualizar a página de detalhes.

6. Nos detalhes do repositório, na aba Files Explorer, selecione o botão Fetch para atualizar o estágio do repositório.

Você pode visualizar ramificações e tags usando os comandos SHOW GIT BRANCHES e SHOW GIT TAGS.

O exemplo a seguir gera uma saída que lista as ramificações no repositório Git snowflake_extensions:

SHOW GIT BRANCHES IN snowflake_extensions;

O comando anterior gera uma saída semelhante à seguinte:

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

Você pode usar Snowsight para visualizar uma lista dos arquivos no seu repositório Git.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Data » Databases.

3. No explorador de objetos, selecione o banco de dados e o esquema que contêm o estágio do repositório Git que você deseja visualizar.

4. Dentro do esquema, abra Git Repositories.

5. Localize e selecione o repositório para visualizar sua página de detalhes.

6. Na página de detalhes do repositório, na aba Files Explorer, selecione o botão Branch.

7. A partir do menu suspenso Branch, faça um dos seguintes:

   • Para visualizar uma lista de ramificações clonadas do repositório, selecione Branches.

   • Para visualizar uma lista das tags clonadas do repositório, selecione Tags.

Você pode visualizar uma lista de arquivos no repositório usando o comando LIST nas seguintes formas (você pode abreviar LIST para LS):

• Listar por nome da ramificação:

  LS @repository_stage_name/branches/branch_name;
  

  Copy

• Listar por nome de tag:

  LS @repository_stage_name/tags/tag_name;
  

  Copy

• Listar por hash de commit:

  LS @repository_stage_name/commits/commit_hash;
  

  Copy

O exemplo a seguir gera uma saída que lista os arquivos na ramificação principal do repositório Git snowflake_extensions:

LS @snowflake_extensions/branches/main;

O comando anterior gera uma saída semelhante à seguinte:

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

Você pode usar Snowsight para visualizar uma lista de ramificações e tags no seu repositório Git.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Data » Databases.

3. No explorador de objetos, selecione o banco de dados e o esquema que contêm o estágio do repositório Git que você deseja visualizar.

4. Dentro do esquema, abra Git Repositories.

5. Dentro de Git Repositories, selecione um repositório para visualizar sua página de detalhes.

6. Na página de detalhes do repositório, na aba Files Explorer, selecione o botão Branch.

7. A partir do menu suspenso Branch, selecione uma das seguintes opções:

   • Para visualizar uma lista de ramificações clonadas do repositório, selecione Branches.

   • Para visualizar uma lista das tags clonadas do repositório, selecione Tags.

8. Selecione a ramificação ou tag cujos arquivos você deseja listar.

9. Abaixo do nome do repositório, visualize a lista de pastas e arquivos correspondentes à seleção que você fez.

Você pode visualizar as propriedades do estágio do repositório usando os comandos SQL SHOW GIT REPOSITORIES e DESCRIBE GIT REPOSITORY.

As informações de propriedades incluem o URL de origem do Git, nome da integração de API e credenciais (especificadas como um segredo) usadas para se conectar com o repositório remoto, e assim por diante.

DESCRIBE GIT REPOSITORY snowflake_extensions;

O comando anterior gera uma saída semelhante à seguinte:

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

Você pode usar Snowsight para visualizar as propriedades do repositório.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Data » Databases.

3. No explorador de objetos, selecione o banco de dados e o esquema que contêm o estágio do repositório Git que você deseja visualizar.

4. Dentro do esquema, abra Git Repositories.

5. Dentro de Git Repositories, selecione um repositório para visualizar sua página de detalhes.

6. Na página de detalhes do repositório, selecione a aba Git Repository Details para visualizar informações que incluem o seguinte:

   • A origem do repositório

   • A integração de API e credenciais (especificadas como um segredo) usada pelo Snowflake para interagir com o repositório remoto

   • Privilégios concedidos no estágio do repositório

Você pode usar EXECUTE IMMEDIATE FROM para executar código em um estágio de repositório.

O código no exemplo a seguir executa o código em create-database.sql do estágio de repositório snowflake_extensions:

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

Você pode usar Snowsight para executar o código SQL de um repositório Git.

Observe que, ao executar o código dessa maneira, você não verá a saída gerada pela execução do código.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Data » Databases.

3. No explorador de objetos, selecione o banco de dados e o esquema que contêm o estágio do repositório Git que você deseja visualizar.

4. Dentro do esquema, abra Git Repositories.

5. Dentro de Git Repositories, selecione um repositório para visualizar sua página de detalhes.

6. Na página de detalhes do repositório, na aba Files Explorer, selecione o botão Branch.

7. A partir do menu suspenso Branch, selecione uma das seguintes opções:

   • Branches para visualizar uma lista de ramificações clonadas do repositório.

   • Tags para visualizar uma lista das tags clonadas do repositório.

8. Selecione a ramificação ou tag que contém o arquivo cujo código você deseja executar.

9. Abaixo do nome do repositório, selecione a pasta que contém o arquivo que você deseja executar.

10. Localize o arquivo cujo código você deseja executar e selecione » Execute immediate.

11. Na caixa que aparece, revise o código contido no arquivo.

    Este é o código que o Snowflake executará.

12. Para executar o código exibido, selecione Execute Immediate.

    A página de detalhes exibe uma notificação de que a execução do código foi iniciada. Mais tarde, ele indica se a execução foi bem-sucedida ou falhou.