Operações Git no Snowflake¶

Para obter informações sobre o uso de SQL para configurar uma integração com um repositório Git, consulte Configuração do Snowflake para usar o Git.

Em Snowsight, você pode usar espaços de trabalho para integração com um repositório Git.

Você pode buscar do repositório Git remoto para o clone do repositório Git no Snowflake usando o comando ALTER GIT REPOSITORY.

O código no exemplo a seguir atualiza o clone do repositório Git com o conteúdo do repositório:

ALTER GIT REPOSITORY snowflake_extensions FETCH;

Você pode usar Snowsight para buscar no 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 clone do repositório Git para o qual você deseja buscar.

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 buscar no repositório remoto.

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 clone 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, especificando o clone do repositório Git como se fosse um estágio (você pode abreviar LIST como LS):

• Listar por nome da ramificação:

  LS @repository_name/branches/branch_name;
  

  Copy

• Listar por nome de tag:

  LS @repository_name/tags/tag_name;
  

  Copy

• Listar por hash de commit:

  LS @repository_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 clone 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 clone do repositório Git 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 clone 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 os seguintes detalhes:

   • 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 clone do repositório Git

Você pode usar EXECUTE IMMEDIATE FROM para executar o código em um clone do repositório Git.

O código no exemplo a seguir executa o código em create-database.sql a partir do clone do repositório Git 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 clone 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.