Avaliação de migração de banco de dados para extensão Oracle

Nota

Esta prorrogação será aposentada em 15 de dezembro de 2024. Deixaremos de suportar esta ferramenta para quaisquer problemas que surjam e não emitiremos quaisquer correções de bugs ou atualizações adicionais.

A extensão Avaliação de Migração de Banco de Dados para Oracle no Azure Data Studio ajuda você a avaliar uma carga de trabalho Oracle para migrar para o SQL do Azure e o Banco de Dados do Azure para PostgreSQL. A extensão identifica um destino SQL ou PostgreSQL do Azure apropriado com recomendações de dimensionamento correto e quão complexa pode ser a migração.

Pré-requisitos

Instalar a extensão Azure Data Studio

Siga estas etapas para instalar a extensão Avaliação de Migração de Banco de Dados para Oracle no Azure Data Studio.

  1. Abra o gerenciador de extensões no Azure Data Studio. Você pode selecionar o ícone de extensões ou selecionar Extensões no menu Exibir.

  2. Digite Oracle na barra de pesquisa.

  3. Selecione a extensão Database Migration Assessment for Oracle e veja seus detalhes.

  4. Selecione Instalar.

    Screenshot da instalação da extensão.

Definir configurações de extensão

Você pode definir várias configurações de extensão depois de instalar a extensão.

  1. Vá para extensões e selecione Database Migration Assessment for Oracle, selecione o ícone gerenciar configurações e, em seguida, selecione configurações de extensão.

    Screenshot da extensão.

  2. Em Configurações de extensão, edite todas as configurações de extensão para atender aos requisitos do ambiente.

    Captura de ecrã das definições das propriedades da extensão.

    Nota

    Para executar a avaliação de código Oracle para PostgreSQL, o caminho inicial do cliente Oracle e o caminho de instalação do Ora2Pg são parâmetros obrigatórios.

Executar avaliação

Depois que a extensão de avaliação for instalada, a próxima etapa será conectar ao Oracle seu banco de dados, coletar informações de metadados de sua instância Oracle e gerar um relatório de avaliação.

  1. Vá para o ícone de conexões na barra de menus.

    Captura de ecrã da barra de menus de ligações.

  2. Nos Detalhes da Conexão, preencha os campos.

    1. No campo Tipo de conexão, selecione Oracle.
    2. No campo Fonte de dados, digite o nome e a instância do servidor Oracle.
      1. Você também pode fornecer o nome TNS. (Verifique se a variável de ORACLE_HOME ambiente está definida e se o TNSNAMES.ORA arquivo está localizado no <ORACLE_HOME>/network/admin folder.)
      2. Para o banco de dados de contêiner, você pode conectar o banco de dados raiz do contêiner usando a ID de serviço CDB ou usar o nome do serviço de banco de dados conectável para se conectar ao banco de dados conectável.
    3. Forneça o nome de usuário do banco de dados no campo ID do usuário.
    4. Forneça a senha do banco de dados no campo Senha .

    Captura de ecrã dos detalhes da ligação.

  3. Selecione Ligar.

  4. Agora, uma nova conexão aparece no menu de detalhes da conexão.

  5. Clique com o botão direito do mouse na conexão Oracle e selecione Gerenciar.

    Captura de tela mostrando a tela Gerenciar banco de dados.

  6. Selecione Avaliação de migração.

    Captura de tela mostrando a tela do banco de dados Avaliação de Migração.

  7. Selecione Executar nova avaliação.

    Captura de tela mostrando a tela Executar nova avaliação.

  8. Forneça os detalhes da sua avaliação.

    1. No campo Nome da avaliação , insira um título, por exemplo, demo1.
    2. Insira a configuração de Avaliação.
      1. Insira o banco de dados de migração de destino no campo Plataforma de destino. Atualmente, ele oferece suporte ao Azure SQL e ao PostgreSQL como destinos.

        Nota

        O destino do PostgreSQL está em visualização. Esta opção-alvo será descontinuada. Você deve exportar todas as avaliações prévias.

      2. Na seção Coleta de dados de desempenho, selecione Executar coleta de dados de desempenho no banco de dados Oracle (conectado) ou Adicionar relatório AWR.

        A recomendação é usar a opção conectada se você estiver executando essa ferramenta durante um pico ou carga realista. Caso contrário, forneça os relatórios AWR gerados no passado para recomendações de desempenho e dimensionamento.

        Nota

        A opção de avaliação de relatório AWR não está habilitada para banco de dados conectável.

      3. Insira o valor do multiplicador no campo Fator de escala.

        • Se o SKU recomendado precisar considerar outras cargas de pico, o multiplicador do fator de escala deve ser maior que 1. Por exemplo, Burst Load, Uso sazonal e planejamento de capacidade futura. Quando uma carga de trabalho parcial do esquema Oracle é migrada, o multiplicador deve ser menor que 1.
      4. No campo Utilização de percentil, insira o valor de percentil para dimensionar o destino do Azure.

        • O valor percentil do conjunto de amostra de desempenho a ser considerado para dimensionar o destino do Azure.

    Captura de tela mostrando a tela de detalhes da avaliação.

  9. Existem dois tipos de avaliação:

    • Avaliação da carga de trabalho. Nesta avaliação, o módulo de avaliação Oracle executa uma descoberta leve dos objetos de esquema e categoriza a complexidade do esquema para migração para várias categorias com uma estimativa de alto nível para horas de conversão. Esta pré-avaliação ajuda a encontrar a viabilidade da migração para a plataforma de destino.

    • Avaliação de Código. A avaliação de código executa uma avaliação aprofundada dos objetos do esquema Oracle e, em seguida, sugere uma prontidão geral dos objetos de código com os tipos de objeto "ready", "need review" e "not ready" em um nível granular e suas horas de conversão associadas com maior precisão.

      Nota

      A extensão usa o conversor de esquema Ora2Pg de código aberto para avaliações de código.

      Se o cliente Oracle e/ou o Ora2Pg não estiver instalado na mesma máquina que o Azure Data Studio, instale-os manualmente ou use o script de instalação do Ora2Pg do GitHub.

      Se o cliente Oracle e o Ora2Pg estiverem instalados, verifique se o caminho inicial do cliente Oracle e o caminho de instalação do Ora2Pg estão atualizados nas configurações da extensão.

      • Ao selecionar Avaliação de código para cenários SQL, selecione os esquemas que você gostaria de acessar para conversão e migração Oracle para SQL. Por padrão, todos os esquemas elegíveis são selecionados para a avaliação.
  10. Escolha Executar validação para executar os pré-requisitos e várias regras de validação relacionadas a permissões de segurança, definições de configuração, etc. Se a validação falhar, então você precisa corrigir os erros para prosseguir.

  11. Quando a Validação for bem-sucedida, você poderá selecionar Executar avaliação.

  12. Agora, você vê a nova avaliação na seção "Últimas cinco avaliações".

    Captura de tela mostrando a opção para nomear a avaliação.

  13. Selecione o link da avaliação para visualizar a página de detalhes da avaliação. Você pode visualizar o status da avaliação mais recente.

    Captura de ecrã a mostrar o estado da avaliação mais recente.

  14. Selecione Atualizar ou aguarde até que a avaliação seja concluída. Por padrão, a página de status da avaliação é atualizada a cada 15 segundos. O status mostra um dos quatro status: bem-sucedido, reprovado, em andamento ou cancelado.

Ver a avaliação

Quando a avaliação estiver concluída, uma saída consolidada usando cartões será gerada para cada destino SQL do Azure: SQL Server em Máquinas Virtuais do Azure, Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure ou Banco de Dados do Azure para PostgreSQL - Servidor flexível.

Captura de ecrã da opção de avaliação da vista.

Cada cartão tem várias secções. O cartão mostra a viabilidade geral da migração para o destino. Você pode detalhar várias cargas de trabalho em várias categorias de complexidade de migração:

  • A seção de compatibilidade de recursos fornece o resultado da revisão da avaliação de recursos.
  • A recomendação de SKU fornece o dimensionamento adequado do alvo.
  • A avaliação de código fornece a complexidade de código de objetos de banco de dados.

Quando você seleciona Exibir detalhes do relatório, ele mostra primeiro o resumo da avaliação.

Captura de ecrã a mostrar o resumo da avaliação.

Se o destino selecionado for Banco de Dados para Azure PostgreSQL, a guia Detalhes do banco de dados ou a guia Avaliação de código estará visível com base na seleção do tipo de avaliação.

A guia Detalhes do banco de dados a seguir fornece o detalhamento por esquema. Ele mostra a lista de esquemas descobertos, a viabilidade da migração e o tempo estimado para converter o esquema em horas.

Captura de tela mostrando o detalhamento por base de esquema.

Essa estimativa é baseada em um modelo estatístico que se aplica à contagem de objetos, linhas de código, recursos habilitados e tamanho do banco de dados. Para obter uma estimativa mais precisa sobre a conversão de código, use a avaliação de código.

Nota

Os seguintes esquemas integrados do sistema ou Oracle são excluídos da avaliação da carga de trabalho:

APEX, APPQOSSYS, AUDSYS, , CTXSYS, DBMS_PRIVILEGE_CAPTUREOWBSYS_AUDITGSMADMIN_INTERNALLBACSYSMDDATAMDSYSMGDSYSMGMT_VIEWFLOW_ODMMTMSYSODM_MTROJVMSYSOLAPSYSORACLE_OCMORDDATAEXFSYSORDSYSORDPLUGINSSQLTXPLAINSPATIAL_WFS_ADMIN_USRSYSSPATIAL_CSW_ADMIN_USRSI_INFORMTN_SCHEMASDESYSMANPERFSTATOWBSYSOUTLNSYSTEMOSE$HTTP$ADMINDVSYSTRACESRVWKSYSWKPROXYWK_PROXYWEBSYSWK_TESTWMSYSDBSFWUSERDIPXDBDBSNMPDMSYSDVFTSMSYSCSMIGXS$NULL

A recomendação SKU fornece os seguintes itens:

  • O destino adequado do Azure.

  • A camada de serviço.

  • Os limites métricos são usados para fornecer o SKU recomendado.

    Captura de tela mostrando recomendações de SKU.

A recomendação de SKU avalia várias métricas de desempenho, como CPU, memória, IOPS, latência e armazenamento. Com base no uso e nos dados de configuração, o recomendado fornece o destino adequado e a camada de serviço apropriada. A recomendação de SKU é baseada na instância raiz do contêiner ou na utilização do banco de dados conectável. A seleção de esquema é ignorada e não se aplica ao dimensionamento de SKU.

Nota

Se o recurso de repositório automático de carga de trabalho (AWR) estiver habilitado na instância Oracle, o recomendado de SKU usará as DBA_HIST_ exibições para coletar os metadados de métricas de desempenho. Caso contrário, o recomendado usará a configuração do servidor e outras informações de exibição do sistema para dimensionar o destino SQL do Azure.

A compatibilidade de código (somente para destinos PostgreSQL) fornece um resumo dos objetos de esquema que podem ser convertidos para o destino do Azure. O relatório fornece a divisão dos objetos que podem ser convertidos automaticamente, prontos com condições e precisam ser remediados e convertidos manualmente.

Captura de tela mostrando o relatório de compatibilidade de código.

O relatório mostra o número total de objetos e as horas de esforço de conversão necessárias para migrar o código para o banco de dados PostgreSQL do Azure. A imagem gráfica fornece a divisão para cada tipo de objeto de esquema, como tabelas, exibições e clusters. Os esforços são categorizados como "Pronto - convertido automaticamente", "Precisa de revisão" e "Não está pronto - requer conversão manual".

Um detalhamento para as seções "Não está pronto" e "Precisa de revisão" fornece a lista de tarefas de correção e as horas de esforço para cada tarefa.

Captura de tela mostrando a tarefa de correção.

A avaliação de recursos fornece os recursos mapeados de destino de dados do Oracle para o Azure e o esforço necessário para migrar esses recursos para o destino do Azure.

Captura de tela mostrando a avaliação mapeada.

Você pode baixar o relatório para visualização offline selecionando Baixar relatórios combinados ou Baixar relatórios individuais.

Captura de tela mostrando a opção de relatório de avaliação de download.

Você também pode cancelar uma avaliação contínua, excluir uma avaliação e mover avaliações para outro diretório.

Alterar caminho de avaliação

  1. Vá para o mercado de extensões e procure Avaliação de migração de banco de dados para Oracle.
  2. Selecione o ícone Gerenciar e selecione Configurações de extensões.
  3. Forneça o novo caminho de avaliação em Oracle Assessment: Assessment Path.

Captura de ecrã a mostrar a opção Alterar caminho de avaliação.

Resolver problemas

Registos

A extensão armazena erros, avisos e outros registos de diagnóstico no diretório de registo predefinido:

  • Windows - C:\Users\<username>.dmaoracle\logs\
  • Linux - ~/.dmaoracle/logs
  • macOS - /Users/<username>/.dmaoracle/logs

Nota

Por padrão, a extensão armazena os últimos sete arquivos de log.

Para alterar o diretório de log, atualize a LogDirectory propriedade no arquivo de configurações de extensão.

Sistema operativo Caminho
Windows C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux ~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS /Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Para obter mais informações sobre como solucionar problemas, visite Solucionar problemas de avaliação de migração de banco de dados para erros de extensão Oracle.

Problemas e limitações conhecidos

  • O caminho fornecido não existe.

    Motivo: arquivos ausentes ou permissão ausente na pasta de avaliação.

    Solução possível:

    • O usuário tem permissão de leitura e gravação na pasta de avaliação.
    • Se houver um arquivo ou pasta ausente, exclua a avaliação e gere uma nova avaliação.
  • Exceção de tempo limite de conexão encontrada ao interagir com o Oracle.

    Motivo: Falha ao se conectar à instância Oracle.

    Solução possível:

    • Verifique se as regras de firewall bloqueiam a porta de escuta Oracle.
    • Execute tnsping e veja se o ID de serviço é resolvido.

Entre em contato com a Microsoft para obter ajuda

Se precisar de mais assistência da Microsoft, entre em contato com @dmasupport. Para uma resposta mais rápida, você pode anexar os logs do diretório de log padrão.