View a markdown version of this page

Usando agentes de IA com conversão de esquema DMS - AWS Database Migration Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando agentes de IA com conversão de esquema DMS

Você pode usar agentes de IA para impulsionar fluxos de trabalho de conversão de esquema do DMS por meio da API. AWS Um agente de IA é uma ferramenta de software que usa grandes modelos de linguagem para entender instruções em linguagem natural e automatizar tarefas. Quando conectado ao servidor AWS MCP, um agente de IA pode criar projetos de migração, navegar na árvore de metadados do banco de dados de origem, converter esquemas, gerar relatórios de avaliação, exportar resultados e explicar vários aspectos do serviço. Você controla essas operações por meio de instruções em linguagem natural.

Para melhorar a precisão e a eficiência do agente com o DMS Schema Conversion, você pode instalar a habilidade AWS DMS Schema Conversion. A habilidade fornece o Conversion-specific contexto do esquema DMS, incluindo padrões de API, exclusões do esquema do sistema, sequenciamento de operações e melhores práticas de serviço.

Importante

A habilidade contém instruções que evitam erros comuns que os agentes de IA cometem ao usar a conversão de esquema do DMS e reduzem os ciclos de tentativa e erro, o que ajuda a diminuir o uso de tokens e aumentar a velocidade de atingir a meta desejada. É altamente recomendável instalá-lo antes de começar.

Este tópico mostra como instalar a habilidade e fornece exemplos de fluxos de trabalho comuns de conversão de esquema do DMS que você pode executar por meio de um agente de IA.

Pré-requisitos

Antes de começar, verifique se você atendeu aos pré-requisitos a seguir. Este guia pressupõe familiaridade AWS DMS e interfaces de linha de comando.

nota

Se você já tiver um projeto de migração configurado no DMS Schema Conversion, o agente poderá trabalhar com ele imediatamente. Caso contrário, o agente poderá criar um para você. Para obter mais informações, consulte Trabalhando com provedores de dados, perfis de instância e projetos de migração no AWS DMS.

Instalar o   AWS DMS Habilidade de conversão de esquema

Uma habilidade é um pacote organizado de instruções e materiais de referência que ajuda seu agente de IA a concluir as tarefas de conversão do esquema DMS de forma eficaz. A habilidade de conversão de AWS DMS esquema contém padrões de API, exclusões de esquemas do sistema, regras de sequenciamento de operações e melhores práticas de serviço. Com essa habilidade, o agente comete menos erros e exige menos idas e vindas para concluir as operações de conversão de esquema do DMS.

Escolha um dos métodos a seguir para instalar a habilidade.

AWS MCP server

Se seu agente estiver conectado ao servidor AWS MCP, o agente poderá localizar e carregar a habilidade automaticamente por meio do servidor MCP. Antes de continuar, verifique se os servidores MCP estão carregados e conectados. Na maioria dos agentes de IA, você pode verificar o status do servidor MCP /mcp inserindo. Em seguida, pergunte ao seu agente:

Load "dms-schema-conversion" skill using the `retrieve_skill` tool.

O agente recupera a habilidade do servidor AWS MCP e a aplica à sessão atual.

npx skills CLI

Se seu agente não usa o servidor AWS MCP, você pode instalar a habilidade localmente a partir do AWS Agent Toolkit for AWS repository on. GitHub Execute o seguinte comando no diretório do seu projeto:

npx skills add aws/agent-toolkit-for-aws/skills/specialized-skills/migration-and-modernization-skills/dms-schema-conversion
nota

Se você usar uma definição de agente personalizada em sua ferramenta de codificação de IA, certifique-se de que a configuração do agente inclua um diretório de habilidades. Caso contrário, o agente não poderá descobrir e carregar a habilidade.

Manual installation

Clone o kit de ferramentas do AWS agente para AWS repositório e copie o diretório de habilidades para o local de habilidades do seu agente. A tabela a seguir mostra a trajetória de habilidades dos agentes compatíveis.

Agente Caminho de habilidades do projeto Caminho global de habilidades
Kiro CLI .kiro/skills/ ~/.kiro/skills/
Claude Code .claude/skills/ ~/.claude/skills/
Cursor .cursor/skills/ ~/.cursor/skills/
Codex .agents/skills/ ~/.codex/skills/
nota

Se você usar uma definição de agente personalizada em sua ferramenta de codificação de IA, certifique-se de que a configuração do agente inclua um diretório de habilidades. Caso contrário, o agente não poderá descobrir e carregar a habilidade.

Direct URL

Você pode carregar a habilidade diretamente do GitHub URL sem instalar nada localmente. Pergunte ao seu agente:

Load skill from https://github.com/aws/agent-toolkit-for-aws/blob/main/skills/specialized-skills/migration-and-modernization-skills/dms-schema-conversion/SKILL.md

O agente busca o conteúdo da habilidade GitHub e o aplica à sessão atual.

Depois que a habilidade for carregada com sucesso, você verá um menu de ação com as ações de conversão de esquema disponíveis.

Práticas recomendadas

Siga essas recomendações para obter os melhores resultados ao usar agentes de IA com a conversão de esquema do DMS.

  • Navegar antes de converter — Use o agente para explorar a árvore de metadados antes de começar a converter esquemas. Isso ajuda você a entender o escopo da migração e identificar quais esquemas converter.

  • Converta um esquema por vez — Para bancos de dados grandes, converta esquemas individualmente em vez de todos de uma vez. Isso facilita a revisão incremental do código convertido e dos itens de ação de endereço.

  • Ignore esquemas do sistema — Não converta bancos de dados ou esquemas do sistema. Eles contêm objetos internos do motor que produzem um grande número de itens de ação inconversíveis.

  • Revise o SQL convertido antes de aplicar — Exporte o código convertido como scripts SQL e revise-o antes de aplicá-lo ao banco de dados de destino, especialmente para objetos de código.

  • Ativar AI-assisted conversão generativa — Ative a AI-assisted conversão generativa para melhorar a taxa de conversão de objetos de código. A AI-assisted conversão generativa usa aprendizado de máquina para converter objetos que o conversor baseado em regras não consegue manipular automaticamente. Para obter mais informações, consulte Converter objetos de banco de dados com IA generativa.

  • Use o relatório de avaliação — após a conversão ou avaliação, gere um relatório de avaliação para obter um resumo dos resultados da conversão e do trabalho manual restante. Para obter mais informações, consulte Criar relatórios de avaliação de migração de banco de dados com a DMS Schema Conversion.

Exemplos

Os exemplos a seguir mostram fluxos de trabalho comuns de conversão de esquema do DMS que você pode executar por meio de um agente de IA após carregar a habilidade.

Neste exemplo, você usa um agente de IA para criar um projeto de migração para converter um banco de dados Microsoft SQL Server no Amazon Aurora PostgreSQL. O agente cria os AWS DMS recursos necessários e os vincula.

O prompt a seguir instrui o agente a criar um projeto de migração:

I want to migrate my SQL Server database to Aurora PostgreSQL using DMS Schema Conversion. The source database is on an EC2 instance at 10.0.1.50, port 1433, database name "AdventureWorks". The credentials are stored in Secrets Manager under "mydb-source-credentials". Create a migration project for me.

O agente cria um provedor de dados de origem, um provedor de dados de destino, um perfil de instância e o projeto de migração que os une. Se você ainda não tem um banco de dados de destino, o agente cria um provedor de dados de destino virtual para que você possa converter e exportar esquemas como scripts SQL. O agente também cria as funções do IAM e os buckets do S3 necessários e verifica a configuração da rede.

Depois que o agente cria o projeto de migração, você pode pesquisar os metadados do banco de dados de origem, avaliar ou converter esquemas e exportar resultados.

Você pode usar o agente para explorar sua estrutura de banco de dados de origem. O agente navega na árvore de metadados hierarquicamente, listando bancos de dados, esquemas, tabelas, procedimentos armazenados e outros objetos.

Show me the databases and schemas in my source database.

O agente importa os metadados de origem, caso ainda não tenham sido importados, e navega pela árvore de metadados usando a API. AWS DMS Você pode se aprofundar em esquemas específicos:

Show me the stored procedures in the AdventureWorks.dbo schema.

Depois de navegar pela árvore de metadados, você pode usar o agente para avaliar ou converter esquemas e exportar os resultados.

Convert the AdventureWorks.dbo schema to Aurora PostgreSQL and export the converted SQL scripts.

O agente converte os objetos do esquema e exporta os scripts SQL convertidos para o bucket do S3. Cada operação de conversão e exportação é executada de forma assíncrona, e o agente consulta a conclusão antes de iniciar a próxima operação. Após a conversão, o agente gera um relatório de avaliação.

O relatório de avaliação inclui um resumo dos objetos convertidos, itens de ação para objetos que exigem alterações manuais e estimativas de esforço. Você também pode pedir ao agente que explique o significado de itens de ação específicos e forneça orientação sobre como resolvê-los.

Algumas operações de conversão de esquema do DMS, como conversão de esquema, importação de metadados e avaliação, são executadas de forma assíncrona e podem levar tempo. Enquanto o agente faz pesquisas para conclusão, talvez você queira fazer perguntas, obter esclarecimentos ou dar instruções adicionais sem interromper o fluxo de trabalho.

As abordagens a seguir permitem que você interaja com o agente durante uma operação de longa duração. Escolha um método com base nas capacidades do seu agente.

Ctrl+C

Essa abordagem funciona na maioria dos agentes de IA, incluindo Kiro CLI, Claude Code e Cursor.

Pressione Ctrl+C para interromper o agente enquanto ele pesquisa o progresso. Você pode então fazer sua pergunta ou dar uma nova instrução. O agente pausa a operação atual, mas não cancela a operação no lado do servidor — ela continua em AWS DMS execução.

Depois que o agente responder à sua pergunta, você poderá solicitar que ele retome a verificação do status da operação.

Check if the conversion is done now.
Separate session

Essa abordagem funciona com qualquer agente de IA.

Abra uma nova guia do terminal e inicie uma sessão de agente separada. Use uma sessão para executar a operação e a pesquisa para conclusão, e a outra sessão para fazer perguntas ou realizar outro trabalho. Ambas as sessões podem acessar os mesmos servidores e AWS recursos MCP.

Instructing the agent not to poll

Essa abordagem funciona com qualquer agente de IA.

Em vez de esperar a conclusão de uma operação, instrua o agente a iniciar a operação e retornar imediatamente. Você pode então fazer perguntas, fazer outros trabalhos e verificar o status quando estiver pronto.

Exemplo de solicitação:

Start converting the AdventureWorks.dbo schema but don't wait for it to finish. I'll ask you to check the status later.

Então, mais tarde:

Check if the dbo schema conversion is complete.
/btw command

Essa abordagem está disponível no Claude Code e em outros agentes que oferecem suporte a mensagens em segundo plano.

Digite /btw seguido de sua pergunta para enviar uma mensagem paralela sem interromper a tarefa atual do agente. O agente processa sua pergunta em segundo plano enquanto continua a pesquisa para conclusão.

Exemplo:

/btw What action items typically appear for stored procedures?
Subagents

Essa abordagem está disponível em agentes que oferecem suporte a subagentes em segundo plano, como Claude Code.

Instrua o agente a executar a operação em um subagente em segundo plano. O subagente faz pesquisas para serem concluídas enquanto sua sessão principal permanece livre para perguntas e outros trabalhos.

Exemplo de solicitação:

Run the AdventureWorks.dbo schema conversion in a background subagent and let me know when it's done.