View a markdown version of this page

Entendendo as métricas do relatório de avaliação de conversão - 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á.

Entendendo as métricas do relatório de avaliação de conversão

O relatório de avaliação de conversão analisa as incompatibilidades entre seus mecanismos de banco de dados de origem e de destino. Ele identifica quais objetos de banco de dados o DMS Schema Conversion pode converter automaticamente e quais objetos de banco de dados requerem ação manual para concluir a conversão em seu mecanismo de banco de dados de destino.

O relatório reflete o estado atual do seu projeto de migração. Depois de executar uma avaliação, o relatório mostra todos os itens de ação que o DMS Schema Conversion identificou e os objetos do banco de dados que são candidatos à conversão usando IA generativa. Depois de executar uma conversão, o relatório mostra os itens de ação que ainda exigem resolução manual e marca os objetos do banco de dados que o DMS Schema Conversion converteu usando IA generativa para que você possa verificar o código gerado.

A realização de uma avaliação é recomendada, mas é opcional. As mesmas estatísticas de conversão, itens de ação e categorias de complexidade que uma avaliação fornece também estão disponíveis após a execução de uma operação de conversão. Você não precisa executar uma avaliação antes de converter seu esquema.

Categorias de complexidade

O DMS Schema Conversion classifica cada objeto de banco de dados em uma das quatro categorias de complexidade, com base no esforço manual necessário para converter o objeto em seu mecanismo de banco de dados de destino. A guia Resumo e o arquivo CSV de resumo relatam o número de objetos de banco de dados em cada categoria, para cada tipo de objeto (como tabelas, visualizações, procedimentos, gatilhos, índices, restrições e sequências).

Categorias de complexidade
Categoria Description
Convertido automaticamente O DMS Schema Conversion converte o objeto do banco de dados em seu mecanismo de banco de dados de destino sem nenhuma ação manual. Esses objetos de banco de dados não têm itens de ação associados.
Ações simples O objeto do banco de dados tem um ou mais itens de ação que exigem ação manual, mas resolvê-los exige relativamente pouco esforço.
Medium-complexity ações O objeto de banco de dados tem um item de ação que exige um esforço manual moderado para ser resolvido, como reescrever parte da lógica do objeto para compatibilidade com o mecanismo de banco de dados de destino.
Ações complexas O objeto de banco de dados tem um item de ação que exige um esforço manual significativo para ser resolvido, como redesenhar a lógica do objeto para funcionar com seu mecanismo de banco de dados de destino.

A conversão do esquema DMS determina a categoria de um objeto de banco de dados a partir dos itens de ação que se aplicam a ele. Um objeto de banco de dados sem itens de ação é convertido automaticamente. Um objeto de banco de dados com um ou mais itens de ação é classificado pela maior complexidade entre esses itens de ação — por exemplo, um objeto de banco de dados com um item de ação simples e um item de ação de média complexidade é classificado como de média complexidade. Observe que um objeto de banco de dados com muitos itens de ação simples também pode ser classificado como complexo se a soma dos valores de esforço desses itens de ação simples exceder o limite de esforço de um item de ação complexo.

O arquivo CSV de resumo que você pode exportar do relatório (consulteSalvar relatórios de avaliação) relata essas categorias usando os seguintes cabeçalhos de coluna, com uma linha para cada tipo de objeto: CategoryNumber of objects,Objects automatically converted,Objects with simple actions, Objects with medium-complexity actionsObjects with complex actions, e. Total lines of code

Estimativas de esforço

Para cada item de ação, o relatório de avaliação de conversão fornece duas estimativas de esforço que, juntas, indicam quanto trabalho manual é necessário para converter os objetos de banco de dados afetados:

  • Esforço na curva de aprendizado — O custo único de criar uma abordagem de conversão para um determinado tipo de item de ação. Você incorre nesse esforço uma vez por tipo de item de ação, independentemente de quantos objetos de banco de dados sejam afetados por esse tipo de problema.

  • Esforço para converter uma ocorrência — O custo para converter cada ocorrência individual do item de ação, seguindo a abordagem de conversão que você projetou. Você incorre nesse esforço uma vez para cada objeto de banco de dados afetado pelo item de ação.

O DMS Schema Conversion relata os valores de esforço no arquivo Action_Items_Summary CSV, junto com o esquema, o item de ação, o número de ocorrências, a descrição do item de ação e a ação recomendada para cada tipo de item de ação. Para obter mais informações sobre esse arquivo, consulte Salvando seu relatório de avaliação de conversão para o DMS Schema Conversion.

Os valores de esforço usam uma escala ponderada que varia de baixa (menor esforço) a alta (maior esforço). Use esses valores, junto com o número de ocorrências, para estimar o esforço total necessário para resolver cada tipo de item de ação. Para obter mais informações sobre o cálculo do esforço total, consulteUsando o relatório de avaliação de conversão para o planejamento da migração.

Códigos de itens de ação

Cada item de ação em seu relatório de avaliação de conversão tem um código de item de ação — um identificador numérico que categoriza o tipo específico de problema de conversão. O DMS Schema Conversion atribui o mesmo código a todas as ocorrências do mesmo tipo de problema, para que você possa usar o código para agrupar e rastrear itens de ação relacionados em seus objetos de banco de dados.

A tabela a seguir mostra três códigos de itens de ação de um exemplo de relatório de avaliação de conversão, ilustrando como os códigos abrangem diferentes níveis de complexidade.

Exemplos de códigos de itens de ação
Código Description Complexidade Ação recomendada
5075 O PostgreSQL não suporta a cláusula WITH READ ONLY para visualizações Ações simples Revise seu código para usar visualizações sem a cláusula de restrição de subconsulta.
5201 O PostgreSQL não suporta esse tipo de partição Medium-complexity ações Converta seu código-fonte manualmente.
5340 O DMS SC não pode converter funções Ações complexas Revise seu código para usar outra função ou criar uma função definida pelo usuário.

Os códigos dos itens de ação não seguem um esquema de numeração que corresponda a uma categoria de complexidade específica ou a um tipo de objeto de banco de dados. Para encontrar a categoria de complexidade, as estimativas de esforço e a ação recomendada para um código específico, consulte o arquivo Action_Items_Summary CSV ou a guia Itens de ação no AWS DMS console.

Estatísticas de conversão e métricas SQL

Além de relatar categorias de complexidade para cada tipo de objeto, a guia Resumo e o arquivo CSV de resumo (consulteSalvar relatórios de avaliação) relatam as seguintes estatísticas agregadas para todo o esquema de origem:

  • Contagem de objetos de armazenamento — O número total de objetos de armazenamento de banco de dados em seu esquema, como tabelas, índices, restrições e sequências, e quantos deles foram convertidos automaticamente pelo DMS Schema Conversion.

  • Contagem de objetos de código — O número total de objetos de código do banco de dados em seu esquema, como procedimentos, funções, visualizações e gatilhos, e quantos deles foram convertidos automaticamente.

  • Total de linhas de código — O número de linhas de código-fonte nos objetos do banco de dados de cada tipo de objeto. O DMS Schema Conversion relata esse valor por tipo de objeto no arquivo CSV de resumo, para que você possa avaliar o tamanho relativo de cada tipo de objeto em seu esquema.

  • Número de elementos de sintaxe SQL — O número total de construções de sintaxe SQL que o DMS Schema Conversion analisou em todos os seus objetos de banco de dados e quantas dessas construções ele converteu automaticamente. Um único objeto de banco de dados pode conter muitos elementos de sintaxe SQL, portanto, esse valor geralmente é muito maior do que a contagem de objetos de armazenamento e código. Use-o como uma medida mais granular da cobertura de conversão em todo o seu esquema.

O arquivo CSV de resumo relata a contagem de objetos de armazenamento, a contagem de objetos de código e o número de elementos da sintaxe SQL como suas próprias linhas, ao lado de uma linha para cada tipo de objeto de banco de dados em seu esquema. Por exemplo, um relatório pode mostrar um Storage_objects_count de 747, com 663 objetos automaticamente convertidos; um Code_objects_count de 253, com 213 objetos convertidos automaticamente; e um SQL_syntax_elements_number de 178091, com 176745 elementos convertidos automaticamente. Os números específicos em seu relatório dependem do tamanho e da complexidade do seu esquema de origem.

Para cada tipo de objeto — como tabelas, visualizações, procedimentos, acionadores, índices, restrições e sequências — o resumo relata o número de objetos desse tipo e como esses objetos são distribuídos nas quatro categorias de complexidade: convertidos automaticamente, ações simples, ações de média complexidade e ações complexas. Por exemplo, um relatório pode mostrar 474 tabelas no total, com 379 convertidas automaticamente, 29 com ações simples, 6 com ações de média complexidade e 60 com ações complexas. A comparação da distribuição entre os tipos de objetos pode ajudar você a identificar quais tipos de objetos em seu esquema precisam do maior esforço de conversão manual. Para obter mais informações sobre as categorias de complexidade, consulteCategorias de complexidade.

Para usar essas estatísticas para estimar o escopo geral de sua migração, consulteUsando o relatório de avaliação de conversão para o planejamento da migração.