Configuração do Snowflake para usar o Git¶

Configurar para nenhuma autenticação¶

Para configurar o Snowflake para usar um repositório Git sem autenticação, siga estas etapas:

1. Crie uma integração de API que ofereça suporte ao acesso sem autenticação e especifique os seguintes detalhes:

   • git_https_api como o valor do parâmetro API_PROVIDER

   • Pontos de extremidade HTTPS aos quais solicitações devem ser limitadas como valores do parâmetro API_ALLOWED_PREFIXES

   Para obter mais informações, consulte CREATE API INTEGRATION.

   CREATE OR REPLACE API INTEGRATION my_git_api_integration
     API_PROVIDER = git_https_api
     API_ALLOWED_PREFIXES = ('https://example.com/my-account')
     ENABLED = TRUE;
   

   Copy

2. Criar um clone do repositório Git conforme descrito em Criação de um clone do repositório Git do Snowflake

Configuração do para autenticação com um token¶

Para que o Snowflake seja autenticado no repositório Git usando um nome de usuário e token, como um token de acesso pessoal (PAT), siga estes passos:

1. Fornecimento de credenciais em um segredo de autenticação básica.

   Para fornecer as credenciais que o Snowflake usa para autenticar no repositório, crie um segredo contendo o seguinte:

   • Um valor TYPE de password

   • Um nome de usuário e token, como um token de acesso pessoal (PAT)

     Se seu repositório Git estiver hospedado no Bitbucket, especifique x-token-auth como o valor do nome de usuário.

     Nota

     Para obter informações sobre como criar um token de acesso pessoal em GitHub, consulte Como gerenciar seus tokens de acesso pessoal na documentação do GitHub.

   Para obter mais informações sobre o comando SQL para criar um segredo, consulte CREATE SECRET.

   O código no exemplo a seguir cria um segredo chamado my_git_secret com um nome de usuário e o token de acesso pessoal do usuário para usar como credenciais:

   CREATE OR REPLACE SECRET my_git_secret
     TYPE = password
     USERNAME = 'gladyskravitz'
     PASSWORD = 'ghp_token';
   

   Copy

2. Crie uma integração de API que ofereça suporte à autenticação com um token.

   Para criar uma integração de API para acesso a um repositório Git sem autenticação, especifique os seguintes detalhes:

   • git_https_api como o valor do parâmetro API_PROVIDER

   • Pontos de extremidade HTTPS aos quais solicitações devem ser limitadas como valores do parâmetro API_ALLOWED_PREFIXES

   Para obter mais informações, consulte CREATE API INTEGRATION.

   CREATE OR REPLACE API INTEGRATION my_git_api_integration
     API_PROVIDER = git_https_api
     API_ALLOWED_PREFIXES = ('https://github.com/my-account')
     ALLOWED_AUTHENTICATION_SECRETS = (my_git_secret)
     ENABLED = TRUE;
   

   Copy

3. Criar um clone do repositório Git conforme descrito em Criação de um clone do repositório Git do Snowflake

Configuração do para autenticação com OAuth¶

Para configurar o Snowflake para que ele seja autenticado no repositório Git remoto usando um fluxo OAuth, siga estes passos:

1. Crie uma integração de API que ofereça suporte à autenticação por meio de OAuth.

   Ao especificar a autenticação com um fluxo OAuth2, crie uma integração de API que especifique o seguinte:

   • git_https_api como o valor do parâmetro API_PROVIDER

   • Pontos de extremidade HTTPS aos quais solicitações devem ser limitadas como valores do parâmetro API_ALLOWED_PREFIXES

     Este deve ser um prefixo em https://github.com. A autenticação com OAuth é compatível somente com repositórios hospedados em github.com.

   • Um API_USER_AUTHENTICATION cujo valor é (TYPE = SNOWFLAKE_GITHUB_APP)

   Para obter mais informações, consulte CREATE API INTEGRATION.

   O código no exemplo a seguir cria uma integração de API chamada my_git_api_integration:

   CREATE OR REPLACE API INTEGRATION my_git_api_integration
     API_PROVIDER = git_https_api
     API_ALLOWED_PREFIXES = ('https://github.com')
     API_USER_AUTHENTICATION = (TYPE = SNOWFLAKE_GITHUB_APP)
     ENABLED = TRUE;
   

   Copy

2. Crie um espaço de trabalho conectado a um repositório Git, conforme descrito em Criar um espaço de trabalho Git.

Configuração da conexão do Private Link¶

Antes de configurar o Snowflake para acessar o repositório Git remoto, você deve configurar um link privado entre o Snowflake e seu provedor de serviços de nuvem.

Para aplicar alterações de configuração ao Snowflake e à sua infraestrutura, siga estas etapas:

1. No seu provedor de serviços de nuvem, crie um serviço de link privado para receber solicitações do serviço de ponto de extremidade privado do Snowflake.

   Para obter mais detalhes, consulte o artigo da base de conhecimento Configuração da integração do Git com o Snowflake pelo Private Link.

2. No Snowflake, forneça um ponto de extremidade privado que chegará à sua infraestrutura por meio de um IP privado.

   Para provisionar o ponto de extremidade, use a função SYSTEM$PROVISION_PRIVATELINK_ENDPOINT com os dois argumentos a seguir:

   • ID do serviço de link privado de seu provedor de nuvem

   • Nome de domínio do seu servidor Git

   AWSAzure

   SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
     'com.amazonaws.vpce.us-west-2.vpce-svc-xxx', // VPC Endpoint Service Name
     'git_address.com' // Git server domain
   );
   

   Copy

3. Em seu provedor de serviços de nuvem, aceite a configuração do ponto de extremidade privado do Snowflake para terminar de configurar a conexão do link privado.

4. Para verificar o status do provisionamento, chame a função do sistema SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO.

Configuração do acesso do Snowflake ao repositório Git remoto¶

Depois de configurar um link privado entre o Snowflake e seu provedor de serviços de nuvem, você pode configurar o acesso do Snowflake ao repositório Git remoto.

1. Crie uma integração de API que ofereça suporte à autenticação com um certificado.

   Como o Snowflake acessará seu servidor Git usando o protocolo HTTPS, o nome de domínio precisa ter um certificado válido. A configuração usada difere dependendo se você usa um certificado autoassinado ou um certificado assinado por uma autoridade de certificação.

   • Uso de um certificado autoassinado:

     

     1. Fornecimento de credenciais em um segredo da cadeia de caracteres genérica.

        Esta deve ser uma chave pública de um domínio autoassinado para estabelecer uma conexão HTTPS. Para fornecer ao Snowflake as credenciais que ele usará para autenticação no servidor, crie um segredo que contenha os seguintes detalhes:

        • Um valor de parâmetro TYPE de GENERIC_STRING

        • Uma cadeia de caracteres de certificado público como o valor do parâmetro SECRET_STRING

          Para o valor do parâmetro, especifique uma cadeia de caracteres secreta, como um corpo de certificação público.

        CREATE OR REPLACE SECRET my_public_certificate
          TYPE = GENERIC_STRING
          SECRET_STRING = '-----BEGIN CERTIFICATE-----
                    <certificate_body>
                    -----END CERTIFICATE-----';
        

        Copy

     2. Crie uma integração de API para integrar com a API Git e especifique os seguintes detalhes:

        • Um parâmetro API_PROVIDER definido como git_https_api

        • Um API_ALLOWED_PREFIXES definido como a URL base abaixo da qual o acesso é permitido

        • Um parâmetro USE_PRIVATELINK_ENDPOINT definido como TRUE

        • Um parâmetro TLS_TRUSTED_CERTIFICATES definido como o nome do segredo que você criou, que contém o certificado

        Para obter mais informações, consulte CREATE API INTEGRATION.

        CREATE OR REPLACE API INTEGRATION my_git_api_integration
          API_PROVIDER = git_https_api
          API_ALLOWED_PREFIXES = ('https://example.com/my-account')
          ALLOWED_AUTHENTICATION_SECRETS = ALL
          USE_PRIVATELINK_ENDPOINT = TRUE
          TLS_TRUSTED_CERTIFICATES = (my_public_certificate)
          ENABLED = TRUE;
        

        Copy

   • Usando um certificado assinado por uma autoridade de certificação:

     

     1. Crie uma integração de API para integrar com a API Git e especifique os seguintes detalhes:

        • Um parâmetro API_PROVIDER definido como git_https_api

        • Um API_ALLOWED_PREFIXES definido como a URL base abaixo da qual o acesso é permitido

        • Um parâmetro USE_PRIVATELINK_ENDPOINT definido como TRUE

        • Um parâmetro TLS_TRUSTED_CERTIFICATES definido como o nome do segredo que você criou, que contém o certificado

        Para obter mais informações, consulte CREATE API INTEGRATION.

        CREATE OR REPLACE API INTEGRATION my_git_api_integration
          API_PROVIDER = git_https_api
          API_ALLOWED_PREFIXES = ('https://example.com/my-account')
          ALLOWED_AUTHENTICATION_SECRETS = ALL
          USE_PRIVATELINK_ENDPOINT = TRUE
          ENABLED = TRUE;
        

        Copy

2. Fornecimento de credenciais em um segredo de autenticação básica.

   Após conectar-se com sucesso ao servidor Git por meio do link privado, você ainda deve se autenticar no repositório criando outro segredo que fornece credenciais para o repositório.

   Para fornecer as credenciais que o Snowflake usa para autenticar no repositório, crie um segredo contendo o seguinte:

   • Um valor TYPE de password

   • Um nome de usuário e token, como um token de acesso pessoal (PAT)

     Nota

     Para obter informações sobre como criar um token de acesso pessoal em GitHub, consulte Como gerenciar seus tokens de acesso pessoal na documentação do GitHub.

   Para obter mais informações sobre o comando SQL para criar um segredo, consulte CREATE SECRET.

3. Criar um clone do repositório Git conforme descrito em Criação de um clone do repositório Git do Snowflake