Extensão Avaliação de Migração de Banco de Dados para Oracle

Observação

Esta extensão será desativada em 15 de dezembro de 2024. Deixaremos de oferecer suporte para essa ferramenta para quaisquer problemas que surgirem, e não publicaremos nenhuma correção de bugs ou atualizações adicionais.

A extensão Database Migration Assessment for Oracle no Azure Data Studio ajuda você a avaliar uma carga de trabalho do Oracle para migrar para o SQL do Azure e o Banco de Dados do Azure para PostgreSQL. A extensão identifica um destino apropriado do SQL do Azure ou do PostgreSQL com recomendações sobre o dimensionamento correto e informa o quanto a migração poderá ser complexa.

Pré-requisitos

• Azure Data Studio versão 1.39 ou versão posterior.

• Um banco de dados Oracle que executa a versão 11g ou superior.

• Os usuários do Oracle devem ter os privilégios CONNECT e SELECT ANY DICTIONARY atribuídos.

Instalar extensão Azure Data Studio

Siga as etapas abaixo para instalar a extensão do Database Migration Assessment 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 escolher Extensões no menu Exibir.

2. Digite Oracle na barra de pesquisa.

3. Selecione a extensão Avaliação de Migração de Banco de Dados para Oracle e veja os detalhes dela.

4. Selecione Instalar.

   

Definir as configurações da extensão

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

1. Acesse as extensões e selecione Database Migration Assessment for Oracle, escolha o ícone Gerenciar configurações e selecione as configurações da extensão.

   

2. Em configurações da extensão, edite as configurações desejadas para atender às necessidades do ambiente.

   

   Observação

   Para executar a avaliação de código do 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 o Oracle ao seu banco de dados, coletar informações de metadados da instância do Oracle e gerar um relatório de avaliação.

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

   

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 ORACLE_HOMEvariável de ambiente está definida e se o arquivo TNSNAMES.ORA está localizado em <ORACLE_HOME>/network/admin folder.)
      2. Para o banco de dados de contêineres, você pode conectar o banco de dados raiz de contêineres usando o ID do serviço CDB, ou pode 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 de Usuário.
   4. Forneça a senha do banco de dados no campo Senha.

   

3. Selecione Conectar.

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

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

   

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

   

7. Selecione 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 da avaliação.

      1. Insira o banco de dados de migração de destino no campo Plataforma de Destino. Atualmente, ele dá suporte ao SQL do Azure e ao PostgreSQL como destinos.

         Observação

         O PostgreSQL como destino está em preview. Essa opção de destino será descontinuada. Você deve exportar todas as avaliações anteriores.

      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 do AWR.

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

         Observação

         A opção de avaliação do relatório AWR não está habilitada para o 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 de fator de escala deverá ser maior que 1. Por exemplo, carregamento de intermitência, uso sazonal e planejamento da capacidade futura. Quando uma carga de trabalho de esquema parcial do Oracle é migrada, o multiplicador deve ser menor que 1.

      4. No campo Utilização do percentil, insira o valor de percentil para dimensionar o destino do Azure.

         • O valor do percentil da amostra de desempenho definido a ser considerado para o dimensionamento do destino do Azure.

   

9. Há dois tipos de avaliações:

   • Avaliação da carga de trabalho. Nessa avaliação, o módulo de avaliação do Oracle executa uma descoberta leve dos objetos do esquema e categoriza a complexidade do esquema de migração para várias categorias com uma estimativa de alto nível para as horas de conversão. Essa 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 detalhada dos objetos do esquema do Oracle e sugere uma preparação geral dos objetos de código com os tipos de objetos "pronto", "necessita revisão" e "não pronto" em nível granular e as respectivas horas de conversão com maior precisão.

     Observação

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

     Se o cliente Oracle e/ou Ora2Pg não estiver instalado no mesmo computador do 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 do 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 as várias regras de validação relacionadas a permissões de segurança, definições de configuração etc. Se a validação falhar, você precisará corrigir os erros para prosseguir.

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

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

    

13. Selecione o link da avaliação para ver a página de detalhes da avaliação. Você pode exibir o status de 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: sucesso, falha, em andamento ou cancelado.

Exibir a avaliação

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

Cada cartão tem várias seções. O cartão mostra a viabilidade geral da migração para o destino. Faça uma busca detalhada de várias cargas de trabalho em diversas categorias de complexidade da migração:

• A seção Compatibilidade de recursos fornece o resultado da análise da avaliação de recursos.
• A recomendação de SKU fornece o dimensionamento adequado do destino.
• A avaliação de código fornece a complexidade do código dos objetos de banco de dados.

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

Se o destino selecionado for o Banco de Dados do Azure para PostgreSQL, a guia Detalhes do banco de dados ou a guia Avaliação de código ficará 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. Ela mostra a lista de esquemas descobertos, a viabilidade da migração e o tempo estimado para converter o esquema em horas.

Essa estimativa se baseia em um modelo estatístico que se aplica à contagem de objetos, às linhas de código, aos recursos habilitados e ao 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.

Observação

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

APEX, APPQOSSYS, AUDSYS, CSMIG, CTXSYSDBMS_PRIVILEGE_CAPTUREDBSFWUSERDBSNMPDIPDMSYSDVFDVSYSEXFSYSFLOW_GSMADMIN_INTERNALLBACSYSMDDATAMDSYSMGDSYSMGMT_VIEWMTMSYSODMODM_MTROJVMSYSOLAPSYSORACLE_OCMORDDATAORDPLUGINSORDSYSOSE$HTTP$ADMINOUTLNOWBSYSOWBSYS_AUDITPERFSTATSDESI_INFORMTN_SCHEMASPATIAL_CSW_ADMIN_USRSPATIAL_WFS_ADMIN_USRSQLTXPLAINSYSSYSMANSYSTEMTRACESRVTSMSYSWEBSYSWKPROXYWKSYSWK_PROXYWK_TESTWMSYSXDBXS$NULL

A recomendação de SKU fornece os seguintes itens:

• O destino adequado do Azure.

• A camada de serviço.

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

  

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 recomendador 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 é aplicável ao dimensionamento de SKU.

Observação

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

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

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 do 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", "Necessita revisão" e "Não pronto – exige conversão manual".

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

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

Baixe o relatório para exibição offline selecionando Baixar relatórios combinados ou Baixar relatórios individuais.

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

Alterar o caminho de avaliação

1. Acesse o marketplace de extensões e pesquise Database Migration Assessment para Oracle.
2. Selecione o ícone de Gerenciar e depois Configurações de extensões.
3. Forneça o novo caminho de avaliação em Avaliação Oracle: Caminho de Avaliação.

Solucionar problemas

Logs

A extensão armazena erros, avisos e outros logs de diagnóstico no diretório de log padrão:

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

Observação

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

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

Sistema operacional	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 Solução de problemas do erros na extensão do Database Migration Assessment para Oracle.

Limitações e problemas conhecidos

• O caminho fornecido não existe.

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

  Solução possível:

  • O usuário tem permissão de leitura e gravação na pasta da avaliação.
  • Se houver um arquivo ou uma pasta ausente, exclua a avaliação e gere uma nova avaliação.

• Exceção de tempo limite de conexão encontrada durante a interação com o Oracle.

  Motivo: falha na conexão com a instância do Oracle.

  Solução possível:

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

Entre em contato com a Microsoft para obter ajuda

Caso precise de mais assistência da Microsoft, entre em contato com @dmasupport. Para um retorno mais rápido, você pode anexar os logs do diretório de logs padrão.

Conteúdo relacionado

• Extensão para o Oracle (preview)
• Extensão de Migração do SQL do Azure para Azure Data Studio
• Kit de ferramentas de conversão de esquema de banco de dados (DSCT)
• Estender a funcionalidade do Azure Data Studio