Sincronizar aplicativos Streamlit in Snowflake com um repositório Git

Para usar o controle de versão com seus aplicativos Streamlit, é possível sincronizar o aplicativo 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 ter criado uma ramificação nesse repositório para usar com seu aplicativo. Consulte Configuração do Snowflake para usar o Git.

Nota

Para aplicativos Streamlit criados usando o parâmetro herdado ROOT_LOCATION, não há suporte para a integração do Git.

Criar um aplicativo Streamlit in Snowflake a partir de um arquivo em um repositório Git

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit.

  3. Ao lado de + Streamlit, 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 que contém o arquivo do aplicativo Streamlit e, em seguida, selecione o arquivo .py 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 App location, selecione um banco de dados e um esquema para conter o aplicativo Streamlit. Você não pode alterá-los depois de criar o aplicativo.

  6. Para Query warehouse e App warehouse, selecione um warehouse.

  7. Selecione Create para criar um aplicativo Streamlit a partir do arquivo .py no seu repositório Git.

Conectar um aplicativo Streamlit in Snowflake existente a um repositório Git

Nota

Para conectar um aplicativo Streamlit a um repositório Git, você deve usar uma função com, no mínimo, os seguintes privilégios:

  • OWNERSHIP ou READ no repositório Git

  • USAGE no esquema que contém o repositório Git

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit e, em seguida, abra ou crie um aplicativo Streamlit.

  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 você deseja sincronizar o aplicativo Streamlit.

  5. Selecione Select Folder.

  6. Quando o prompt para confirmar o aplicativo no repositório Git for exibido, conclua as etapas de confirmação descritas em Envio de alterações para uma ramificação em um repositório Git.

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

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

Se um aplicativo Streamlit estiver conectado a uma ramificação em um repositório Git, depois de fazer alterações no aplicativo, você pode enviar as alterações para a ramificação.

Nota

É necessário usar uma função com o privilégio OWNERSHIP ou WRITE no repositório Git para enviar por push as alterações.

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit e abra um aplicativo Streamlit.

  3. Faça as alterações relevantes no aplicativo Streamlit.

  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 aplicativo Streamlit in Snowflake com uma ramificação remota em um repositório Git

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

Para sincronizar um aplicativo Streamlit com uma ramificação remota em um repositório Git:

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit e, em seguida, abra ou crie um aplicativo Streamlit.

  3. Na guia Files no explorador de objetos de banco de dados, selecione Pull.

O Snowflake busca todas as alterações presentes na ramificação do repositório remoto e mescla o conteúdo 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 mesclagem que o Snowflake não conseguir resolver, você receberá uma mensagem para descartar ou enviar suas alterações 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 obter as atualizações mais recentes no aplicativo Streamlit.