SnowConvert AI - Assistente de migração – Introdução¶

1. Install the Snowflake Visual Studio Code extension¶

Consulte a documentação do Snowflake sobre como instalar a partir do Visual Studio Marketplace or from a .vsix file.

Certifique-se de que você esteja usando a versão GA****1.14.0 ou posterior.

2. Sign in to Snowflake with the Visual Studio Code extension¶

Consulte a documentação do Snowflake sobre como fazer login no Snowflake usando a extensão do VS Code.

3. Enable SnowConvert AI Migration Assistant in the Snowflake VS Code Extension Settings¶

Abra o painel de configurações do VS Code e navegue até Extensões. Selecione a extensão Snowflake e abra o painel de configurações para a extensão Snowflake.

Nas configurações da extensão Snowflake, você deve:

• Marcar “Enable SnowConvert AI Migration Assistant”

4. Set up Model Preference¶

Para obter mais informações sobre como configurar a preferência do modelo, consulte a documentação da Preferência de modelo.

5. Open a workspace folder containing SnowConvert AI migration results¶

Primeiro, certifique-se de ter uma pasta no workspace aberta no Visual Studio Code. Em seguida, acesse a extensão do Snowflake selecionando seu ícone na barra de atividades à esquerda. Um painel «SnowConvert AI Issues» aparecerá na parte inferior da exibição da extensão do Snowflake. Este painel é preenchido automaticamente com uma lista de todas as pastas e arquivos no workspace atual que têm problemas de migração do SnowConvert AI. Se nenhum workspace for selecionado, a seguinte mensagem será exibida no painel SnowConvert AI Issues: «No SnowConvert AI Migration issues found».

Depois que a pasta do workspace contendo os problemas de migração do SnowConvert AI é aberta, é possível acessar a barra de ferramentas passando o mouse sobre o painel «SnowConvert AI Issues». Esta barra de ferramentas no canto superior esquerdo do painel permite que você interaja com a lista de problemas de migração identificados.

• 🏠 (Return to Workspace Root): clicar neste ícone redefine a exibição para exibir todo o estado inicial da pasta do workspace.

• 📁 (Select Folder): permite que você navegue até uma subpasta específica no seu workspace para se concentrar na lista de problemas.

• 🔄 (Refresh Issues): use essa opção para atualizar a lista de problemas de migração do SnowConvert AI manualmente. A lista também será atualizada automaticamente sempre que um problema for resolvido ou um novo for detectado.

• ➖ (Collapse All): reúne todos os itens expandidos na lista de problemas para obter uma exibição mais compacta.

6 Consulte Problemas de migração doSnowConvert AI clique no ícone de brilho para ajuda na resolução¶

Depois de abrir uma pasta contendo arquivos .sql com problemas de migração, você verá uma lista de todos os EWIs, FDMse PRFs nessa pasta e nos arquivos que os contêm. Clicar em um problema de migração da lista fará com que o editor de código se concentre na linha de código em que o problema foi encontrado.

Há duas maneiras de obter assistência baseada emAI e soluções recomendadas para um problema de migração:

1. Clique no ícone de brilho localizado ao lado do problema de migração na lista..

2. Clique em CodeLenses identificado por _SnowConvert AI, que estão localizadas acima de cada problema de migração.

7 Obter ajuda¶

Depois de clicar no ícone de brilho ou nasCodeLenses, o Assistente de migração do SnowConvert AI consultará o Snowflake Cortex AI sobre o problema de migração e um trecho do contexto do código em torno do problema de migração. A chamada para o Cortex acontece inteiramente dentro da sua conta Snowflake, usando os detalhes de conexão que você configurou na extensão de código VS do Snowflake

Depois que um resultado for gerado, ele aparecerá em um painel à direita do editor de código. O resultado conterá uma explicação do problema de migração no contexto de seu código e uma correção sugerida para fazer o código ser executado corretamente no Snowflake. Se o assistente não for capaz de gerar uma resposta com alta confiança, ele se absterá de fornecer uma solução recomendada.

8 Interação com o assistente de migração¶

• Refinar soluções: se uma sugestão de AI estiver incorreta ou você preferir uma abordagem diferente, insira suas alterações ou instruções preferidas na caixa de bate-papo.

• Fazer perguntas relacionadas ao SQL: se a sugestão estiver correta, você ainda pode solicitar maiores informações ou explicações sobre qualquer tópico relacionado ao SQL.

• Modificações no código de solicitação: você também pode solicitar alterações específicas no código, como adicionar um cabeçalho ao seu script.