Snowpark Migration Accelerator: Configuração do projeto¶

Página inicial¶

A seção a seguir explica cada opção disponível:

• Start - Abre a Página do projeto, onde você pode criar um novo projeto, abrir um projeto existente ou explorar um projeto de amostra.

• Activate - Abre a página de ativação, onde é possível inserir ou solicitar um código de acesso se você ou sua organização for elegível.

Página do projeto¶

Na página do projeto, você encontrará as três opções a seguir:

Página do Projeto Accelerator

Nessa página, você encontrará três opções disponíveis:

• Open Project - Navegue e selecione um arquivo de projeto criado anteriormente. Para obter mais detalhes sobre como abrir um projeto existente, consulte mais informações sobre como abrir um projeto existente.

• New Project - Selecione essa opção para criar um novo projeto. Saiba mais sobre a criação de um novo projeto.

• Veja o projeto de amostra - Experimente um projeto de amostra para se familiarizar com o SMA. Para obter instruções passo a passo, acesse o guia para executar o projeto de amostra.

Criando um novo projeto¶

Clicar no botão «New Project» abrirá a tela de criação do projeto.

A página de criação de projeto contém vários campos que você precisa preencher.

1. Project Name: Digite um nome para seu projeto. Esse nome será usado para armazenar suas configurações e rastrear várias execuções. Mais detalhes sobre os arquivos de projeto são fornecidos abaixo.

2. Input Folder Path: Selecione a pasta que contém seu código-fonte. Observe que o SMA analisará apenas os tipos de arquivos compatíveis. Você pode:

   • Escolher uma subpasta ou um arquivo específico usando os botões de opção ao lado dos nomes das pastas

   • Analisar apenas parte de sua base de código, selecionando um subdiretório específico

• Observação: Quando você passa o mouse sobre um rótulo de caminho, uma dica de ferramenta exibe o caminho completo. Isso se aplica a todos os campos que contêm caminhos encurtados (caminho da pasta de entrada, caminho da pasta de saída, etc.).

  • O arquivo de projeto .snowma é criado nesse diretório quando você cria o projeto. Veja abaixo mais detalhes sobre essa pasta.

3. Output Folder Path: Selecione o diretório em que o SMA armazenará os arquivos de saída, incluindo registros, relatórios e código convertido (no modo de conversão).

4. SQL Language: Selecione SparkSQL ou HiveSQL com base em seu código-fonte. (Opcional)

5. Email Address: Digite seu endereço de e-mail para se identificar como um usuário da ferramenta. A Snowflake só usará esse e-mail para lhe enviar o relatório de qualificação do Snowpark e seu código de acesso de conversão se você prosseguir para o modo de conversão.

6. Customer’s Company: Digite o nome da organização com cujo código você está trabalhando. Se estiver analisando seu próprio código, digite o nome da sua organização. Se estiver trabalhando com o código de outra organização, digite o nome dela. Isso ajuda a organizar os projetos por organização.

Todos os campos devem ser preenchidos para executar a ferramenta.

Após concluir a configuração do projeto, você tem três opções:

• Clique em «Save & Start Assessment» para salvar seu projeto e iniciar o processo de avaliação

• Clique em «Save & Skip Assessment» para salvar seu projeto sem executar uma avaliação

• Clique em «Cancel» para sair sem salvar

Antes de prosseguir com o processo de conversão, você precisa decidir se vai realizar uma avaliação. Recomendamos começar com a avaliação, a menos que tenha certeza de que deseja passar diretamente para a conversão. Se tiver alguma dúvida, é melhor começar com a fase de avaliação.

Ao clicar em «Cancel», o usuário retorna à tela principal. Se escolher «Start» ou «Skip» as configurações do projeto serão salvas em um arquivo .snowma. Esse arquivo permite reabrir o projeto mais tarde com todas as configurações intactas.

Notas sobre o arquivo de projeto SMA (.snowma)¶

O arquivo .snowma é um arquivo de configuração de projeto que armazena as configurações do projeto e o histórico de avaliações. Esse arquivo permite:

• Executar novamente a ferramenta usando as mesmas definições de configuração

• Acessar e revisar dados de avaliação de execuções anteriores

Sempre que você clicar em «Save & Skip Assessment» ou «Save & Start Assessment», o SMA criará um arquivo de projeto (com extensão .snowma) na pasta de entrada selecionada. Esse arquivo de projeto, marcado com o ícone SMA, contém o código-fonte que você deseja converter.

Como usuário, você terá os seguintes recursos:

• Clicar duas vezes no arquivo .snowma para abrir um projeto existente

• Clicar em «Open Project» na tela principal para abrir um projeto existente

Página do projeto

Visualização de projetos abertos recentemente: Para ver uma lista de seus projetos abertos recentemente no SMA, clique em File > Open Recents na barra de menus.

Quando você retomar qualquer um desses fluxos de trabalho, a ferramenta o levará de volta ao mesmo ponto em que parou na sessão anterior.

Abrir um projeto¶

Na tela principal, clique em Open Project para iniciar o navegador de arquivos. Selecione um arquivo de projeto com extensão .snowma para abrir a página de criação de projeto. Essa ação funciona independentemente do status de conclusão do seu projeto.

O painel de navegação na página Project Creation permite revisitar as telas acessadas anteriormente.

Depois de preencher os detalhes do projeto, clique em «Save & Start Assessment» para começar a executar o acelerador.

A seção a seguir explica as opções de configuração e definições disponíveis ao usar o aplicativo.