Sincronizar notebooks com um repositório Git¶

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

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. No menu de navegação, 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. Para obter detalhes sobre como conectar o Snowflake ao seu repositório Git, consulte Configuração do Snowflake para usar o Git.

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:

Para saber como se conectar ao seu repositório Git, consulte Configuração do Snowflake para usar o Git.

Para obter mais detalhes, consulte Requisitos de controle de acesso.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Projects » Notebooks e abra ou crie um notebook.

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. Quando for solicitado que você confirme e envie o notebook para o repositório Git, conclua as etapas de envio para o Git descritas em Envio de alterações para uma ramificação em um repositório Git.

   Quando o notebook é enviado com êxito para o repositório Git, uma nova pasta é criada para o notebook no local selecionado na ramificação do repositório Git, e todos os arquivos e pastas desse local são sincronizados com o notebook. É possível selecionar o nome da ramificação e abrir os detalhes do repositório no Snowflake ou no Git.

Envio de alterações para 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 alterações no notebook, é possível enviar suas alterações para a ramificação.

É necessário usar uma função com o privilégio OWNERSHIP ou WRITE no repositório Git para enviar por push as alterações. Para obter mais detalhes, consulte Requisitos de controle de acesso.

1. Faça login no Snowsight.

2. No menu de navegação, selecione Projects » Notebooks e abra um notebook.

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

4. Selecione Push to Git.

5. Na caixa de diálogo Push to Git que aparece, é possível revisar o nome de usuário e o endereço de e-mail usados para confirmar as alterações na ramificação e no 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 remoto do Git, 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 Push.

Uma mensagem de confirmação informa que suas alterações foram enviadas com sucesso para a 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. No menu de navegação, selecione Projects » Notebooks e abra ou crie um notebook.

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.