Sincronização dos notebooks Snowflake com um repositório Git

Para usar o controle de versão com seus notebooks Snowflake, você pode sincronizar o desenvolvimento do notebook com uma ramificação em um repositório Git.

Você já deve ter configurado sua conta Snowflake para ser conectada a um repositório Git e criado uma ramificação nesse repositório para usar no desenvolvimento do notebook. Consulte Configuração do Snowflake para usar o Git.

Criação de um notebook a partir de um arquivo em um repositório Git

Nota

O arquivo deve ser um arquivo formatado .ipynb e deve usar o formato de notebook (nbformat) 4.0 ou superior.

Para criar um notebook Snowflake a partir de um arquivo em um repositório Git, faça o seguinte:

  1. Faça login no Snowsight.

  2. Selecione Projects » Notebooks.

  3. Ao lado de + Notebook, abra o menu suspenso e selecione Create from repository.

  4. Para File location in repository, selecione o repositório e a ramificação no repositório com o arquivo do notebook e escolha o arquivo .ipynb específico.

  5. Para Notebook location, selecione um banco de dados e um esquema para conter o notebook. Este parâmetro não pode ser alterado após a criação do notebook.

  6. Para Notebook warehouse, selecione um warehouse.

  7. Selecione Create para criar um notebook Snowflake a partir do arquivo .ipynb em seu repositório Git.

Conexão de um notebook existente a um repositório Git

Para conectar um notebook Snowflake existente a um repositório Git, faça o seguinte:

Nota

Você deve usar uma função com os seguintes privilégios, no mínimo:

  • Privilégio OWNERSHIP ou READ no repositório Git.

  • Privilégio USAGE no esquema com o repositório Git.

Consulte Requisitos de controle de acesso.

  1. Faça login no Snowsight.

  2. Selecione Projects » Notebooks e abra ou crie um notebook Snowflake.

  3. Na aba Files, ao lado do explorador de objetos de banco de dados, selecione Connect Git Repository.

  4. Para File location in repository, selecione o repositório e a ramificação no repositório com o qual deseja sincronizar o notebook.

  5. Selecione Select Folder.

  6. Em seguida, você será solicitado a enviar seu notebook ao repositório Git. Conclua as etapas de confirmação descritas na seção Confirmação de alterações em uma ramificação em um repositório Git.

Após conectar seu notebook a um repositório Git, você pode selecionar o nome da ramificação e abrir os detalhes do repositório no Snowflake ou Github.

Confirmação de alterações em uma ramificação em um repositório Git

Se um notebook Snowflake estiver conectado a uma ramificação em um repositório Git, após fazer as alterações no notebook Snowflake, você poderá confirmar suas alterações na ramificação.

Você deve usar uma função com o privilégio OWNERSHIP ou WRITE no repositório Git para confirmar suas alterações. Consulte Requisitos de controle de acesso.

  1. Faça login no Snowsight.

  2. Selecione Projects » Notebooks e abra um notebook Snowflake.

  3. Faça quaisquer alterações relevantes no notebook.

  4. Selecione Commit.

  5. Na caixa de diálogo Commit to Repository exibida, você pode revisar o nome de usuário e o endereço de e-mail usados para confirmar as alterações na ramificação e repositório especificados. Se você precisar atualizar o nome de usuário e o endereço de e-mail, expanda a seção Credentials e atualize Author name e Author email.

  6. Para Commit message, insira uma mensagem para incluir em sua confirmação.

  7. Expanda a seção Credentials para configurar as credenciais. Insira seu token de acesso pessoal para o repositório Git no campo Personal access token. Este token de acesso vem do provedor Git remoto, como o Github.

    • Este token é necessário para autenticação no repositório Git.

    • O token deve ter acesso de leitura e gravação ao conteúdo do repositório para que a confirmação funcione.

    • Uma vez inserido, o token será salvo para confirmações futuras. Você pode atualizá-lo durante quaisquer confirmações futuras.

  8. Selecione Commit.

Uma mensagem de confirmação informa que suas alterações foram confirmadas em sua ramificação.

Sincronizar um notebook com uma ramificação remota em um repositório Git

Após conectar seu notebook a uma ramificação em um repositório Git, você pode sincronizar quaisquer alterações na ramificação remota com seu notebook Snowflake.

  1. Faça login no Snowsight.

  2. Selecione Projects » Notebooks e abra ou crie um notebook Snowflake.

  3. No explorador de objetos de banco de dados, na aba Files, selecione Pull.

O Snowflake busca quaisquer alterações presentes na ramificação do repositório remoto e funde o conteúdo do notebook com essas alterações.

Fusão de conflitos

O Snowflake tenta resolver conflitos de fusão que ocorrem durante uma sincronização. Se houver conflitos de fusão que o Snowflake não conseguir resolver, você receberá uma mensagem para descartar suas alterações ou confirmá-las para uma nova ramificação. Quando elas forem confirmadas em uma nova ramificação, use seu provedor Git para fundir manualmente suas alterações da nova ramificação para a ramificação original. Em seguida, você deve efetuar pull das últimas atualizações para seu notebook Snowflake.