Compartilhar via


Solucionar problemas ao migrar para a Instância Gerenciada de SQL do Azure

Este artigo ajuda você a solucionar problemas comuns que você pode encontrar ao migrar bancos de dados do SQL Server para a Instância Gerenciada de SQL do Azure usando a migração do SQL Server no Azure Arc.

Observação

Você pode fornecer comentários sobre sua experiência de migração diretamente para o grupo de produtos.

Versão do agente do Arc

Quando você usa a migração do SQL Server no Azure Arc, determinados recursos exigem uma versão mínima do agente do Arc. O agente arc é um executável que é executado junto com sua instância do SQL Server para fornecer conectividade com o Azure. Sempre mantenha a versão do agente do Arc atualizada para obter as últimas correções e atualizações.

Com as atualizações automáticas habilitadas, o agente arc permanece atualizado automaticamente. No entanto, quando uma nova versão do agente arc é distribuída, pode levar alguns dias para que a atualização chegue a todos os servidores. Você pode acelerar o processo executando manualmente uma atualização de agente do Arc sob demanda por meio do portal do Azure ou das interfaces de linha de comando.

Se você vir o seguinte erro ao acessar o painel de migração de banco de dados no portal do Azure, precisará atualizar o agente do Arc para uma versão com suporte:

To enable migration and monitoring capabilities, 
please update your Azure Arc agent extension "WindowsAgentSQLServer" to the latest version.

Problemas do Agente Arc

Se você encontrar problemas com o agente Arc, como um estado de extensão não saudável ou uma instância desconectada do SQL Server, use o seguinte guia de solução de problemas de extensão: Troubleshoot Azure extension for SQL Server.

Problemas de avaliação de preparação para a migração

O sistema executa avaliações de preparação para a migração todos os domingos às 23h locais para o servidor. As avaliações para instâncias do SQL Server recém-habilitadas pelo Azure Arc podem levar vários dias para aparecer no portal do Azure. Use Executar avaliação para disparar uma avaliação sob demanda. A avaliação é exibida após alguns minutos.

Se a página de avaliações de preparação para a migração do banco de dados estiver em branco no portal do Azure, a avaliação agendada provavelmente não foi executada ou houve um problema ao executar a avaliação na instância do SQL Server. Desabilitar o agente Arc impede que as avaliações sejam executadas. Verifique se o agente do Arc está habilitado. Para obter mais informações, consulte Alterar as configurações de avaliação.

Considere o seguinte problema conhecido:

  • Quando xp_cmdshell está habilitada e usada, a avaliação registra um aviso para a Instância Gerenciada de SQL porque você ainda pode migrar o banco de dados. No entanto, ele interrompe a funcionalidade do objeto que usa xp_cmdshellespecificamente. Use as diretrizes de correção fornecidas na avaliação para mitigar o problema.

Entre em contato com o Suporte da Microsoft se você encontrar algum dos seguintes problemas:

  • Os relatórios de avaliação não aparecem no portal mesmo após o horário agendado.
  • A disponibilidade de dados de desempenho não aumenta após uma semana de coleta de dados.

Exibir o log de atividades do Azure para problemas de migração

O log de atividades no portal do Azure, quando acessado de um recurso, fornece informações sobre eventos no nível de recurso que ocorrem no Azure. Esse insight inclui informações sobre quando você modifica ou exclui recursos, bem como detalhes sobre a integridade do serviço e outros eventos importantes.

Ao solucionar problemas de migração para a Instância Gerenciada de SQL do Azure usando a migração do SQL Server no Azure Arc, o log de atividades é um recurso valioso para identificar problemas e entender a sequência de eventos que levaram a um problema.

Para acessar o log de atividades no portal do Azure para sua instância do SQL Server habilitada pelo recurso do Azure Arc, siga estas etapas:

  1. Vá para a instância do SQL Server habilitada pelo recurso do Azure Arc no portal do Azure.

  2. Selecione o log de atividades no menu de recursos:

    Captura de tela do log de atividades realçado para um recurso de instância do SQL Server no portal do Azure.

Você também pode acessar o log de atividades no nível da assinatura para uma exibição mais ampla dos eventos em todos os recursos em sua assinatura selecionando o ícone de sino de notificação da barra de navegação superior e selecionando Mais eventos no log de atividades:

Captura de tela do ícone de sino de notificações destacado no portal Azure.

Selecione um evento no log de atividades para abrir um painel de detalhes do evento. Use as guias Resumo e JSON para exibir informações detalhadas sobre o evento, incluindo mensagens de erro específicas. Se você criar uma solicitação de suporte, comunique essas informações com o máximo de detalhes possível.

Esta seção descreve alguns dos problemas comuns com o recurso de link da Instância Gerenciada ao migrar para a Instância Gerenciada de SQL do Azure por meio da migração do SQL Server no Azure Arc:

Service pack incorreto instalado

Certifique-se de que você tem o SP (service pack) ou o CU (atualização cumulativa) apropriado do SQL Server instalado.

Você pode verificar a versão correta executando o seguinte comando T-SQL em sua instância do SQL Server:

EXEC sp_certificate_add_issuer @CERTID, N'*.database.windows.net'

Se você receber o erro de que o SQL Server não consegue encontrar o procedimento sp_certificate_add_issuerarmazenado, provavelmente não terá o pacote de manutenção adequado instalado (como o pacote de recursos do Azure Connect). Instale as atualizações de manutenção necessárias e tente novamente.

Recurso de grupo de disponibilidade Always On desabilitado

Verifique se o recurso de grupo de disponibilidade Always On está habilitado na instância do SQL Server. O link da Instância Gerenciada requer que o Grupo de Disponibilidade Always On esteja habilitado para que haja funcionalidade adequada.

Usando o SQL Server 2016

Para o SQL Server 2016 (13.x), você deve concluir as etapas extras documentadas em Preparar os pré-requisitos do SQL Server 2016 para o link. Essas etapas extras não são necessárias para o SQL Server 2017 (14.x) e versões posteriores compatíveis com o link.

Problemas de conectividade de rede

A conectividade bem-sucedida entre o ambiente do SQL Server e a Instância Gerenciada de SQL do Azure é essencial para que o recurso de link da Instância Gerenciada funcione. Se você estiver tendo problemas de conectividade de rede, considere os seguintes pontos:

  • O link da Instância Gerenciada não funciona em uma rede pública, portanto, a conexão entre sua instância do SQL Server e a Instância Gerenciada de SQL do Azure deve ser privada, como usando uma VPN.
  • Você pode testar a conectividade diretamente do portal do Azure como parte do processo de migração. Se o teste de conexão for bem-sucedido no portal, mas o link não puder ser criado, verifique o log de atividades para obter detalhes da falha. Você também pode testar a conectividade manualmente usando Transact-SQL e o SQL Server Agent.
  • Verifique se há firewalls corporativos em sua rede. Embora a conectividade de rede pareça funcionar, é possível que os firewalls bloqueiem tipos específicos de pacotes que o SQL Server usa para grupos de disponibilidade distribuídos. Verifique se os firewalls não estão bloqueando ou filtrando tipos de pacotes.

Os seguintes avisos podem aparecer quando iniciar o trabalho de migração do link da Instância Gerenciada. Você pode continuar com a migração apesar destes avisos:

  • Warning: Database Mirroring Endpoint does not exist
  • Warning: Database Mirroring Endpoint is not secure with a certificate
  • Warning: Database Mirroring Endpoint is not enabled
  • Warning: Database Mirroring Endpoint encryption algorithm is not set to AES

Esses avisos são atualmente um problema conhecido e o processo de migração os aborda automaticamente para que você possa continuar com a migração.

Investigue outros avisos. Alguns avisos podem exigir resolução de sua parte antes que você possa iniciar a migração, enquanto alguns podem ser resolvidos após a conclusão da migração.

A configuração de um link por meio do portal do Azure para migração não é compatível com links existentes criados manualmente por meio do SSMS (SQL Server Management Studio) ou do Transact-SQL (T-SQL). Se já existir um link, você não poderá criar um novo link por meio do portal do Azure.

Se já existir um link na origem do SQL Server ou no destino da Instância Gerenciada de SQL do Azure, você precisará executar as seguintes etapas antes de criar um novo link entre essa origem e o destino por meio do portal do Azure:

  1. Remova o link manualmente da Instância Gerenciada de SQL usando Remove-AzSqlInstanceLink ou az sql mi link delete do Azure Cloud Shell ou um computador conectado com um Contexto do Azure.
  2. Remova o link manualmente do SQL Server usando DROP AVAILABILITY GROUP com o nome do grupo de disponibilidade distribuído associado ao link.
  3. Remova todos os certificados relacionados ao link da instância do SQL Server usando DROP CERTIFICATE. Os certificados que você precisa remover normalmente contêm os seguintes valores: DigiKey PKI, , Microsoft PKIe endpointdatabase.windows.net. Você pode usar SELECT * FROM sys.certificates para listar todos os certificados no SQL Server.
  4. Remova todos os certificados relacionados ao link da SQL Managed Instance usando Remove-AzSqlInstanceServerTrustCertificate ou az sql mi partner-cert delete do Azure Cloud Shell ou de uma máquina conectada a um contexto do Azure. Você pode usar Get-AzSqlInstanceServerTrustCertificate ou az sql mi partner-cert show para listar os certificados de autenticação existentes na Instância Gerenciada de SQL.
  5. As etapas anteriores limpam todos os certificados de autenticação relacionados ao link gerados para um link criado manualmente. Se você não estiver usando localmente um grupo de disponibilidade existente, considere excluir o ponto de extremidade de espelhamento de banco de dados existente usando DROP ENDPOINT. Você pode usar SELECT * FROM sys.endpoints para listar todos os endpoints existentes no SQL Server. Você deve remover o certificado associado ao ponto de extremidade antes de poder remover o ponto de extremidade.

Solução de problemas detalhada com o XE Profiler

Para obter uma solução detalhada de problemas de link, use o XE Profiler.

Problemas de migração do Serviço de Reprodução de Logs

Esta seção lista os problemas comuns que você pode encontrar ao migrar usando o LRS (Serviço de Reprodução de Log):

Não é possível listar diretórios no Armazenamento de Blobs do Azure

Se você vir a mensagem de erro dizendo que você está Unable to list directories ao selecionar um diretório na página Nova Migração de Dados no portal do Azure, o usuário atualmente conectado ao portal não tem a função de Leitor de Dados de Blob de Armazenamento atribuída à conta de armazenamento. Conceda ao usuário acesso à conta de armazenamento para resolver o problema.

Nenhum resultado foi encontrado no diretório

Se você vir a mensagem de que No results were found in directory , ao selecionar um diretório na página Nova Migração de Dados no portal do Azure, não haverá nenhum backup de banco de dados disponível no contêiner de Armazenamento de Blobs do Azure. Para resolver esse problema, carregue um backup de banco de dados completo no Armazenamento de Blobs do Azure.

Verificar o status da restauração do arquivo

Para verificar quantos arquivos foram detectados, enfileirados, ignorados ou não puderam ser restaurados durante a migração, use a página Monitor e Cutover no portal do Azure. Depois que uma migração for iniciada, vá para a página Monitor e substituição e selecione o banco de dados que você está migrando para abrir detalhes de migração para esse banco de dados.

Erro 2009 – A identidade gerenciada não está configurada corretamente

Se a migração for iniciada com êxito, mas falhar com o erro 2009 - managed identity is not set up properly, a identidade primária da instância gerenciada não tem a permissão Storage Blob Data Reader atribuída à conta de armazenamento Blob do Azure. Conceda acesso de identidade gerenciada à conta de armazenamento para resolver o problema. Verifique se a identidade apropriada (a identidade gerenciada padrão ou uma identidade personalizada definida pelo usuário) tem as permissões necessárias ou se a identidade não foi alterada desde que as permissões foram concedidas originalmente. Se a identidade for alterada, conceda permissões apropriadas à nova identidade para resolver o problema.

Solucionar problemas de migração com o DMS

Iniciar um trabalho de migração LRS no Azure Arc cria automaticamente um trabalho de migração do DMS (Serviço de Migração de Banco de Dados) para que você possa usar o Serviço de Migração de Banco de Dados do Azure no portal do Azure para ver detalhes adicionais sobre o trabalho de migração.

Para exibir os detalhes do trabalho de migração LRS no DMS, siga estas etapas:

  1. Acesse o Serviço de Migração de Banco de Dados do Azure no portal do Azure.

  2. Selecione Todos os recursos e selecione o trabalho de migração do DMS associado à migração do LRS para abrir a página de detalhes da migração:

    Captura de tela da página de todos os recursos do DMS no portal do Azure.

  3. Na página de detalhes da migração, selecione Monitorar migrações para ver o status dos bancos de dados migrados para uma instância específica usando LRS. Selecione Bem-sucedido, Cancelado ou Erro para ver mais detalhes sobre o status.

    Outra maneira de acessar essa página é por meio do recurso do Serviço de Migração de Banco de Dados do Azure adicionado ao grupo de recursos que contém a Instância Gerenciada de SQL de destino depois que uma migração é iniciada por meio do Azure Arc.

Excluir trabalhos de migração

Os trabalhos de migração LRS permanecem na página Monitor e transição por 28 dias após a conclusão (com êxito ou falha). Você pode excluir manualmente os trabalhos se quiser desmarcá-los da página de monitoramento mais cedo.

Para excluir manualmente os trabalhos, vá para o trabalho de migração do DMS associado à migração de LRS , conforme descrito na seção anterior. Selecione o trabalho de migração que você deseja excluir e, em seguida, use o botão Excluir lixeira para excluir o trabalho. Confirme selecionando "Marque esta caixa para confirmar a exclusão". Essa ação limpa os trabalhos da página Monitor e transição no Azure Arc.

Entrar em contato com a Microsoft

Você pode entrar em contato com a Microsoft para abrir um chamado de suporte sobre um problema que você está enfrentando ou para dar feedback diretamente ao grupo de produtos.

Contate o suporte

Use https://aka.ms/azure-support para acessar a página Ajuda + suporte no portal do Azure e siga estas etapas para abrir um tíquete de suporte relacionado à migração:

  1. Selecione Criar uma solicitação de suporte para abrir o painel Suporte + solução de problemas .
  2. Digite migration no campo de texto e, em seguida, selecione Nenhum dos serviços acimaem Qual serviço você está tendo um problema?
  3. Na lista suspensa Selecionar um serviço, selecione SQL Server enabled by Azure Arc e depois clique em Avançar para prosseguir.
  4. Selecione sua assinatura na lista suspensa.
  5. Selecione sua instância do SQL Server habilitada por Azure Arc na lista suspensa de Recurso e selecione Avançar.
  6. Selecione Problemas de Migração no bloco Você está tendo um dos seguintes problemas? Em seguida, selecione Avançar.
  7. Selecione Criar uma solicitação de suporte na barra de navegação superior no painel Suporte + solução de problemas para abrir o formulário do tíquete de suporte.
  8. Use os seguintes valores de subtipo de problema para rotear seu problema para a fila de suporte apropriada:
  9. Use o Next para prosseguir pelas etapas restantes do formulário de solicitação de suporte e, em seguida, selecione Criar para enviar sua solicitação de suporte.

Fornecer comentários ao grupo de produtos

Você pode fornecer comentários ao grupo de produtos para ajudar a melhorar a experiência de migração. Use o seguinte link para enviar seus comentários: