Snowpark Migration Accelerator: Executando a ferramenta

Agora que instalou o Snowpark Migration Accelerator (SMA) e preparou sua base de código, pode começar o processo de execução. Retorne ao aplicativo SMA se ele ainda estiver aberto, ou inicie-o se o tiver fechado.

Configuração do projeto

When you first open the SMA, the project page is shown.

Página do projeto

No menu, selecione «New Project» para começar. Se já tiver criado um projeto para este passo a passo, poderá acessá-lo selecionando «Open Project».

The «Project Creation» page allows you to create a new project file, which is essential for both assessment and code conversion tasks in SMA. The project file (with a .snowct extension) is stored in your selected output directory and keeps track of all your SMA executions. If you want to link multiple executions together, you can reopen an existing project file. All project information is saved both on your local machine and in the shared database. For more details about projects, see the «project» file.

All fields shown are required for configuring the assessment tool and managing the project after running the analysis.

Página de criação de projeto

  1. Project name: This is the name for your project file. Multiple executions can be connected to a single project as well as any settings you save. You can learn more about the project file below.

  2. Email address: This email address identifies the user of the tool. This should be the user of the tool, not the owner of the codebase being scanned.

  3. Company name: This is to help you specify the organization’s code you are working with. If you are running your own code, then put your own organization here. If you are working with another organization, then put that organization name here.

  4. Input folder: Specify the directory where your source codebase is located.

  5. Output folder: The directory where the output files (logs, reports, code) will be placed.

Para este passo a passo, usaremos a base de código «Spark Data Engineering Examples». Você pode encontrá-lo na seção de exemplos de base de código. Siga estes passos:

  1. Faça o download e descompacte a base de código

  2. Localize o diretório raiz que contém todos os arquivos - esse será seu diretório de entrada

  3. Escolha o nome de projeto que preferir

  4. Selecione um diretório de saída (a ferramenta sugerirá um local padrão, mas você pode alterá-lo conforme necessário)

Antes de iniciar a avaliação, verifique se o diretório de entrada contém os arquivos de código-fonte corretos com as extensões de arquivo adequadas, conforme explicado na seção de preparação de código.

When you are ready to begin, click Save to save your project.

After you save, the SMA takes you to the project home page. Select the Code Process tile to start the guided assessment or conversion workflow:

Home Code Process Tile

In the Assessment Settings page, you’ll be prompted to choose whether to Skip Assessment or Start Assessment. Select Start Assessment, then click Continue to begin the assessment run:

Code Process Conversion Settings Start Assessment

Execução e avaliação de resultados

Quando você inicia o processo de avaliação, o SMA analisa o código-fonte em três etapas:

  1. Primeiro, ele executa uma verificação básica para criar um inventário de todos os arquivos e palavras-chave em sua base de código.

  2. Em seguida, ele analisa o código de acordo com sua linguagem de origem e cria um modelo semântico que representa a funcionalidade do código.

  3. Finally, it uses this model to generate detailed information, including the Spark Reference Inventory and Import Library Analysis. It also produces the converted code.

Durante esse processo, você verá três indicadores de progresso na tela:

  • Carregando o código-fonte

  • Analisando o código-fonte

  • Gravando resultados

Esses indicadores se acenderão à medida que cada etapa for concluída.

Página de execução

After the analysis is complete, the SMA automatically shows the Assessment Results page where you can see the analysis output.