View a markdown version of this page

Relatórios de avaliação de conversão com o DMS Schema Conversion - AWS Database Migration Service
Executando uma avaliaçãoSalvar relatórios de avaliaçãoVisualizar o relatório de avaliação

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á.

Relatórios de avaliação de conversão com o DMS Schema Conversion

Uma parte importante da DMS Schema Conversion é o relatório que ele gera para ajudar você a converter seu esquema. Esse relatório de avaliação de conversão analisa os objetos do banco de dados em seu esquema de origem e identifica quais objetos o DMS Schema Conversion pode converter automaticamente e quais objetos requerem ação manual. Você pode visualizar o relatório no AWS DMS console ou salvar uma cópia como PDF ou arquivos de valores separados por vírgula (CSV).

O relatório de avaliação de conversão inclui o seguinte:

  • Um resumo executivo

  • Recomendações para converter objetos de banco de dados que exigem ação manual

Quando você tem objetos de banco de dados que o DMS Schema Conversion não pode converter automaticamente, o relatório fornece estimativas que mostram quanto esforço é necessário para escrever o código equivalente para sua instância de banco de dados de destino.

Tópicos

Executando uma avaliação para um relatório de avaliação de conversão com o DMS Schema Conversion

Depois de criar um projeto de migração, use um dos métodos a seguir para executar uma avaliação da complexidade da conversão.

AWS Management Console
Para executar uma avaliação e gerar um relatório de avaliação de conversão

  1. Faça login no Console de gerenciamento da AWS e abra o AWS DMS console em https://console.aws.amazon.com/dms/v2/.

  2. Escolha Projetos de migração. A página Projetos de migração é aberta.

  3. Escolha o projeto de migração e escolha Conversão de esquemas.

  4. Escolha Iniciar conversão de esquemas. A página Conversão de esquemas é aberta.

  5. No painel do banco de dados de origem, selecione o nó que você deseja avaliar. A ação Avaliar está disponível no nó Bancos de dados, em nós de banco de dados individuais e em nós do esquema, como dbo. Ele não está disponível em nós de objetos individuais, como tabelas ou procedimentos.

  6. Selecione pelo menos um nó principal no painel do banco de dados de origem. O menu Ações fica disponível somente quando um nó principal é selecionado.

  7. Abra o menu Ações e escolha Avaliar. Uma caixa de diálogo de confirmação é exibida.

  8. Escolha Avaliar na caixa de diálogo para confirmar a opção.

AWS CLI

O exemplo a seguir usa start-metadata-model-assessment para colocar em fila uma avaliação da complexidade de conversão de todos os objetos no esquema. ExampleSchema

aws dms start-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "source-server", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}'
nota

O --selection-rules parâmetro usa uma string JSON que especifica quais objetos de banco de dados devem ser incluídos na avaliação. Para ver a estrutura JSON completa das regras de seleção, consulteRegras de seleção na conversão do esquema DMS.

A resposta contém um RequestIdentifier que identifica a solicitação de avaliação.

{
    "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Como uma avaliação é executada de forma assíncrona, use aws dms wait metadata-model-assessment para bloquear até que a avaliação seja concluída antes de continuar.

aws dms wait metadata-model-assessed \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"

O comando pesquisa a cada 30 segundos e retorna quando a avaliação atinge um estado terminal. Ele sai com o código de retorno 255 se a avaliação não for concluída após 360 verificações (aproximadamente 3 horas).

Iniciar uma avaliação não gera um relatório totalmente novo do zero a cada vez. O relatório de avaliação de conversão reflete o estado atual do seu projeto de migração, portanto, inclui os itens de ação e os candidatos generativos de IA para tudo o que você avaliou ou converteu até o momento. Para obter mais informações, consulte Entendendo as métricas do relatório de avaliação de conversão.

Salvando seu relatório de avaliação de conversão para o DMS Schema Conversion

Depois de executar uma avaliação ou conversão, você pode salvar uma cópia do relatório de avaliação de conversão como arquivos PDF ou de valores separados por vírgula (CSV).

AWS Management Console
Relatório em PDF
Para salvar um relatório de avaliação de conversão como um arquivo PDF

  1. Escolha Exportar e PDF. Examine a caixa de diálogo e escolha Exportar para PDF.

  2. O DMS Schema Conversion armazena o arquivo PDF no bucket do Amazon S3 que você configurou nas configurações de acesso ao bucket do S3 em seu projeto de migração.

  3. Abra o arquivo do relatório de avaliação no bucket do Amazon S3.

Exportação de CSV
Para salvar um relatório de avaliação de conversão como arquivos CSV

  1. Escolha Exportar e CSV. Examine a caixa de diálogo e escolha Exportar para CSV.

  2. O DMS Schema Conversion armazena um arquivo ZIP contendo os arquivos CSV no bucket do Amazon S3 que você definiu nas configurações de acesso ao bucket do S3 em seu projeto de migração.

  3. Baixe e extraia o arquivo ZIP do seu bucket do Amazon S3 para acessar os arquivos CSV.

Nomes de bucket e arquivo do S3

O bucket do Amazon S3 em que o DMS Schema Conversion armazena relatórios exportados é o bucket que você especificou nas configurações de acesso ao bucket do S3 ao criar seu projeto de migração.

Os arquivos são armazenados em uma pasta que corresponde ao nome do seu projeto de migração. Ao exportar do Console de gerenciamento da AWS, os arquivos são nomeados usando o mecanismo de origem, o mecanismo de destino e um carimbo de data/hora UTC: project-name/SOURCE_ENGINE_TARGET_ENGINE_YYYY-MM-DDTHH-MM-SS.sssZ — por exemplo,. ora-pg-demo/ORACLE_POSTGRESQL_2026-07-01T09-00-47.846Z.pdf

O arquivo CSV contém pelo menos três arquivos organizados em um caminho de diretório de dois níveis. O diretório de nível superior é o nome do servidor de origem exatamente como configurado no provedor de dados de origem (nome do host ou endereço IP). Os nomes dos subdiretórios e arquivos usam o nome do host do banco de dados de destino:

  • source-server/target-host/target-host.csv— uma linha por ocorrência de item de ação.

  • source-server/target-host/target-host_Action_Items_Summary.csv— uma linha por tipo de item de ação, com valores de esforço.

  • source-server/target-host/target-host_Summary.csv— uma linha por tipo de objeto, com contagens de complexidade.

  • source-server/target-host/target-host_Stub_Objects.csv— uma linha por objeto stub gerado para um objeto embutido não suportado. Esse arquivo está presente somente quando a opção Converter objetos internos não suportados em objetos stub está habilitada nas configurações do seu projeto de migração.

AWS CLI

O exemplo a seguir usa export-metadata-model-assessment para exportar o relatório de avaliação de conversão de um projeto de migração como um arquivo PDF e um arquivo CSV para seu bucket do Amazon S3.

aws dms export-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1","rule-name":"1","rule-action":"explicit","object-locator":{"server-name":"source-server","schema-name":"ExampleSchema"}}]}' \
        --assessment-report-types pdf csv
nota

O --selection-rules parâmetro usa uma string JSON que especifica quais objetos de banco de dados devem ser incluídos no relatório. Para ver a estrutura JSON completa das regras de seleção, consulteRegras de seleção na conversão do esquema DMS.

A resposta contém a chave de objeto do Amazon S3 e o URL de download de cada arquivo de relatório.

Quando você não especifica--file-name, os arquivos são armazenados em uma pasta correspondente ao nome do seu projeto de migração, usando um carimbo de data/hora como nome do arquivo: project-name/YYYY-MM-DD-HH-MM-SS.pdf e project-name/YYYY-MM-DD-HH-MM-SS.zip — por exemplo,. sqlserver-pg-pma/2026-07-15-10-08-12.zip Especifique --file-name para substituir o prefixo do carimbo de data/hora dentro dessa pasta.

{
    "PdfReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.pdf",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.pdf"
    },
    "CsvReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.zip",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.zip"
    }
}
nota

O relatório de avaliação de conversão também está disponível após a execução de uma operação de conversão, não somente após a execução de uma avaliação explícita. Depois de uma conversão, o relatório reflete os objetos que ainda exigem ação manual e marca os objetos que o DMS Schema Conversion converteu usando IA generativa. Para obter informações sobre como executar uma conversão, consulteConvertendo seu esquema de banco de dados: guia passo a passo.

Visualizando seu relatório de avaliação de conversão para o DMS Schema Conversion

Para visualizar seu relatório de avaliação de conversão, use um dos métodos a seguir.

Importante

O relatório de avaliação de conversão abrange somente os objetos do banco de dados que foram incluídos no escopo da operação de avaliação ou conversão mais recente. Os objetos que não foram selecionados quando você executou o Assessment or Convert não aparecem no relatório, mesmo que existam no seu banco de dados de origem.

Cada nova operação de avaliação ou conversão substitui o relatório anterior. As guias Resumo e Itens de Ação sempre refletem somente a operação mais recente. Se você precisar manter os resultados do relatório atual, exporte-o como um arquivo PDF ou CSV antes de executar uma nova avaliação ou conversão. Para obter instruções de exportação, consulteSalvar relatórios de avaliação.

AWS Management Console

Depois de executar uma avaliação ou conversão, o DMS Schema Conversion adiciona informações nas seguintes guias:

  • Resumo

  • Itens de ação

Aba de resumo

A guia Resumo exibe as informações resumidas do relatório de avaliação de conversão. Ele mostra o número de objetos de banco de dados que o DMS Schema Conversion pode converter automaticamente em objetos de armazenamento de banco de dados e objetos de código de banco de dados.

A conversão de esquema do DMS converte muitos objetos de banco de dados automaticamente e identifica aqueles que exigem ação manual para concluir a conversão no mecanismo de banco de dados de destino. A guia Resumo fornece uma estimativa do esforço necessário para criar objetos de banco de dados em sua instância de banco de dados de destino que sejam equivalentes aos da sua origem.

Para ver o resumo da conversão de objetos de armazenamento de banco de dados, como tabelas, sequências, restrições, tipos de dados etc., escolha Objetos de armazenamento do banco de dados.

Para ver o resumo da conversão de objetos de código de banco de dados, como procedimentos, perfis, visualizações, acionadores etc., escolha Objetos de código do banco de dados.

Para alterar o escopo do relatório de avaliação, selecione o nó necessário na árvore do banco de dados de origem. A DMS Schema Conversion atualiza o resumo do relatório de avaliação para que corresponda ao escopo selecionado.

Guia Itens de ação

A guia Itens de ação contém uma lista de itens de ação para objetos de banco de dados que o DMS Schema Conversion não pode converter automaticamente em um formato compatível com o mecanismo de banco de dados de destino. Para cada item de ação, a DMS Schema Conversion fornece a descrição do problema e a ação recomendada. A DMS Schema Conversion agrupa itens de ação semelhantes e exibe o número de ocorrências.

Para visualizar o código do objeto do banco de dados relacionado, selecione um item de ação na lista.

IA generativa

A Conversão de Esquema do DMS com IA generativa simplifica o processo de migração de banco de dados, oferecendo recomendações para ajudar você a converter objetos de código não convertidos antes que normalmente exigem uma conversão manual complexa. Atualmente, esse recurso está disponível para Oracle, SQL Server, SAP ASE (Sybase ASE), IBM Db2 for LUW e IBM Db2 z/OS como bancos de dados de origem, convertendo para PostgreSQL ou Aurora PostgreSQL.

O relatório de avaliação mostra quais objetos de código de banco de dados são candidatos à conversão usando IA generativa. É possível exportar esse relatório para PDF para obter uma lista curta de cinco objetos por item de ação. Você pode exportar o relatório para um arquivo CSV para ver a lista completa de candidatos.

Quando você ativa o esquema Convert usando IA generativa e realiza uma conversão, o relatório de avaliação atualizado marca cada objeto de banco de dados com um item de ação correspondente — tanto objetos que foram convertidos com sucesso usando IA generativa quanto objetos que a IA generativa não conseguiu converter, facilitando a identificação e o acompanhamento dos resultados da conversão. AI-assisted

Para localizar rapidamente objetos que são convertidos pela IA generativa:

  1. Acesse a guia Itens de ação.

  2. No canto superior direito, localize o menu suspenso.

  3. Selecione Gerado pela IA nas opções.

Esse método de filtragem permite visualizar com eficiência todos os objetos do banco de dados convertidos com êxito usando esse recurso. Para obter mais informações sobre a conversão de objetos de banco de dados com IA generativa, consulte. Escopo da conversão baseada em IA generativa

PDF report

O relatório em PDF contém os quatro capítulos a seguir, nesta ordem:

  • Resumo executivo — Uma visão geral da complexidade da migração. Mostra o número de objetos de banco de dados que o DMS Schema Conversion pode converter automaticamente e o número que exigem ação manual, detalhados por tipo de objeto (tabelas, visualizações, procedimentos, gatilhos etc.) e por categoria de complexidade (convertidos automaticamente, ações simples, ações de média complexidade e ações complexas). Para obter mais informações sobre essas categorias, consulteCategorias de complexidade.

  • Objetos de banco de dados com ações de conversão — Um detalhamento de quais objetos de banco de dados específicos exigem ação manual, organizada por tipo de objeto. Cada entrada identifica o objeto pelo nome e lista o código do item de ação.

  • Candidatos à conversão com IA generativa — Os objetos de banco de dados que o DMS Schema Conversion identifica como candidatos para conversão automatizada usando IA generativa. O PDF lista até cinco objetos candidatos por tipo de item de ação. Para ver a lista completa de candidatos, exporte o relatório como CSV.

  • Recomendações detalhadas para migrações — Uma análise por objeto de cada objeto de banco de dados que requer ação manual. Para cada objeto, este capítulo mostra o código do item de ação (consulteCódigos de itens de ação), uma descrição da incompatibilidade específica com o mecanismo de banco de dados de destino e a ação de conversão manual recomendada. Diferentemente da guia Itens de ação no Console de gerenciamento da AWS, que agrupa itens de ação por tipo em todos os objetos, este capítulo lista cada objeto afetado individualmente.

Para exportar o relatório como PDF, consulteSalvar relatórios de avaliação.

CSV report

Quando você exporta seu relatório de avaliação para CSV, o DMS Schema Conversion cria um arquivo contendo pelo menos três arquivos CSV. O arquivamento usa uma estrutura de diretórios de dois níveis: o diretório de nível superior é o nome do servidor de origem exatamente como configurado em seu provedor de dados de origem (nome do host ou endereço IP), e os nomes dos subdiretórios e arquivos usam o nome do host do banco de dados de destino.

Arquivo de itens de ação (target-host.csv)

O arquivo CSV principal (sem sufixo) contém uma linha por ocorrência de item de ação. Ele contém as seguintes colunas:

  • Categoria — O tipo de objeto de banco de dados ao qual o item de ação se aplica, como procedure ouview-constraint.

  • Ocorrência — O caminho totalmente qualificado para a instância específica do objeto de banco de dados que o item de ação afeta, comoSchemas.schema_name.Procedures.procedure_name.

  • Item de ação — O código numérico do item de ação que identifica o tipo de problema de conversão. Para obter mais informações, consulte Códigos de itens de ação.

  • Assunto — O nome do objeto de banco de dados específico ou elemento de código ao qual o item de ação se refere, como um identificador não resolvido. Esse campo fica vazio quando o item de ação não faz referência a um nome de objeto específico.

  • Grupo — Uma descrição genérica do tipo de problema compartilhada por cada ocorrência desse código de item de ação. A conversão do esquema DMS usa esse valor para agrupar ocorrências relacionadas.

  • Descrição — Uma descrição detalhada da incompatibilidade específica dessa ocorrência.

  • Referências da documentação — Links para a documentação relevante para resolver a incompatibilidade.

  • Ação recomendada — A etapa de conversão manual sugerida para resolver a incompatibilidade.

  • Filtrado — Indica se o item de ação foi filtrado para fora da visualização do relatório.

  • Complexidade estimada — A categoria de complexidade atribuída a essa ocorrência: ações simples, ações de média complexidade ou ações complexas convertidas automaticamente.

  • Linha — O número da linha no código do objeto fonte em que a incompatibilidade ocorre.

  • Posição — A posição do caractere na linha em que a incompatibilidade ocorre.

  • Fonte — O mecanismo do banco de dados de origem.

  • Target — O mecanismo de banco de dados de destino.

  • Endereço IP e porta do servidor — O host e a porta do servidor do banco de dados de origem.

  • Nome do banco de dados — O nome do banco de dados de origem.

  • Nome do esquema — O nome do esquema de origem que contém o objeto afetado.

  • AI/ML Recomendação — A recomendação generativa de IA para converter esse objeto, quando a conversão generativa de IA foi ativada e produziu um resultado para essa ocorrência.

Arquivo de resumo dos itens de ação (target-host_ Action_Items_Summary .csv)

Contém uma linha por tipo de item de ação com as seguintes colunas:

  • Esquema — O nome do esquema de origem contendo os objetos afetados.

  • Item de ação — O código numérico do item de ação que identifica o tipo de problema de conversão. Para obter mais informações, consulte Códigos de itens de ação.

  • Número de ocorrências — O número total de objetos de banco de dados afetados por esse tipo de item de ação.

  • Esforços na curva de aprendizado — O esforço único necessário para criar uma abordagem de conversão para esse tipo de item de ação. Você incorre nesse custo uma vez por tipo de item de ação, independentemente do número de ocorrências. Os valores usam uma escala ponderada que varia de baixa (menor esforço) a alta (maior esforço).

  • Esforços para converter uma ocorrência — O esforço necessário para resolver cada ocorrência individual desse tipo de item de ação, seguindo a abordagem de conversão projetada. Os valores usam a mesma escala ponderada dos esforços da curva de aprendizado.

  • Descrição do item de ação — Uma descrição da incompatibilidade que esse tipo de item de ação representa.

  • Ação recomendada — A etapa de conversão manual sugerida para resolver esse tipo de item de ação.

Arquivo de resumo (target-host_Summary.csv)

Contém uma linha por tipo de objeto de banco de dados com as seguintes colunas:

  • Categoria — O tipo de objeto do banco de dados que a linha resumeTABLE, comoVIEW,PROCEDURE,TRIGGER,INDEX, CONSTRAINTSEQUENCE, ouFUNCTION. O arquivo também inclui linhas métricas agregadas com um Category valor deStorage_objects_count,Code_objects_count, ouSQL_syntax_elements_number. Para obter mais informações sobre esses valores agregados, consulteEstatísticas de conversão e métricas SQL.

  • Número de objetos — O número total de objetos de banco de dados desse tipo no escopo avaliado.

  • Objetos convertidos automaticamente — O número de objetos que o DMS Schema Conversion pode converter sem nenhuma ação manual.

  • Objetos com ações simples — O número de objetos que exigem um pequeno esforço manual para serem convertidos.

  • Objetos com ações de média complexidade — O número de objetos que exigem um esforço manual moderado para serem convertidos.

  • Objetos com ações complexas — O número de objetos que exigem um esforço manual significativo para serem convertidos.

  • Total de linhas de código — O número total de linhas de código-fonte em todos os objetos desse tipo.

Para exportar o relatório como CSV, consulteSalvar relatórios de avaliação.

Arquivo de objetos Stub (target-host_ Stub_Objects .csv)

Esse arquivo está presente somente quando a opção Converter objetos internos não suportados em objetos stub está habilitada nas configurações do seu projeto de migração. Ele contém uma linha por objeto stub gerado para um embutido não suportado, com as seguintes colunas:

  • Categoria — O tipo do objeto de esboço, comoscalar-function.

  • Nome do objeto stub — O nome totalmente qualificado do stub gerado, incluindo esquema e assinatura.

  • Número de ocorrências — O número de vezes que esse objeto stub é referenciado no código convertido.