Migre enviando um arquivo com o Fabric Assistente de Migração

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

O Fabric Assistente de Migração oferece uma experiência guiada para migrar metadados e dados de origem para Fabric Data Warehouse. Este guia explica como migrar metadados de:

• Azure Synapse Analytics ou SQL Server usando um arquivo DACPAC
• Teradata usando um arquivo .zip com arquivos .sql e/ou .bteq

Pré-requisitos

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

• 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ê.
• Um arquivo de metadados de origem em um desses formatos:
  • Um arquivo DACPAC extraído do Azure Synapse Analytics ou SQL Server. Um DACPAC contém metadados para objetos de banco de dados, incluindo tabelas, views, procedimentos armazenados e funções.
    • Para criar um DACPAC a partir do Azure Synapse Analytics, veja Extrair uma Aplicação Data-tier (DAC) de um pool SQL dedicado do Azure Synapse no Visual Studio 2022.
    • Você também pode usar o Assistente de Geração de Scripts no SQL Server Management Studio (SSMS), projetos de banco de dados no estilo SDK com Visual Studio Code ou a utilidade de linha de comando SqlPaquet.
  • Um arquivo ZIP de arquivos Teradata .sql e/ou .bteq que contém as definições de objetos e as dependências necessárias para a migração.

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 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 a configuração de locatário Os dados enviados ao Azure OpenAI podem ser processados fora da região geográfica, do limite de conformidade ou da instância de nuvem nacional da sua capacidade em Catálogo do OneLakeGovernança>>>.
• 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 Migrar para o Fabric, em Migrar para um data warehouse, selecione o bloco do sistema de origem:

   • Para Azure Synapse Analytics, selecione Azure Synapse Analytics dedicated SQL pool.
   • Para SQL Server, Banco de Dados SQL do Azure ou Instância Gerenciada de SQL do Azure, selecione SQL Server Database.
   • Para Teradata, selecione Teradata (Prévia).

   

3. Se aparecer a página Escolha seu método , selecione Enviar um arquivo com os metadados de origem e então selecione Próximo.

   

4. Em Definir a fonte, selecione Escolher arquivo, selecione o arquivo fonte e então selecione Próximo.

   

5. Na página Definir o destino, forneça o nome do espaço de trabalho Fabric e o novo item do armazém para onde 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.

   Note

   Ao usar o Assistente de Migração, o novo data warehouse tem ordenação insensível a maiúsculas e minúsculas, independentemente da configuração de ordenação de data 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 Assistente de Migração fez nos 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.

    

Corrigir problemas usando o Assistente de Migração

Alguns metadados de objeto de banco de dados podem falhar ao migrar. Comumente, essa falha ocorre porque o Assistente de Migração não conseguiu traduzir os metadados do T-SQL para aqueles suportados no Fabric Data Warehouse ou o código traduzido não se aplicou ao T-SQL.

Vamos corrigir esses scripts com a ajuda do 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. Selecionar Usar uma tarefa de cópia.

3. Dê um nome ao novo trabalho e clique em Criar.

4. Na página Conectar à fonte de dados , forneça as credenciais de conexão do seu sistema de origem. Selecione Próximo.

5. Na página Escolher dados , selecione as tabelas que deseja migrar. 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.

   • Em uma instância de SQL Server, você pode usar exibições de gerenciamento dinâmico, por exemplo:

   SELECT 
       s.program_name
   , s.login_name
   , c.client_net_address
   FROM sys.dm_exec_sessions AS s 
   INNER JOIN sys.dm_exec_connections AS c 
   ON s.session_id = c.session_id
   WHERE s.session_id >= 50 --retrieve only user spids
   and s.session_id <> @@SPID; --ignore myself
   

   • Nos pools SQL dedicados do Azure Synapse Analytics, você pode encontrar informações de sessão, incluindo a aplicação de origem, usuário conectado, origem da conexão e método de autenticação:

   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