Migre carregando um ficheiro com a Fabric Assistente de Migração

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

O Fabric Assistente de Migração proporciona uma experiência orientada 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 ficheiro DACPAC
• Teradata utilizando um ficheiro .zip que contenha ficheiros .sql e/ou .bteq

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 cria um novo armazém para si.
• Um ficheiro de metadados de origem num destes formatos:
  • Um ficheiro DACPAC extraído do Azure Synapse Analytics ou SQL Server. Um DACPAC contém metadados para objetos da base de dados, incluindo tabelas, vistas, procedimentos armazenados e funções.
    • Para criar um DACPAC a partir do Azure Synapse Analytics, consulte Extrair uma Aplicação Data-tier (DAC) de um pool SQL dedicado Azure Synapse no Visual Studio 2022.
    • Também pode usar o Assistente de Geração de Scripts no SQL Server Management Studio (SSMS), projetos de base de dados ao estilo SDK com Visual Studio Code, ou a utilidade de linha de comandos SqlPaquet.
  • Um arquivo ZIP de ficheiros Teradata .sql e/ou .bteq que contém as definições dos objetos e as dependências para a migração.

Para usar as funcionalidades de migração assistida por IA do Assistente de Migração para resolver problemas de migração, precisa de ativar o Copilot:

• O seu administrador precisa ativar a mudança de inquilino antes de começar a usar o Copilot. Para obter mais informações, consulte Definições de inquilino do Copilot.
• A sua capacidade F2 ou P1 precisa estar numa das regiões listadas em disponibilidade regional do Fabric.
• Se o seu tenant ou capacidade estiver fora dos EUA ou de França, o Copilot está desativado por predefinição, a menos que o administrador do tenant do Fabric ative a definição de tenant Os dados enviados para o Azure OpenAI podem ser processados fora da região geográfica, do limite de conformidade ou da instância de cloud nacional da sua capacidade em Catálogo do OneLake>Governação>Configurações>Definições de tenant.
• 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 Migrar para o código-fonte do Fabric, em Migrar para um armazém, selecione o bloco do sistema de origem:

   • Para Azure Synapse Analytics, selecione Azure Synapse Analytics dedicated SQL pool.
   • Para SQL Server, Base de Dados SQL do Azure ou Azure SQL Managed Instance, selecione SQL Server database.
   • Para Teradata, selecione Teradata (Pré-visualização).

   

3. Se aparecer a página Escolher o seu método , selecione Carregar um ficheiro com os metadados de origem e depois selecione Próximo.

   

4. Em Definir a fonte, selecione Escolher ficheiro, selecione o ficheiro fonte e depois selecione Próximo.

   

5. Na página Definir o destino, indique o nome do espaço de trabalho Fabric e o novo item do armazém para onde quer migrar. Selecione Avançar.

6. Revise os seus dados e selecione Migrar. O Assistente de Migração cria um novo item de armazém e inicia a migração dos metadados.

   Note

   Ao usar o Assistente de Migração, o novo armazém tem a classificação insensível a maiúsculas minúsculas, independentemente da definição padrão de classificação do armazém.

   

   Durante esta etapa, o Assistente de Migração traduz metadados T-SQL para sintaxe T-SQL suportada no Fabric Data Warehouse. Após a conclusão da migração dos metadados, o Assistente de Migração abre-se. Pode aceder ao Assistente de Migração a qualquer momento usando o botão de Migração no separador Início da barra de ferramentas do armazém.

7. Analise o resumo de migração de metadados no Assistente de Migração. Vê-se a contagem de objetos migrados e os objetos que precisam de ser corrigidos antes de poderem 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 veja uma lista de objetos que migrou com sucesso 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 Estado indica se o Assistente de Migração ajustou os metadados do objeto durante a tradução para o Fabric Data 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 a informação sobre os ajustes que o Assistente de Migração 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 na visualização em tela cheia para melhor legibilidade. Aplique filtros para exibir tipos de objeto específicos.

    

Resolver problemas usando o Assistente de Migração

Alguns metadados de objeto de banco de dados podem falhar na migração. Frequentemente, esta falha ocorre porque o Assistente de Migração não conseguiu traduzir os metadados do T-SQL para os suportados em 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 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. Revê e corrige os scripts avariados usando a informação 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 para 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 de voltar no painel Resolver problemas para devolver a vista de topo do Assistente de Migração. Verifica 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. Pode usar uma tarefa de cópia do Fabric Data Factory para fazê-lo manualmente, ou siga estes passos 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 Utilizar uma tarefa 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 ligação do seu sistema de origem. Selecione Avançar.

5. Na página Escolher dados , selecione as tabelas que quer migrar. Selecione Avançar.

   

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

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

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 Avançar.

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

10. Quando o trabalho de cópia terminar, verifique a 3. etapa Copiar dados no Assistente de Migração. Selecione o botão de voltar no topo para voltar à vista superior do Assistente de Migração.

Redirecionar conexões

No passo final, religue as plataformas de carregamento e reporte de dados para que as suas ligações apontem para o seu novo armazém Fabric.

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

   • Numa instância do SQL Server, pode usar vistas de gestão dinâmica, 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, pode encontrar informações de sessão, incluindo a aplicação de origem, o utilizador conectado, a origem da ligação e o 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 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:
     1. 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.
     2. Atualize as ligações ao novo armazém usando a página Gerir Ligações e Gateways nas Definições.

5. Quando terminar, verifique a etapa de Redirecionar ligações no Assistente de Migração.

Parabéns! Agora está pronto para começar a usar o seu novo 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