Pular para o conteúdo principal
Última atualização em

Converter SQL com o Lakebridge Agentic Converter

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakebridge Agentic Converter na página Pré-visualizações . Consulte Gerenciar pré-visualizações do Databricks.

O Lakebridge Agentic Converter usa o Genie Code para converter SQL existente de dialetos como T-SQL, Snowflake, Redshift, Oracle, BigQuery e Teradata para ANSI SQL que executa no Databricks. O trabalho é organizado em um projeto de migração, onde o conversor analisa cada script de origem, valida a saída convertida e corrige erros iterativamente antes de gravar os resultados em uma pasta do Workspace.

Lakebridge é a ferramenta de migração com tecnologia de AI do Databricks para mover cargas de trabalho de data warehouses e ferramentas de ETL existentes para o Databricks. O Lakebridge Agentic Converter é seu componente de conversão de código.

Como funciona​

Você começa uma conversão criando um projeto de migração em seu workspace. O projeto rastreia o estado de cada arquivo e oferece um único lugar para gerenciar a migração.

Diagrama do fluxo de trabalho de conversão: arquivos de origem são adicionados a um projeto de migração, subagentes do Genie Code os convertem, e o SQL ANSI validado é gravado em uma pasta do workspace.

Ao executar uma conversão, o Genie Code invoca a habilidade Lakebridge e implanta subagentes que convertem arquivos simultaneamente. Cada subagente analisa o dialeto de origem, gera o equivalente ANSI SQL, valida o resultado e tenta novamente as seções que falham. Os arquivos convertidos são gravados diretamente na pasta do workspace que você especificar para o projeto.

Você também pode converter um único arquivo ou pasta sem um projeto usando o comando /migrate em uma conversa do Genie Code.

Requisitos​

  • Um Workspace habilitado para o Lakebridge Agentic Converter Beta. Um administrador do Workspace habilita o recurso na página **Pré-visualizações**. Consulte Gerenciar prévias do Databricks.
  • Seus arquivos SQL existentes devem estar acessíveis no seu workspace, seja upload como arquivos do workspace ou abertos no editor.
  • Seu workspace deve atender aos requisitos do Genie Code. See Genie Code.

Fontes compatíveis e limitações​

O conversor suporta os seguintes dialetos de origem:

  • T-SQL
  • Snowflake SQL
  • Redshift SQL
  • Oracle
  • BigQuery
  • Teradata

O conversor visa o ANSI SQL. Os seguintes limites se aplicam a cada conversão:

  • Um lote pode conter no máximo 300 arquivos.
  • Um script pode conter um máximo de 1.000 linhas.
  • Scripts BTEQ do Teradata ainda não são suportados.

Converter código SQL existente​

Os passos a seguir descrevem como converter SQL existente em um projeto de migração.

Etapa 1: upload arquivos de origem​

Carregue seus arquivos SQL existentes (.sql) usando o navegador de arquivos do Workspace, ou use a CLI do Databricks para fazer upload em massa de um diretório de scripts.

Passo 2: Criar um projeto de migração​

Crie um projeto de migração do seu Workspace:

  1. Clique em Novo ícone > Projeto de migração .
  2. Insira um **nome** para o projeto.
  3. Use os seletores suspensos para escolher um dialeto de origem e uma estrutura de destino .
  4. Insira o caminho do arquivo para a **pasta de destino**. Clique em **Navegar** para escolher um destino de uma lista de pastas de workspace disponíveis.
  5. (Opcional) Insira o caminho para um arquivo de linhagem que descreve a linhagem do projeto. Clique em Procurar para escolher o arquivo de uma lista de arquivos no seu Workspace.
  6. Clique em Criar .

Caixa de diálogo Novo projeto de migração mostrando os campos de nome do projeto, dialeto de origem, estrutura de destino e pasta de destino.

Etapa 3: Adicionar arquivos ao seu projeto​

No novo projeto:

  1. Clique em Adicionar arquivos > + Adicionar arquivos .
  2. Selecione a pasta de origem ou um arquivo do seu workspace.

O projeto lista cada arquivo com seu tipo de arquivo, contagem de linhas e status de conversão.

Tela do projeto de migração mostrando os arquivos de origem adicionados com seu tipo de arquivo, contagem de linhas e status de conversão.

Passo 4: Revisar a complexidade e a linhagem do código (opcional)​

Se você executou o Lakebridge Analyzer, faça o upload de sua saída JSON para o projeto para revisar a complexidade do código e a linhagem. Clique em um arquivo de origem para abrir uma avaliação de complexidade e clique em Linhagem para abrir um gráfico de dependências que mostra arquivos e tabelas interdependentes que você deve migrar juntos. Para obter instruções sobre como executar o Analyzer, consulte o guia do Lakebridge Analyzer.

Passo 5: Executar a conversão​

Selecione os arquivos a serem convertidos e clique em **Execução**. O Genie Code abre uma conversa, invoca a habilidade Lakebridge e implanta subagentes para converter os arquivos simultaneamente. Cada arquivo convertido aparece como um arquivo vinculado no projeto. O conversor marca cada arquivo com um status:

  • Verde : convertido com sucesso
  • **Amarelo**: Precisa de revisão
  • Vermelho : Conversão falhou
  • Cinza : Em andamento

O passo 6: revisar os resultados da conversão​

Clique em um arquivo convertido para abrir uma diferença lado a lado no editor SQL, com o código-fonte ao lado do Databricks SQL proposto. Aceite todas as alterações sugeridas ou revise e aceite edições individuais. Para scripts que falham ao converter, edite o código no editor ou peça ao Genie Code para revalidar ou repetir seções específicas. Após a satisfação, execute o SQL convertido em um notebook ou no editor SQL para confirmar que executa no Databricks.

Crie uma habilidade personalizada (opcional)​

Habilidades personalizadas permitem codificar regras de negócios que o Genie Code aplica automaticamente durante cada conversão. Use-os para lidar com tipos de dados proprietários, aplicar padrões de destino preferenciais ou capturar correções que você faz repetidamente. Uma habilidade de migração é uma habilidade do Genie Code, para que você possa criá-la e gerenciá-la da mesma forma que qualquer outra habilidade. Para mais detalhes, consulte Estender o Genie Code com habilidades de agente.

Você pode criar uma skill a partir das configurações do Genie Code ou de uma conversa do Genie Code. Use o caminho de configurações para skills complexas que incluem instruções detalhadas, exemplos ou arquivos de suporte. Use o caminho do chat para skills rápidas de regra única.

Crie a skill como um arquivo para que seja possível criar instruções detalhadas e controlar sua versão em uma pasta Git:

  1. No painel Genie Code, clique em Ícone de engrenagem. Configurações e, em seguida, clique em Seta em ícone. Abrir pasta de habilidades .

  2. Crie uma pasta para sua habilidade no caminho de habilidades do workspace, Workspace/.assistant/skills/. Por exemplo, Workspace/.assistant/skills/sql-migration/.

  3. Na pasta de habilidades, crie um arquivo SKILL.md com o frontmatter necessário e suas regras de conversão. Por exemplo:

    ---
    name: sql-migration
    description: Conversion rules to apply when migrating legacy SQL to ANSI SQL.
    ---

    Always convert the custom type MYDATE to TIMESTAMP_NTZ.

O Genie Code detecta a skill na próxima vez que você executar uma conversão.

As habilidades do workspace são armazenadas no nível do workspace e compartilhadas entre todos os usuários do workspace.

Dicas para testar​

Como parte de seu ciclo de agente, o conversor analisa cada script de origem, valida se a saída convertida é sintaticamente válida e semanticamente equivalente à origem e corrige iterativamente as seções que falham antes de escrever os resultados. As dicas a seguir ajudam a revisar e a obter confiança na saída:

  • Conversão em lote : Converta um pequeno lote de dois a cinco arquivos em uma sessão para verificar se a conversão de vários arquivos funciona de ponta a ponta.
  • Validação de sintaxe : Após a conversão, execute a saída em um editor Databricks SQL ou notebook para confirmar que ela é executada sem erros.
  • Casos extremos : Inclua um script com construtos específicos de dialeto, como funções de janela T-SQL, Snowflake QUALIFY ou Redshift LISTAGG, para ver como o conversor lida com padrões não triviais.
  • Correção semântica : Execute as queries original e convertida em relação a dados de teste equivalentes e compare os resultados. Confirme se a saída está semanticamente correta, não apenas sintaticamente válida.

Recursos adicionais​

Nesta página