Compartilhar via

Migrar para um banco de dados SQL no Fabric usando o Assistente de Migração com DACPAC

Aplica-se a: ✅banco de dados SQL no Microsoft Fabric

O Fabric Assistente de Migração pode importar metadados de esquema de um arquivo DACPAC e orientá-lo na cópia de dados para o banco de dados SQL de destino no Fabric.

Importante

Esse recurso está na versão prévia.

Pré-requisitos

Antes de começar, verifique se os pré-requisitos a seguir são atendidos.

Pré-requisitos de Fabric

  • Você precisa de um espaço de trabalho do Microsoft Fabric com capacidade ativa.
  • Para que haja comunicação entre sua instância de SQL Server de origem e o Microsoft Fabric, você precisa instalar um gateway de dados local.
    • Para obter mais informações, consulte Acessar fontes de dados locais no Data Factory para Microsoft Fabric.
    • Registre o gateway de dados em um computador geograficamente mais próximo do banco de dados de origem.
    • Verifique se o gateway está disponível no portal Fabric navegando até Settings>Gerenciar conexões e gateways>Gateways de dados locais.
    • Confirme se o gateway recém-registrado aparece na lista e está em um estado pronto antes de iniciar a migração de dados.
  • Uma conexão SQL Fabric criada e habilitada para uso do gateway. As operações de cópia de migração são executadas por meio de um runtime de gateway. Se o uso do gateway não estiver habilitado na conexão SQL Fabric, as operações de cópia de dados falharão.

Pré-requisitos do banco de dados de origem

Criar um banco de dados SQL na conexão do Fabric

Depois de registrar um gateway de dados local, crie uma conexão SQL Fabric e habilite-a para uso do gateway.

Screenshot do banco de dados SQL na conexão Fabric na fábrica de dados.

Steps

  1. No portal Microsoft Fabric, selecione Settings. 1. Selecione Gerenciar conexões e gateways e selecione Novo.
  2. No painel Nova Conexão , escolha Nuvem.
  3. Insira um nome de conexão.
  4. Selecione o banco de dados SQL em Fabric como o tipo de conexão.
  5. Configure autenticação, como OAuth 2.0.
  6. Nas configurações de conexão, selecione Permitir que essa conexão seja utilizada com gateways de dados locais ou gateways de dados da VNet. Essa configuração é necessária porque as operações de cópia de migração são executadas por meio de um runtime de gateway. Se você não habilitar a conexão SQL Fabric para uso de gateway, as operações de cópia de dados falharão.
  7. Selecione Criar para criar a conexão.

Iniciar o Assistente de Migração

Depois de configurar o gateway de dados local e criar a conexão SQL Fabric, você estará pronto para iniciar o Assistente de Migração.

Captura de tela mostrando o SQL Server (versão prévia) como a fonte de migração.

  1. No portal Fabric, vá para o seu espaço de trabalho. Na barra de ferramentas, selecione Migrate para iniciar o Assistente de Migração.
  2. No painel Migrate to Fabric, em Migrate to a database, selecione SQL Server (Preview).
  3. Na página Visão geral , examine o que esperar ao migrar informações e selecioneAvançar.

Etapa 1: Copiar esquema

Na página Selecione a página de origem, carregue o arquivo DACPAC do ambiente de SQL Server de origem.

Captura de tela mostrando como carregar um arquivo DACPAC.

Quando esta etapa for concluída:

  • Uma sessão de migração é criada.
  • A análise de esquema começa automaticamente.

Etapa 2: corrigir erros de script

O Assistente de Migração analisa os objetos de esquema no DACPAC e os categoriza com base na compatibilidade com o banco de dados SQL em Fabric.

Captura de tela de um exemplo de resultados de análise de migração.

Agora você tem uma visão clara do que pode migrar sem alterações e do que requer atenção. Você deve resolver objetos primários antes que os objetos dependentes possam ser migrados. Para objetos de banco de dados que falham na migração de esquema inicial:

  1. Exibir objetos migrados e falhados. Examine as correções sugeridas no assistente.
  2. Examine os motivos de incompatibilidade. Aplique alterações com suporte a objetos incompatíveis.
  3. Revalidar objetos depois de aplicar correções.

Por exemplo, você pode ver incompatibilidades de sintaxe identificadas e o botão Corrigir erros de consulta para fornecer uma solução alternativa ou correção de script T-SQL.

Captura de tela das propriedades de incompatibilidade de esquema.

Etapa 3: Preparar para cópia de arquivos

A etapa Preparar para cópia prepara o esquema de banco de dados no novo banco de dados SQL. O esquema está pronto para a movimentação de dados no processo de cópia do Fabric. Esta etapa reduz falhas de cópia e melhora o desempenho durante a migração de dados.

  1. Copie o script de preparação gerado.
  2. Execute o script no Editor de Consultas no banco de dados SQL de destino.

Etapa 4: Copiar dados

  1. Selecione 4. Copie dados em Assistente de Migração.

  2. Escolha Usar uma tarefa de cópia. Nomeie o trabalho e selecione Criar para abrir o assistente de Trabalho de Cópia.

  3. Configuração de origem:

    Em Escolher fonte de dados, conclua as informações a seguir.

    1. Escolha SQL Server banco de dados como o tipo de origem.
    2. Selecione ou crie a conexão de origem.
    3. Insira a instância SQL Server e os detalhes do banco de dados.
    4. Selecione o gateway de dados local usado para se conectar à instância de SQL Server de origem.
    5. Selecione a autenticação. Use a opção de Conta da Organização.
    6. Se a criptografia não estiver habilitada na instância de SQL Server de origem, desabilite a criptografia nas configurações.
    7. Selecione Próximo.

  4. Selecione tabelas:

    1. Em Escolher dados, selecione as tabelas a serem migradas.
    2. Confirme se o esquema de destino já existe (na migração de esquema) e selecione Avançar.

  5. Revisão + execução:

    1. Examine os mapeamentos de coluna.
    2. Selecione o modo Copiar.
    3. Examine o resumo.
    4. Selecione Salvar e Executar.

  6. Monitorar:

    Para monitorar o progresso do Trabalho de Cópia, verifique os seguintes valores:

    • Linhas lidas e escritas
    • Status por tabela
    • Erros de migração, se houver

    Resolva falhas e execute novamente as tabelas conforme necessário.

  7. Depois que o trabalho de cópia for concluído com êxito, retorne ao Assistente de Migração e marque a etapa de cópia de dados concluída.

Etapa 5: Finalizar cópia

A etapa 5. Finalizar Cópia conclui a migração de dados e permite que os itens restantes, como restrições, gatilhos e índices, sejam implementados para trazer o banco de dados ao estado desejado.

Copie a consulta da janela Finalizar Cópia e execute-a no editor de consultas.

No final desta etapa, a experiência de migração guiada está concluída.

Considerações pós-migração

Depois de concluir a migração:

  • Validar consultas de aplicativo e cargas de trabalho.
  • Atualize as cadeias de conexão do aplicativo.
  • Reveja o desempenho e a compatibilidade com o banco de dados SQL nas funcionalidades do Fabric.

Conteúdo relacionado

  • Last updated on