Configuração de um repositório Git

Você pode integrar seu repositório Git remoto com o Snowflake para que os arquivos do repositório sejam sincronizados com um tipo especial de estágio chamado estágio de repositório. O estágio do repositório atua como um repositório Git local com um clone completo do repositório remoto, incluindo ramificações, tags e commits.

Para obter mais informações, consulte Uso de um repositório Git no Snowflake.

Antes de começar

Antes de configurar um repositório Git, você precisa das seguintes informações:

  • URL do repositório remoto (também chamado de origin no Git).

  • Credenciais opcionais para conectar-se ao Git, incluindo um segredo, nome de usuário e senha.

  • ID da integração de API opcional.

  • Função ou usuário com privilégios para criar integrações de API, caso você ainda não tenha uma integração de API.

Para obter mais informações, consulte Configuração do Snowflake para usar o Git.

Configuração de um repositório Git

Para clonar um repositório Git no estágio de repositório Git, use o comando snow git setup, conforme mostrado:

snow git setup <REPO_NAME>

onde:

  • <REPO_NAME> é o ID do estágio do repositório que você deseja criar. Observe que se o estágio do repositório já existir, o comando falhará.

O comando snow git setup fornece uma série de prompts para coletar as informações necessárias, conforme mostrado nos exemplos a seguir:

  • Crie um repositório que exija um segredo e credenciais:

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

    Secret 'new_secret' successfully created.
API integration snowcli_git_api_integration successfully created.
+------------------------------------------------------+
| status                                               |
|------------------------------------------------------|
| Git Repository SNOWCLI_GIT was successfully created. |
+------------------------------------------------------+

  • Crie um repositório sem um segredo e um ID de integração de API existente:

    $ 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

    Using existing API integration 'EXISTING_INTEGRATION'.
+------------------------------------------------------+
| status                                               |
|------------------------------------------------------|
| Git Repository SNOWCLI_GIT was successfully created. |
+------------------------------------------------------+

Se a função ou usuário especificado em sua conexão não foi concedido, a execução deste comando gera um erro semelhante ao seguinte:

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

Nessa situação, você deve verificar sua configuração de conexão ou pedir ao administrador da sua conta para lhe dar os privilégios necessários ou criar a integração para você. Para obter mais informações, consulte Configuração do Snowflake para usar o Git