Snowpark Migration Accelerator: Configuração e definições

A configuração de um novo projeto com o Snowpark Migration Accelerator (SMA) é um processo simples. Esta página explica todas as configurações, atualizações e opções de personalização disponíveis no aplicativo.

Atualização do aplicativo

O Snowpark Migration Accelerator (SMA) verifica automaticamente se há novas versões quando você inicia o programa. Se uma versão mais recente estiver disponível, você verá uma mensagem de notificação no canto superior direito da tela.

Atualizações pendentes

Se você selecionar «Update Now», o aplicativo fará imediatamente o download e instalará a versão mais recente.

Download da atualização

Após a conclusão do download, clique em «Close and Install» para atualizar o aplicativo.

Download bem-sucedido

Depois que o aplicativo for reiniciado, você poderá verificar o número da versão atual no canto superior direito da janela.

Atualização concluída

Verificação de atualizações

Para verificar se há uma nova versão do aplicativo, clique na opção «Check for Updates» no menu.

Se o seu aplicativo estiver atualizado, você verá uma notificação no canto superior direito confirmando esse status.

Verificação de atualizações - atualizado

Se o seu aplicativo não estiver executando a versão mais recente, você será solicitado a atualizá-lo.

Verificação de atualizações - Atualizar

Configurações de conversão

Antes de iniciar um processo de conversão, você pode definir as configurações de conversão usando uma dessas duas opções:

Na barra de menus na parte superior da tela:

Opção da barra de menus para configurações de conversão

Na tela de conversão:

Opção de configuração de conversão

A seção de configurações de conversão contém uma lista das configurações de conversão disponíveis. Para acessar essas configurações:

Converter Pandas em Snowpark: Escolha se o código do Pandas deve ser convertido automaticamente para o Pandas equivalente do Snowpark API (Snow Pandas). Quando ativada, a ferramenta transformará todas as operações do Pandas que encontrar no seu código em suas contrapartes do Snowpark.

Configurações de conversão

Sobre

Para visualizar as informações de versão da instalação do Snowpark Migration Accelerator, clique na opção About Snowpark Migration Accelerator no menu.

Sobre o Snowpark Migration Accelerator

Para analisar as alterações entre versões diferentes, consulte as notas de versão.

Menu File

No menu File, você pode:

  • Criar um novo projeto selecionando New Project

  • Abrir um projeto usado anteriormente no menu Open Recents

Menu File

Quando selecionar «New Project» ou abrir um projeto diferente, aparecerá um aviso perguntando se deseja «Save Changes & Create New Project».

Menu de ajuda

O menu de ajuda oferece várias opções de suporte adaptadas às suas necessidades específicas.

Menu Help

As seções a seguir descrevem cada opção disponível no menu de ajuda.

Documentação

Para retornar à página principal da documentação (Welcome!), clique aqui.

Notas de lançamento

As notas de lançamento podem ser encontradas na seção geral do nosso site de documentação. Clique aqui para visualizá-las.

Glossário

A opção Glossary o direciona para a seção de Glossário, onde é possível encontrar definições de termos usados em toda esta documentação.

Solicitar novo código de acesso

Os códigos de acesso são necessários para usar os recursos de conversão do SMA. Você deve ter um código de acesso válido para realizar qualquer conversão.

Você pode obter um código de acesso clicando em Inquire about an access code no menu de ajuda.

Informe-se sobre um código de acesso no menu Help

O formulário Request Access Code será exibido (conforme mostrado abaixo). Se precisar de um código de acesso ou se não tiver certeza de que possui um, entre em contato com a equipe de suporte do Snowpark Migration Accelerator (SMA) em sma-support@snowflake.com.

Ao solicitar um código de acesso, o Snowpark Migration Accelerator (SMA) solicitará que forneça as seguintes informações:

Solicitar um código de acesso

O código de acesso será enviado para o endereço de e-mail fornecido. Todos os campos devem ser preenchidos para receber seu código de acesso.

Entre em contato conosco

O botão Fale conosco abre seu aplicativo de e-mail padrão. Quando clicado, ele permite que você envie um e-mail para sma-info@snowflake.com para discutir quaisquer dúvidas ou preocupações sobre o Snowpark Migration Accelerator.

Para obter outras formas de entrar em contato com a equipe do Snowpark Migration Accelerator (SMA ), visite a seção fale conosco.

Relatar um problema

Você pode relatar problemas a qualquer momento. Isso inclui problemas encontrados durante a execução da ferramenta ou quaisquer outras preocupações relacionadas ao uso da ferramenta.

Quando selecionar esse problema, será exibido um formulário.

Relatar um problema

Para nos ajudar a resolver seu problema rapidamente, forneça:

  1. Uma descrição detalhada do problema

  2. Seu endereço de e-mail para que possamos entrar em contato

  3. Quaisquer arquivos relevantes, como capturas de tela que mostrem o problema

  4. Arquivos de registro de quando executou a ferramenta

Depois de enviar o problema, a equipe de suporte do SMA será notificada. Se forneceu seu endereço de e-mail, nossa equipe entrará em contato imediatamente.

Configurações online

O Snowpark Migration Accelerator (SMA) se conecta ao Snowflake para realizar operações específicas. É importante observar que seu código nunca é transmitido para a Snowflake. A ferramenta se comunica com o Snowflake em três situações específicas:

  1. Quando um usuário solicita validação ou faz uma solicitação específica

  2. Quando uma execução é iniciada

  3. Durante a inicialização da ferramenta

Você pode desativar o segundo e o terceiro tipos de comunicação por meio do menu Online Settings. Vamos examinar os detalhes de cada cenário de comunicação.

A ferramenta SMA se comunica com o Snowflake por meio de uma API de telemetria para as seguintes atividades:

  • Solicitar um código de acesso

  • Verificar se o código de acesso é válido

  • Enviar problemas para o Snowflake quando os usuários preencherem o formulário [Relatar um problema] (configuration-and-settings.md#report-an-issue)

  • Enviar relatórios de falhas e registros de erros fatais para a Snowflake quando os usuários concordarem em relatá-los

  • Baixar e instalar atualizações de ferramentas

O SMA envia informações resumidas para uma API de telemetria sempre que a ferramenta é executada. Estas informações incluem:

  • Detalhes da avaliação do projeto, incluindo informações sobre o projeto e estatísticas sobre os padrões de uso do Spark

  • Métricas de uso da ferramenta, incluindo dados de interação de botões e registros operacionais

Quando você inicia a ferramenta, ela faz uma única conexão com o Snowflake para verificar suas credenciais e seu acesso.

Verifique se há uma versão mais recente disponível.

Você pode ativar ou desativar todas essas configurações de informações. Para modificar essas configurações, siga estas etapas:

  1. Abra o menu Help no SMA

  2. Selecione Online Settings

Observe que o SMA pode funcionar completamente off-line após a definição dessas configurações.

Escolhendo Online Settings no menu Help

Quando você clica em Online Settings, é exibido um menu com as seguintes opções:

O menu de configurações online

Você pode ativar ou desativar qualquer uma dessas configurações de acordo com suas necessidades.

A ferramenta pode funcionar sem conexão com a Internet. No modo off-line, você pode executar avaliações sem problemas. No entanto, para realizar as conversões, a ferramenta precisa validar seu código de acesso online. Se não conseguir se conectar à Internet, entre em contato com a equipe SMA pelo e-mail sma-support@snowflake.com para solicitar um código de acesso off-line especial.

EULA

Este link direciona o usuário para a página do Contrato de licença do usuário final (EULA), onde você pode analisar os termos de uso.


Vamos começar a usar a ferramenta Snowpark Migration Accelerator (SMA) para converter seu código.