Migra caricando un file con il Fabric Migration Assistant

si applica a:✅ Magazzino di dati in Microsoft Fabric

Il Fabric Migration Assistant offre un'esperienza guidata per migrare i metadati e i dati sorgente verso Fabric Data Warehouse. Questa guida spiega come migrare i metadati da:

• Azure Synapse Analytics o SQL Server utilizzando un file DACPAC
• Teradata utilizzando un archivio .zip di file .sql e/o .bteq

Suggerimento

Per la pianificazione specifica per fonte, vedi:

• Pianificare la migrazione da Azure Synapse Analytics
• Pianifica la migrazione da SQL Server
• Pianificare la migrazione da Teradata

Prerequisiti

Prima di iniziare, assicurarsi di disporre di quanto segue:

• Un'area di lavoro Fabric con capacità attive o capacità di prova.
• Creare un'area di lavoro o selezionare un'area di lavoro esistente in cui eseguire la migrazione. Migration Assistant crea automaticamente un nuovo warehouse.
• Un file di metadati sorgente in uno di questi formati:
  • Un file DACPAC estratto da Azure Synapse Analytics o SQL Server. Un DACPAC contiene metadati degli oggetti di database, tra cui tabelle, viste, procedure archiviate e funzioni.
    • Per creare un DACPAC da Azure Synapse Analytics, vedi Estrazione di un'applicazione Data-tier (DAC) da un pool SQL dedicato Azure Synapse in Visual Studio 2022.
    • Puoi anche utilizzare la Generator Scripts Wizard in SQL Server Management Studio (SSMS),progetti database in stile SDK con Visual Studio Code, o l'utilità a riga di comando SqlPacy.
  • Un archivio zip di Teradata .sql e/o .bteq file che contiene le definizioni degli oggetti e le dipendenze per la migrazione.

Per usare le funzionalità di migrazione assistita dall'intelligenza artificiale di Migration Assistant per risolvere i problemi di migrazione, è necessario attivare Copilot:

• L'amministratore deve abilitare l'opzione del tenant prima di iniziare a usare Copilot. Per altre informazioni, vedere Impostazioni del tenant di Copilot.
• La capacità F2 o P1 deve trovarsi in una delle regioni elencate nella disponibilità delle regioni Fabric.
• Se il tuo tenant o la tua capacità si trova al di fuori degli Stati Uniti o della Francia, Copilot è disabilitato per impostazione predefinita, a meno che l'amministratore del tenant di Fabric non abiliti l'impostazione tenant I dati inviati ad Azure OpenAI possono essere elaborati al di fuori dell'area geografica, del confine di conformità o dell'istanza cloud nazionale della capacità in catalogo di OneLake>Govern>Configurations>Impostazioni tenant.
• Copilot in Microsoft Fabric non è supportato negli SKU di valutazione. Attualmente sono supportati solo gli SKU a pagamento (F2 o superiore o P1 o versione successiva).
• Per altre informazioni, vedere Informazioni generali di Copilot in Fabric e Power BI.

Copia metadata

1. Nell'area di lavoro Fabric, selezionare il pulsante Migra nella barra delle azioni dell'elemento.

   

2. Nel menu di origine Migrate to Fabric, in Migrate to a warehouse, seleziona il riquadro del sistema di origine:

   • Per Azure Synapse Analytics, seleziona Azure Synapse Analytics dedicated SQL pool.
   • Per SQL Server, database SQL di Azure o Istanza gestita di SQL di Azure, seleziona database SQL Server.
   • Per Teradata, seleziona Teradata (Anteprima).

   

3. Se compare la pagina Scegli il tuo metodo , seleziona Carica un file con i metadati di origine, e poi seleziona Avanti.

   

4. Su Imposta la sorgente, seleziona Scegli file, seleziona il file sorgente e poi seleziona Avanti.

   

5. Nella pagina Imposta la destinazione, indica il nome dello spazio di lavoro Fabric e il nuovo elemento warehouse in cui vuoi migrare. Seleziona Avanti.

6. Verifica gli input e seleziona Migra. Migration Assistant crea un nuovo elemento del warehouse e avvia la migrazione dei metadati.

   Note

   Quando si usa Migration Assistant, il nuovo warehouse presenta regole di confronto senza distinzione tra maiuscole e minuscole, indipendentemente dall'impostazione predefinita delle regole di confronto del warehouse.

   

   Durante questo passaggio, Migration Assistant converte i metadati T-SQL nella sintassi T-SQL supportata in Fabric Data Warehouse. Al termine della migrazione dei metadati, Viene aperto Migration Assistant. È possibile accedere a Migration Assistant in qualsiasi momento usando il pulsante Migrazione nella scheda Home della barra multifunzione del magazzino.

7. Controllare il riepilogo della migrazione dei metadati nell'assistente alla migrazione. Viene visualizzato il numero di oggetti migrati e gli oggetti che devono essere corretti prima di poter essere migrati.

   

8. Selezionare Mostra oggetti migrati per espandere la sezione e visualizzare un elenco di oggetti di cui è stata eseguita correttamente la migrazione al warehouse di Fabric.

   

   La colonna State indica se Migration Assistant ha modificato i metadati dell'oggetto durante la conversione in Fabric Data Warehouse. Ad esempio, si può notare che alcuni tipi di dati di colonna o costrutti del linguaggio T-SQL vengono convertiti automaticamente in quelli supportati da Fabric. La colonna Dettagli mostra le informazioni sulle modifiche che l'Migration Assistant ha apportato agli oggetti.

9. Selezionare un oggetto per visualizzare le modifiche apportate da Migration Assistant durante la migrazione.

10. Aprire il riepilogo della migrazione dei metadati nella visualizzazione a schermo intero per migliorare la leggibilità. Applicare filtri per visualizzare tipi di oggetto specifici.

    

Risolvere i problemi tramite Migration Assistant

Potrebbe non essere possibile eseguire la migrazione di alcuni metadati dell'oggetto di database. Comunemente, questo guasto si verifica perché il Migration Assistant non è riuscito a tradurre i metadati T-SQL in quelli supportati in Fabric Data Warehouse o il codice tradotto non si è applicato a T-SQL.

Correggiamo questi script con l'aiuto di Migration Assistant.

1. Selezionare il passaggio Risolvere i problemi in Migration Assistant per visualizzare gli script di cui non è stata eseguita la migrazione.

   

2. Selezionare un oggetto del database di cui la migrazione non è riuscita. Si apre una nuova query sotto Query condivise in Explorer. Questa nuova query mostra la definizione dei metadati e le modifiche apportate come commenti automatici aggiunti al codice T-SQL.

3. Verificare i commenti all'inizio dello script per visualizzare le modifiche apportate allo script.

4. Esaminare e correggere gli script interrotti usando le informazioni e la documentazione sugli errori.

5. Per usare Copilot e ottenere assistenza basata sull'intelligenza artificiale per correggere gli errori, selezionare Correggi errori di query nella sezione "Azione suggerita. Copilot aggiorna lo script con suggerimenti. Dato che Copilot usa l'intelligenza artificiale, è possibile che si verifichino errori, quindi verificare i suggerimenti del codice e apportare le modifiche necessarie.

   

6. Selezionare Esegui per convalidare e creare l'oggetto.

7. Verrà aperto lo script successivo da correggere.

8. Continuare a correggere il resto degli script. È possibile scegliere di ignorare la correzione degli script non necessari durante questo passaggio.

9. Quando tutti i metadati desiderati sono pronti per la migrazione, selezionare il pulsante Indietro nel riquadro Correggi problemi per restituire la visualizzazione di primo livello di Migration Assistant. Controllare il 2. Risolvere i problemi nell'Assistente Migrazione.

Copiare dati con Migration Assistant

La copia dati consente di eseguire la migrazione dei dati usati dagli oggetti di cui si esegue la migrazione. È possibile usare un processo di copia di Data Factory di Fabric per eseguire questa operazione manualmente oppure seguire questa procedura per l'integrazione del processo di copia in Migration Assistant.

1. Selezionare il passaggio Copia dati in Migration Assistant.

2. Seleziona Usa un lavoro di copia.

3. Assegnare un nome al nuovo processo e quindi selezionare Crea.

4. Nella pagina Collegati alla sorgente dei dati , fornisci le credenziali di connessione per il tuo sistema sorgente. Seleziona Avanti.

5. Nella pagina Scegli dati , seleziona le tabelle che vuoi migrare. Seleziona Avanti.

   

6. Nella pagina Scegliere la destinazione dati scegliere il nuovo elemento warehouse di Fabric dal catalogo di OneLake. Seleziona Avanti.

7. Nella pagina Mappa alla destinazione, configurare il mapping delle colonne per ogni tabella. Seleziona Avanti.

8. Nella pagina Modalità processo di copia scegliere la modalità di copia. Scegliere una copia completa dei dati monouso (consigliata per la migrazione) o una copia incrementale continua. Seleziona Avanti.

9. Verifica il riepilogo del lavoro. Selezionare Salva + Esegui.

10. Al termine del processo di copia, controllare il passaggio 3. Copia dei dati in Migration Assistant. Selezionare il pulsante Indietro nella parte superiore per tornare alla visualizzazione di primo livello di Migration Assistant.

Reindirizzare le connessioni

Nel passaggio finale riconnettere le piattaforme di caricamento e creazione di report dei dati in modo che le connessioni puntino al nuovo warehouse di Fabric.

1. Identifica le connessioni nel magazzino di origine esistente.

   • In un'istanza di SQL Server è possibile usare le viste a gestione dinamica, ad esempio:

   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
   

   • Nei pool SQL dedicati di Azure Synapse Analytics, puoi trovare informazioni sulle sessioni, inclusi l'applicazione di origine, l'utente connesso, l'origine della connessione e il metodo di autenticazione:

   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. Aggiorna le connessioni alle piattaforme di creazione di report in modo che puntino al magazzino di Fabric.

3. Testare il magazzino di Fabric con alcuni report prima di effettuare il reindirizzamento. Eseguire test di confronto e convalida dei dati nelle piattaforme di creazione di report.

4. Aggiornare le connessioni per le piattaforme di caricamento dei dati (ETL/ELT) in modo che puntino al warehouse di Fabric.

   • Per le pipeline di Power BI/Fabric:
     1. Utilizzare l'API REST "Elenca Connessioni" per individuare le connessioni alla vecchia origine dati, il pool SQL dedicato di Azure Synapse Analytics.
     2. Aggiornare le connessioni al nuovo magazzino utilizzando la pagina Gestisci connessioni e gateway in Impostazioni.

5. Al termine, controllare il passaggio Connessioni di reindirizzamento nel Migration Assistant.

Congratulazioni! A questo punto è possibile iniziare a usare il nuovo magazzino.

Contenuti correlati

• Assistente di Migrazione di Fabric per Data Warehouse
• Panoramica della migrazione di Microsoft Fabric