Migrar com o Assistente de Migração do Fabric para Armazém de Dados

Aplica-se para:✅ Armazém no Microsoft Fabric

O Assistente de Migração de Malha é uma experiência de migração para copiar pools SQL dedicados no Azure Synapse Analytics, SQL Server e outras plataformas de banco de dados SQL diretamente no Microsoft Fabric Data Warehouse.

Este guia orienta você pelas etapas para migrar de um pool SQL dedicado do Azure Synapse Analytics para o armazém do Fabric usando um arquivo DACPAC.

Pré-requisitos

Antes de começar, certifique-se de que tem o seguinte pronto:

• Um espaço de trabalho do Fabric com capacidade ativa ou em avaliação.
• Crie um espaço de trabalho ou selecione um espaço de trabalho existente para o qual você deseja migrar. O Assistente de Migração criará um novo armazém para si.
• Ficheiro DACPAC extraído do pool SQL dedicado do Azure Synapse Analytics. Um ficheiro DACPAC (pacote de aplicação da camada de dados) é gerado a partir de projetos de bases de dados SQL e contém os metadados de objetos de base de dados, incluindo o esquema de tabelas, vistas, procedimentos armazenados, funções e muito mais.
  • Para criar um DAC no Visual Studio 2022 com o SQL Server Data Tools, consulte Extrair um DAC (Aplicativo da Camada de Dados) de um pool SQL dedicado do Azure Synapse no Visual Studio 2022.
  • Você também pode usar projetos de banco de dados no estilo SDK com o VS Code ou o utilitário de linha de comando SqlPackage.

Os recursos de migração assistida por IA do Assistente de Migração para corrigir problemas de migração exigem que o Copilot seja ativado:

• O seu administrador precisa ativar a mudança de inquilino antes de começar a usar o Copilot. Para obter mais informações, consulte Configurações do inquilino do Copilot.
• A sua capacidade F2 ou P1 precisa estar numa das regiões listadas em disponibilidade regional do Fabric.
• Se o seu locatário ou capacidade estiver fora dos EUA ou da França, o Copilot será desabilitado por padrão, a menos que o administrador do locatário do Fabric habilite que os Dados enviados para o Azure OpenAI possam ser processados fora da região geográfica da sua capacidade, limite de conformidade ou configuração de locatário de instância de nuvem nacional no portal de Administração do Fabric.
• O Copilot no Microsoft Fabric não é suportado em SKUs de teste. Apenas SKUs pagos (F2 ou superior, ou P1 ou superior) são suportados no momento.
• Para obter mais informações, consulte Visão geral do Copilot no Fabric e no Power BI.

Copiar metadados

1. No seu Fabric workspace, selecione o botão Migrar no deck de ações do item.

   Captura de tela do portal Fabric do botão Migrar na barra de ações do item.

2. No menu de origem Migrate to Fabric, em Migrar para um armazém, selecione a opção armazém ou banco de dados Analytical T-SQL.

   

3. Na Visão geral, revise as informações e selecione Avançar.

4. Selecione Escolher ficheiro e carregue o ficheiro DACPAC do seu data warehouse de origem. Quando o carregamento estiver concluído, selecione Seguinte.

   

5. Na página Definir o destino, forneça o nome do novo Fabric workspace e do novo item de armazém para o qual pretende migrar. Selecione Seguinte.

6. Revise os seus dados e selecione Migrar. Um novo item de depósito será criado e a migração de metadados será iniciada.

   

   Durante esta etapa, o Assistente de Migração converte metadados T-SQL para sintaxe T-SQL suportada no Fabric data warehouse. Quando a migração de metadados estiver concluída, o Assistente de migração será aberto. Você pode aceder ao Assistente de Migração a qualquer momento utilizando o botão Migração no separador Início da barra de ferramentas do depósito.

7. Analise o resumo de migração de metadados no Assistente de Migração. Você verá a contagem de objetos migrados e os objetos que precisam ser corrigidos antes que possam ser migrados.

   Captura de tela do resumo de migração de metadados do Assistente de Migração no portal Fabric. A opção Mostrar objetos migrados é realçada.

8. Selecione Mostrar objetos migrados para expandir a secção e ver uma lista de objetos que foram migrados com êxito para o seu armazém Fabric.

   Captura de ecrã do portal Fabric do resumo da migração de metadados do Assistente de Migração e da lista de objetos migrados.

   A coluna State indica se os metadados do objeto foram ajustados durante a tradução para ser suportada no Fabric Warehouse. Por exemplo, pode verificar que determinados tipos de dados de coluna ou construções de linguagem T-SQL são convertidos automaticamente para aqueles que são suportados no Fabric. A coluna Detalhes mostra as informações sobre os ajustes que foram feitos nos objetos.

9. Selecione qualquer objeto para ver os ajustes feitos durante a migração.

10. Abra o resumo da migração de metadados na visualização em tela cheia para melhor legibilidade. Aplique filtros para exibir tipos de objeto específicos.

    

Corrigir problemas ao utilizar o Assistente de Migração

Alguns metadados de objeto de banco de dados podem falhar na migração. Geralmente, isso ocorre porque o Assistente de Migração não conseguiu traduzir os metadados do T-SQL para aqueles suportados num armazém Fabric ou o código traduzido falhou ao ser aplicado ao T-SQL.

Vamos corrigir esses scripts com a ajuda do Assistente de Migração.

1. Selecione o passo Corrigir problemas no Assistente de Migração para ver os scripts que falharam na migração.

   

2. Selecione um objeto de banco de dados que falhou ao migrar. Uma nova consulta é aberta sob as Consultas partilhadas no Explorer. Esta nova consulta mostra a definição de metadados e os ajustes que foram feitos a ela como comentários automáticos adicionados ao código T-SQL.

3. Analise os comentários no início do script para ver os ajustes que foram feitos no script.

4. Revise e corrija os scripts quebrados usando as informações de erro e a documentação.

5. Para usar o Copilot para assistência alimentada por IA na correção dos erros, selecione Corrigir erros de consulta na seção Ação sugerida. O copiloto atualiza o roteiro com sugestões. Erros podem acontecer, pois o Copilot usa IA, portanto, verifique as sugestões de código e faça os ajustes necessários.

   

6. Selecione Executar para validar e criar o objeto.

7. O próximo script a corrigir abre-se.

8. Continue a corrigir o resto dos scripts. Você pode optar por ignorar a correção de scripts que não são necessários durante esta etapa.

9. Quando todos os metadados desejados estiverem prontos para migração, selecione o botão Voltar no painel Corrigir problemas para retornar à exibição de nível superior do Assistente de Migração. Verifique a etapa 2. Corrigir problemas no Assistente de migração.

Copiar dados usando o Assistente de Migração

Copiar dados ajuda na migração de dados usados pelos objetos que você migra. Você pode usar uma tarefa de cópia do Fabric Data Factory para fazê-lo manualmente ou seguir estas etapas para a integração da tarefa de cópia no Assistente de Migração.

1. Selecione a etapa Copiar dados no Assistente de Migração.

2. Selecione o botão Usar um trabalho de cópia.

3. Atribua um nome ao novo trabalho e selecione Criar.

4. Na página Conectar à fonte de dados, forneça as credenciais de conexão para o depósito de origem do Azure Synapse Analytics (SQL DW). Selecione Seguinte.

5. Na página Escolher dados, selecione as tabelas que deseja migrar. Os metadados do objeto já devem existir no depósito de destino. Selecione Seguinte.

   

6. Na página Escolher destino de dados, escolha seu novo item de Fabric warehouse no catálogo OneLake. Selecione Seguinte.

7. Na página Mapa para o destino, configure os mapeamentos de colunas de cada tabela. Selecione Seguinte.

8. Na página modo de cópia de tarefas, escolha o modo de cópia. Escolha uma cópia de dados completa única (recomendada para migração) ou uma cópia incremental contínua. Selecione Seguinte.

9. Analise o resumo do trabalho. Selecione Salvar + Executar.

10. Quando o trabalho de cópia estiver concluído, verifique a etapa 3. Copiar dados no Assistente de Migração. Selecione o botão Voltar na parte superior para retornar à vista principal do Assistente de Migração.

Redirecionar conexões

Na etapa final, as plataformas de carregamento e relatório de dados conectadas à sua origem precisam ser reconectadas ao seu novo armazém Fabric.

1. Identifique conexões em seu armazém de origem existente.
   • Por exemplo, nos pools SQL dedicados do Azure Synapse Analytics, você pode encontrar informações de sessão, incluindo o aplicativo de origem, quem está conectado, de onde vem a conexão e se está usando a ID do Microsoft Entra ou a autenticação SQL:

   SELECT DISTINCT CASE 
            WHEN len(tt) = 0
                THEN app_name
            ELSE tt
            END AS application_name
        ,login_name
        ,ip_address
   FROM (
        SELECT DISTINCT app_name
            ,substring(client_id, 0, CHARINDEX(':', ISNULL(client_id, '0.0.0.0:123'))) AS ip_address
            ,login_name
            ,isnull(substring(app_name, 0, CHARINDEX('-', ISNULL(app_name, '-'))), 'h') AS tt
        FROM sys.dm_pdw_exec_sessions
        ) AS a;
   

2. Atualize as conexões com as suas plataformas de relatórios para apontar para o seu armazém do Fabric.
3. Realize testes no armazém do Fabric com relatórios antes do reencaminhamento. Realize testes de comparação e validação de dados em suas plataformas de relatórios.
4. Atualize as conexões para plataformas de carregamento de dados (ETL/ELT) para apontar para o seu armazém de dados Fabric.
   • Para pipelines do Power BI/Fabric:
     • Utilize a API REST de Listar Conexões para encontrar conexões com a sua fonte de dados antiga, o pool SQL dedicado do Azure Synapse Analytics.
     • Atualize as ligações para o novo armazém de dados do Fabric utilizando a funcionalidade Gerir Conexões e Gateways nas definições de Configurações.
5. Depois de concluído, verifique a etapa Redirecionar conexões no Assistente de Migração.

Parabéns! Agora você está pronto para começar a usar o armazém.

Conteúdo relacionado

• Assistente de Migração do Fabric para Armazém de Dados
• Visão geral da migração do Microsoft Fabric