Snowpark Migration Accelerator: Guia de instalação do Interactive Assessment Application

Esta seção orienta você na implantação do Interactive Assessment Application (IAA) em sua conta Snowflake. O IAA é um aplicativo Streamlit que aproveita o poder do Snowflake dentro do próprio Snowflake para analisar os dados de saída do Snowpark Migration Accelerator (SMA). Este documento fornece as etapas e os recursos necessários para analisar sua carga de trabalho em seu ambiente Snowflake usando o IAA.

Guia passo a passo

Antes de implantar o IAA, certifique-se de ter os seguintes pré-requisitos:

  • Você executou o SMA e tem os dados de saída prontos para análise.

  • Você tem uma conta Snowflake. (Isso é necessário para hospedar e executar o IAA.) Caso contrário, uma conta de avaliação do Snowflake funcionará.

  • Você precisa ter o VSCode ou o Jupyter instalado para executar o notebook: VSCode ou Jupyter.

  • Certifique-se de ter o Python 3.11 ou posterior instalado. Essa versão é necessária para compatibilidade com o notebook do IAA.

O carregamento de toda a tabela de mapeamentos pode demorar mais do que selecionar apenas a versão mais recente. Recomendamos carregar a versão mais recente caso não tenha interesse em comparar sua execução com versões anteriores.

No VS Code, você pode selecionar a pasta Map, que contém todas as pastas com as versões de APIs e EWIs, e excluir aquelas que não deseja enviar. Nesse caso, você pode deixar apenas a versão 7.1.2.

Mapeamentos disponíveis para upload

Após verificar os pré-requisitos, prossiga para a implantação.

Vamos implantar o IAA!

Nota

Este guia passo a passo se aplica ao VS Code

Repositório

  1. Acesse o GitHub de código aberto do Snowflake Labs: https://github.com/Snowflake-Labs/IAA-Support.

  2. Clique no botão «Code» e copie o método de clonagem de sua preferência (por exemplo, HTTPS ou SSH).

  3. Escolha o diretório onde deseja salvar o repositório em sua máquina local, se aplicável.

Execução do notebook no VS Code

Nota

Nota: este processo de implantação usa a CLI do Snowflake.

  1. Abra o repositório baixado no ambiente VSCode.

  2. No VS Code, clique em Yes, I trust the authors

Arquivo iaa_config.toml

Parte 1: Obtenção de credenciais em «Connect a tool to Snowflake»

  1. Na sua conta Snowflake, clique nas suas iniciais no canto inferior esquerdo.

  2. Selecione «Connect a tool to Snowflake».

  3. Abra o arquivo iaa\_config.toml.

  4. Copie as seguintes informações da janela «Connect a tool to Snowflake» e cole-as no arquivo `iaa_config.toml`:

    1. Identificador da conta

    2. Nome de usuário

Parte 2: Fornecimento de detalhes adicionais

No arquivo `iaa_config.toml`, forneça também as seguintes informações:

  1. Senha: digite sua senha do Snowflake.

  2. Nome do banco de dados: insira o nome do banco de dados que você deseja usar para o IAA.

  3. Nome do esquema: insira o nome do esquema que você deseja usar para o IAA.

  4. Nome do warehouse: insira o nome do warehouse em execução na sua conta Snowflake.

Salve as alterações no arquivo `iaa_config.toml`.

Aviso

Aviso: a célula que valida as entradas de conexão poderá falhar se as informações do arquivo .toml estiverem incorretas. Nesse caso, verifique as informações de entrada.

Kernel

Para executar o arquivo .ipynb, você precisa instalar as extensões Python e Jupyter no VS Code.

  1. Selecione o ambiente Python compatível com a versão necessária para executar o notebook. (3.11 ou posterior).

Execução do notebook

Para implantar o aplicativo na sua conta Snowflake, selecione «Run all» nas células.

Essas células configuram automaticamente o ambiente local e estabelecem a conexão com a sua conta Snowflake para preparar a implantação do aplicativo Streamlit. Especificamente, essas células vão:

  1. Verificar o requisito do Python 3.11

  2. Verificar o requisito da CLI do Snowflake

  3. Executar o arquivo iaa_config.toml para conectar com a configuração da conta Snowflake:

    1. Ler o arquivo .toml local

    2. Validar as entradas de conexão

    3. Estabelecer uma conexão com o Snowflake

  4. Preparar o ambiente para implantar o aplicativo Streamlit no Snowflake

    1. Configurar o ambiente local

    2. Recuperar as entradas de conexão

  5. Implantar o aplicativo Streamlit no Snowflake usando a CLI do Snowflake:

    1. Implantar o esquema do aplicativo no SiS.

    2. Implantar a área de preparação de mapas no SiS.

    3. Implantar o APP no SiS.

    4. Atualizar a implantação.

    5. Recuperar as informações do aplicativo e fornecer um botão de acesso.

    \ É isso! É hora de enviar sua saída.

É hora de enviar sua saída do SMA!

Localize o arquivo zip de saída do SMA, nomeado no formato ‘AssessmentFiles_*.zip’, na pasta de saída.

  1. Acesse sua conta Snowflake

Data > Databases > [Your IAA Database] > Stages > SMA_EXECUTIONS
Copy

Área de preparação SMA_EXECUTIONS em sua conta Snowflake.

  1. Carregue seu arquivo AssessmentFiles.zip.

Carregamento da saída do SMA para a área de preparação SMA_EXECUTIONS

  1. Abra o IAA para explorar as informações de execução. Esta etapa pode levar cerca de 30 segundos.

IAA

  1. Após você abrir o IAA, a página inicial terá esta aparência:

Página de destino do IAA

Agora você pode explorar sua execução usando o IAA.

Exploração do IAA

O Interactive Assessment Application (IAA) agora está instalado em sua conta Snowflake. Você carregou com sucesso suas execuções de saída do SMA e está tudo pronto para explorar a compatibilidade do seu código Spark com o Snowpark.

Nota

Lembre-se de como acessar o IAA em sua conta Snowflake:

Projects > Streamlit > Interactive Assessment Application

O IAA permitirá que você identifique quais partes do seu código são diretamente compatíveis e quais exigem intervenção manual ou otimização adicional. Recomenda-se usar a versão mais recente do SMA. No entanto, se você tiver execuções mais antigas, o IAA as comparará com as versões de mapeamento mais recentes da API.

Linguagem: Português