Eseguire la migrazione al database SQL in Fabric con il Migration Assistant usando DACPAC

Applicabile a: ✅ in Microsoft Fabric

Il Fabric Migration Assistant può importare i metadati dello schema da un file DACPAC e illustra come copiare i dati nel database SQL di destinazione in Fabric.

Importante

Questa funzionalità si trova in Anteprima.

Prerequisiti

Prima di iniziare, assicurarsi che siano soddisfatti i prerequisiti seguenti.

  • È necessario a area di lavoro Microsoft Fabric con capacità attiva.
  • Per la comunicazione tra l'istanza di origine di SQL Server e Microsoft Fabric, è necessario installare un gateway dati locale.
    • Per ulteriori informazioni, vedere Accesso alle origini dati locali in Data Factory per Microsoft Fabric.
    • Registrare il gateway dati su una macchina che è geograficamente più vicina al database di origine.
    • Verificare che il gateway sia disponibile nel portale di Fabric passando a Settings>Gestisci connessioni e gateway>Gateway dati on-premises.
    • Verificare che il gateway appena registrato venga visualizzato nell'elenco e che sia pronto prima di avviare la migrazione dei dati.
  • Una connessione SQL Fabric creata e abilitata per l'utilizzo del gateway. Le operazioni di copia della migrazione vengono eseguite tramite un runtime del gateway. Se l'uso del gateway non è abilitato sulla connessione Fabric SQL, le operazioni di copia dati falliscono.
  • File DACPAC generato dal database SQL Server di origine. Per informazioni su come generare un file .dacpac, vedere Extract a DACPAC from a database.

Creare un database SQL nella connessione Fabric

Dopo aver registrato un gateway dati locale, creare una connessione SQL Fabric e abilitarla per l'utilizzo del gateway.

Screenshot del database SQL nella connessione Fabric in Data Factory.

  1. Nel portale di Microsoft Fabric selezionare Impostazioni. 1. Selezionare Gestisci connessioni e gateway e quindi selezionare Nuovo.
  2. Nel riquadro Nuova connessione scegliere Cloud.
  3. Immettere un nome di connessione.
  4. Selezionare SQL database in Fabric come tipo di connessione.
  5. Configurare l'autenticazione, ad esempio OAuth 2.0.
  6. Nelle impostazioni di connessione selezionare Consenti l'uso di questa connessione con gateway dati locali o gateway dati di rete virtuale. Questa impostazione è necessaria perché le operazioni di copia della migrazione vengono eseguite tramite un runtime del gateway. Se non si abilita la connessione SQL Fabric per l'utilizzo del gateway, le operazioni di copia dei dati hanno esito negativo.
  7. Seleziona Crea per creare la connessione.

Avviare il Migration Assistant

Dopo aver configurato il gateway dati locale e aver creato la connessione SQL Fabric, si è pronti per avviare il Migration Assistant.

Screenshot che mostra SQL Server (Anteprima) come origine.

  1. Nel portale di Fabric passare all'area di lavoro. Sulla barra degli strumenti selezionare Migrate per avviare il Migration Assistant.
  2. Nel riquadro Migrate in Fabric, in Migrate in un database selezionare SQL Server (anteprima).
  3. Nella pagina Panoramica esaminare cosa aspettarsi quando si esegue la migrazione delle informazioni e selezionare Avanti.

Passaggio 1: Copiare lo schema

Su Seleziona la sorgente, carica il file DACPAC dall'ambiente SQL Server sorgente.

Screenshot che mostra come caricare un file DACPAC.

Quando questo passaggio termina:

  • Viene creata una sessione di migrazione.
  • L'analisi dello schema inizia automaticamente.

Passo 2: Valida lo schema (opzionale)

  1. Seleziona la sorgente, dopo aver caricato il file DACPAC, seleziona Valida per verificare la compatibilità DACPAC con Fabric SQL Database prima di configurare una destinazione.

    Screenshot che mostra i risultati dopo aver eseguito la funzione Valida.

  2. Consulta il Sommario di Validazione degli Oggetti per identificare gli oggetti che si prevede migreranno, richiedono aggiornamenti o non dovrebbero migrare.

  3. Risolvi i problemi di compatibilità prima di procedere con la migrazione.

Passo 3: Correggere gli errori di script

Il Migration Assistant analizza gli oggetti dello schema nel file DACPAC e li classifica in base alla compatibilità con il database SQL in Fabric.

Ora hai un quadro chiaro di ciò che puoi migrare così com'è e di ciò che richiede attenzione. È necessario risolvere gli oggetti primari prima che gli oggetti dipendenti possano essere migrati. Per gli oggetti di database che non superano la migrazione iniziale dello schema:

  1. Visualizza gli oggetti migrati e non riusciti nella migrazione. Esaminare le correzioni suggerite nell'assistente virtuale.
  2. Esaminare i motivi di incompatibilità. Applicare le modifiche supportate agli oggetti incompatibili.
  3. Riconvalidare gli oggetti dopo l'applicazione delle correzioni.

Ad esempio, potrebbero essere presenti incompatibilità di sintassi identificate e il pulsante Correggi errori di query per fornire una correzione o una soluzione alternativa per lo script T-SQL.

Screenshot delle proprietà di incompatibilità dello schema.

Passo 4: Prepararsi per la copia

Il passaggio Prepara per la copia prepara lo schema del database nel nuovo database SQL. Lo schema è pronto per lo spostamento dei dati nel Fabric Copy Job. Questo passaggio riduce gli errori di copia e migliora le prestazioni durante la migrazione dei dati.

  1. Copiare lo script di preparazione generato.
  2. Eseguire lo script nel Editor di query sul database SQL di destinazione.

Passo 5: Copia i dati

  1. Seleziona 5. Copia i dati in Migration Assistant.

  2. Scegliere Usare un lavoro di copia. Dare un nome all'attività e quindi selezionare Crea per aprire la procedura guidata per la copia del processo.

  3. Configurazione origine:

    In Choose data source (Scegli origine dati) completare le informazioni seguenti.

    1. Scegliere SQL Server database come tipo di origine.
    2. Selezionare o creare la connessione di origine.
    3. Immettere i dettagli dell'istanza e del database di SQL Server.
    4. Selezionare il gateway dati locale utilizzato per connettersi all'istanza del Server SQL di origine.
    5. Selezionare Autenticazione. Usare l'opzione Account dell'organizzazione.
    6. Se la crittografia non è abilitata nell'istanza di SQL Server di origine, disabilitare la crittografia nelle impostazioni.
    7. Seleziona Avanti.

  4. Selezionare le tabelle:

    1. In Scegli dati selezionare le tabelle di cui eseguire la migrazione.
    2. Verificare che lo schema di destinazione esista già (dalla migrazione dello schema) e selezionare Avanti.

  5. Rivedi ed esegui:

    1. Esaminare le mappature delle colonne.
    2. Selezionare Modalità copia.
    3. Esaminare il riepilogo.
    4. Selezionare Salva + Esegui.

  6. Monitoraggio:

    Per monitorare lo stato di avanzamento del processo di copia, controllare i valori seguenti:

    • Righe lette e scritte
    • Stato per tabella
    • Errori di migrazione, se presenti

    Risolvere gli errori ed eseguire nuovamente le tabelle in base alle esigenze.

  7. Al termine del processo di copia, tornare al Migration Assistant e contrassegnare il passaggio copia dati completato.

Passo 6: Finalizza la copia

Il 6. Il passaggio Finalize Copy completa la migrazione dei dati e abilita gli elementi rimanenti come vincoli, trigger e indici, per portare il database allo stato desiderato.

Copiare la query dalla finestra Finalize Copy ed eseguirla nell'editor di query.

Al termine di questo passaggio, l'esperienza di migrazione guidata è completa.

Considerazioni successive alla migrazione

Dopo aver completato la migrazione:

  • Convalida le query e i carichi di lavoro dell'applicazione.
  • Aggiornare le stringhe di connessione dell'applicazione.
  • Esaminare le prestazioni e la compatibilità con il database SQL nelle funzionalità di Fabric.

Contenuti correlati

  • Last updated on