Migrar com um arquivo DACPAC

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

O Assistente de Migração do Fabric é uma ferramenta de migração que você pode usar para copiar pools de SQL dedicados no Azure Synapse Analytics, bancos de dados no SQL Server e bancos de dados de outras plataformas do Mecanismo de Banco de Dados SQL facilmente para o Fabric Data Warehouse.

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

Dica

Para obter mais informações sobre os recursos do Assistente de Migração, consulte o Assistente de Migração do Fabric para Data Warehouse.

Para obter mais informações sobre estratégia e planejamento de migração, consulte Planejamento de migração: ​pools de SQL dedicados do Azure Synapse Analytics para o Data Warehouse do Fabric.

Pré-requisitos

Antes de começar, certifique-se de ter os seguintes itens prontos:

• Um workspace do Fabric com capacidade ativa ou capacidade de avaliação.
• Crie um workspace ou selecione um workspace existente para o qual você deseja migrar. O Assistente de Migração cria um novo warehouse para você.
• Arquivo DACPAC extraído do pool de SQL dedicado do Azure Synapse Analytics. Um arquivo DACPAC é criado a partir de projetos de banco de dados SQL e contém os metadados de objetos de banco de dados, incluindo o esquema de tabelas, exibições, 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 de camada de dados) de um pool de 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.

Para usar os recursos de migração assistidos por IA do Assistente de Migração para corrigir problemas de migração, você precisa ativar o Copilot:

• Seu administrador precisa habilitar a alternância de inquilino antes de começar a usar o Copilot. Para mais detalhes, consulte Configurações de assinante do Copilot.
• Sua capacidade de F2 ou P1 precisa estar em uma das regiões listadas na disponibilidade da região do Fabric.
• Se o locatário ou a 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 ao Azure OpenAI possam ser processados fora da região geográfica da sua capacidade, do limite de conformidade ou da configuração de locatário da instância de nuvem nacional no portal do Administrador do Fabric.
• Não há suporte para o Copilot no Microsoft Fabric em versões de avaliação. Há suporte apenas para SKUs pagos (F2 ou superior ou P1 ou superior) no momento.
• Para obter mais informações, consulte Visão geral do Copilot no Fabric e no Power BI.

Copiar metadados

1. No espaço de trabalho do Fabric, selecione o botão Migrar no painel de ação do item.

   

2. No menu de origem Migrate to Fabric, em Migrate to a warehouse, selecione o bloco do sistema de origem.

   • Se você estiver migrando de um pool de SQL dedicado do Azure Synapse Analytics, selecione o azulejo do Azure Synapse Analytics dedicated SQL pool.
   • Se você estiver migrando de qualquer outro banco de dados T-SQL, como um banco de dados no SQL Server, no Banco de Dados SQL do Azure ou na Instância Gerenciada de SQL do Azure, selecione o bloco do banco de dados do SQL Server .

   

3. Na página Escolher seu método , selecione Carregar um arquivo com os metadados de origem e selecione Avançar.

4. Selecione Escolher arquivo e carregue o arquivo DACPAC do data warehouse de origem. Quando o upload for concluído, selecione Avançar.

   

5. Na página Definir o destino , insira o nome do novo workspace do Fabric e o novo item de warehouse para o qual você deseja migrar. Selecione Próximo.

6. Examine suas entradas e selecione Migrar. O Assistente de Migração cria um novo item de warehouse e inicia a migração de metadados.

   Observação

   Quando você usa o Assistente de Migração, o novo warehouse tem ordenação insensível a maiúsculas e minúsculas, independentemente da configuração de ordenação de warehouse padrão.

   

   Durante essa etapa, o Assistente de Migração converte metadados T-SQL para sintaxe T-SQL com suporte no Fabric Data Warehouse. Depois que a migração de metadados for concluída, o Assistente de Migração será aberto. Você pode acessar o Assistente de Migração a qualquer momento usando o botão Migração na guia Página Inicial da faixa de opções do warehouse.

7. Examine o resumo da migração de metadados no Assistente de Migração. Você vê a contagem de objetos migrados e os objetos que precisam ser corrigidos antes que eles possam ser migrados.

   

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

   

   A coluna Estado indica se o Assistente de Migração ajustou os metadados do objeto durante a tradução para o Fabric Data Warehouse. Por exemplo, você pode ver que determinados tipos de dados de coluna ou constructos de linguagem T-SQL são convertidos automaticamente para os que têm suporte no Fabric. A coluna Detalhes mostra as informações sobre os ajustes que o portal fez aos objetos.

9. Selecione qualquer objeto para ver os ajustes que o Assistente de Migração fez durante a migração.

10. Abra o resumo da migração de metadados no modo de exibição de tela inteira para obter melhor legibilidade. Aplique filtros para exibir tipos de objeto específicos.

    

11. Opcionalmente, selecione o menu Exportar para baixar um resumo de migração como um arquivo do Excel ou um CSV.

    • O arquivo do Excel baixado é uma pasta de trabalho totalmente estruturada com duas planilhas: Objetos Migrados e Objetos para Correção. Ele é compatível com MIP e está alinhado com os rótulos de confidencialidade da sua organização.
    • O CSV é leve e amigável para ferramentas.

    

    Cada arquivo exportado fornece uma exibição estruturada e abrangente dos resultados da migração, incluindo:

    Nome do campo	Descrição	Valores de exemplo
    Nome do objeto	Nome do objeto SQL
    Tipo de objeto	Tipos de objeto SQL	Tabela, exibição, procedimento armazenado, função
    State	Estado de tradução	Ajustado: as atualizações compatíveis com o Fabric Data Warehouse são aplicadas Não ajustado: nenhuma alteração no script original
    Detalhes	Lista de ajustes aplicados ou mensagens de erro
    Tipo de erro	Tipo de erro de tradução	Mensagem de tradução, erro de tradução, erro de aplicação de tradução

Corrigir problemas usando o Assistente de Migração

Alguns metadados de objeto de banco de dados podem falhar ao migrar. Normalmente, essa falha ocorre porque o Assistente de Migração não conseguiu converter os metadados T-SQL para aqueles com suporte em um armazém do Fabric ou o código traduzido não foi aplicado ao T-SQL.

Corrija esses scripts usando o Assistente de Migração.

1. Selecione a etapa Corrigir problemas no Assistente de Migração para ver os scripts que não foram migrados.

   

2. Selecione um objeto de banco de dados que não foi migrado. Uma nova consulta é aberta em Consultas compartilhadas no Explorer. Essa 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. Examine 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 de IA na correção dos erros, selecione Corrigir erros de consulta na seção Ação sugerida. O Copilot atualiza o script com sugestões. Erros podem ocorrer 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 ser corrigido é aberto.

8. Continue corrigindo o resto dos scripts. Você pode optar por ignorar a correção de scripts que não precisa 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 a 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

A função "Copiar Dados" ajuda na migração de dados utilizados pelos objetos em migração. Você pode usar um trabalho de cópia do Fabric Data Factory para fazer isso manualmente ou seguir estas etapas para a integração do trabalho 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. Insira um nome para o novo trabalho e selecione Criar.

4. Na página Conectar à fonte de dados , insira as credenciais de conexão para o pool de SQL DEDICADO do SQL DW (Azure Synapse Analytics) de origem. Selecione Próximo.

5. Na página Escolher dados, selecione as tabelas que deseja migrar. Os metadados de objeto já devem existir no warehouse de destino. Selecione Próximo.

   

6. Na página Escolher destino de dados, escolha o novo item do warehouse do Fabric no catálogo do OneLake. Selecione Próximo.

7. Na página Mapa para o destino, configure os mapeamentos de coluna de cada tabela. Selecione Próximo.

8. Na página Modo de trabalho de cópia, 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 Próximo.

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

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

Rotear conexões novamente

Na etapa final, reconecte as plataformas de carregamento e relatório de dados para que suas conexões apontem para o novo armazém do Fabric.

1. Identifique conexões em seu armazém de origem existente.

   • Por exemplo, nos pools de SQL dedicados do Azure Synapse Analytics, você pode encontrar informações de sessão, incluindo o aplicativo de origem, quem está conectado, de onde a conexão está vindo e se está usando a autenticação do Microsoft Entra ou do 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 suas plataformas de relatórios para que apontem para o armazém do Fabric.

3. Teste o warehouse do Fabric com alguns relatórios antes de redirecionar. Execute testes de comparação e validação de dados em suas plataformas de relatório.

4. Atualize as conexões para plataformas de ETL/ELT (carregamento de dados) para apontar para o seu warehouse do Fabric.

   • Para os pipelines do Power BI/Fabric:
     1. Utilize a API REST List Connections para localizar conexões com sua antiga fonte de dados, o pool dedicado de SQL do Azure Synapse Analytics.
     2. Atualize as conexões com o novo warehouse usando a página Gerenciar Conexões e Gateways em Configurações.

5. Ao concluir, verifique a etapa Redirecionar Conexões no Assistente de Migração.

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

Conteúdo relacionado

• Assistente de Migração do Fabric para Data Warehouse
• Visão geral da migração do Microsoft Fabric
• Atualizar os pipelines do Azure Data Factory para o Fabric