Migruj, przesyłając plik do Fabric Asystent migracji

Dotyczy:✅ Magazyn w systemie Microsoft Fabric

Fabric Asystent migracji zapewnia przewodnik do migracji metadanych i danych źródłowych do Fabric Data Warehouse. Ten przewodnik wyjaśnia, jak przenieść metadane z:

  • Azure Synapse Analytics lub SQL Server poprzez wykorzystanie pliku DACPAC
  • Teradata za pomocą archiwum .zip plików .sql i/lub .bteq

Wskazówka

Informacje na temat planowania dla konkretnego źródła można znaleźć tutaj:

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz następujące elementy gotowe:

Aby użyć funkcji migracji wspomaganej przez sztuczną inteligencję narzędzia Asystent migracji w celu rozwiązania problemów z migracją, należy aktywować rozwiązanie Copilot:

Kopiowanie metadanych

  1. W obszarze roboczym Fabric wybierz przycisk Migruj na panelu akcji dla elementu.

    Zrzut ekranu z portalu Fabric przycisku

  2. W menu źródłowym Migruj do Fabric, w sekcji Migracja do magazynu, wybierz kafelek systemu źródłowego:

    • W przypadku usługi Azure Synapse Analytics wybierz dedykowaną pulę SQL usługi Azure Synapse Analytics.
    • Dla SQL Server, Azure SQL Database lub Azure SQL Managed Instance wybierz bazę SQL Server.
    • Dla Teradata wybierz Teradata (Podgląd).

    Zrzut ekranu z portalu Fabric przedstawiający kafelki systemu źródłowego.

  3. Jeśli pojawi się strona Wybierz swoją metodę , wybierz Upload pliku z metadanymi źródłowymi, a następnie wybierz Następny.

    Zrzut ekranu z portalu Fabric, pokazujący, jak przesłać plik do migracji.

  4. W opcji Ustaw źródło wybierz Wybierz plik, wybierz plik źródłowy, a następnie wybierz Następny.

    Zrzut ekranu z portalu Fabric z kroku przesyłania pliku metadanych źródłowych w Asystent migracji.

  5. Na stronie Ustaw miejsce docelowe podaj nazwę przestrzeni roboczej Fabric oraz nowy element magazynowy, do którego chcesz się przenieść. Wybierz Dalej.

  6. Przejrzyj swoje dane wejściowe i wybierz opcję Migrate. Narzędzie Asystent migracji tworzy nowy element magazynu i uruchamia migrację metadanych.

    Note

    W przypadku korzystania z programu Asystent migracji nowy magazyn ma sortowanie bez uwzględniania wielkości liter, niezależnie od domyślnego ustawienia sortowania magazynu.

    Zrzut ekranu z portalu Fabric na stronie Przegląd w aplikacji Asystent migracji. Źródło to plik DACPAC, a celem jest nowa pozycja magazynowa o nazwie AdventureWorks.

    W tym kroku narzędzie Asystent migracji tłumaczy metadane języka T-SQL na obsługiwaną składnię języka T-SQL w usłudze Fabric Data Warehouse. Po zakończeniu migracji metadanych zostanie otwarty program Asystent migracji. Program Asystent migracji można uzyskać w dowolnym momencie za pomocą przycisku Migracja na karcie Narzędzia główne na wstążce magazynu.

  7. Przejrzyj podsumowanie migracji metadanych w programie Asystent migracji. Zobaczysz liczbę migrowanych obiektów i obiektów, które należy naprawić, zanim będą mogły zostać zmigrowane.

    Zrzut ekranu z portalu Fabric przedstawiający podsumowanie migracji metadanych w programie Asystent migracji. Opcja Pokaż zmigrowane obiekty jest wyróżniona.

  8. Wybierz Pokaż zmigrowane obiekty, aby rozwinąć sekcję i wyświetlić listę obiektów, które zostały pomyślnie zmigrowane do magazynu Fabric.

    Zrzut ekranu z portalu Fabric przedstawiający podsumowanie migracji metadanych przez Asystent migracji oraz listę migrowanych obiektów.

    Kolumna State wskazuje, czy narzędzie Asystent migracji skorygowało metadane obiektu podczas tłumaczenia do Fabric Data Warehouse. Na przykład można zobaczyć, że niektóre typy danych kolumn lub konstrukcje języka T-SQL są automatycznie konwertowane na te, które są obsługiwane w usłudze Fabric. Kolumna Szczegóły pokazuje informacje o poprawkach, które Asystent migracji wprowadził do obiektów.

  9. Wybierz dowolny obiekt, aby wyświetlić korekty wprowadzone przez narzędzie Asystent migracji podczas migracji.

  10. Otwórz podsumowanie migracji metadanych w widoku pełnoekranowym, aby uzyskać lepszą czytelność. Zastosuj filtry, aby wyświetlić określone typy obiektów.

    Zrzut ekranu przedstawiający widok pełnoekranowy podsumowania migracji metadanych programu Asystent migracji migrowanych obiektów.

Rozwiązywanie problemów przy użyciu narzędzia Asystent migracji

Migracja niektórych metadanych obiektu bazy danych może zakończyć się niepowodzeniem. Często do tej porażki dochodzi dlatego, że Asystent migracji nie potrafił przetłumaczyć metadanych T-SQL na te obsługiwane w Fabric Data Warehouse lub przetłumaczony kod nie zastosował się do T-SQL.

Naprawmy te skrypty za pomocą asystenta migracji.

  1. Wybierz na kroku Rozwiązywanie problemów w narzędziu Asystent migracji, aby wyświetlić skrypty, które nie udało się przenieść.

    zrzut ekranu z portalu Fabric, lista Napraw problemy w programie Asystent migracji.

  2. Wybierz obiekt bazy danych, którego migracja nie powiodła się. Nowe zapytanie otwiera się w obszarze Udostępnione zapytania w Eksploratorze . To nowe zapytanie pokazuje definicję metadanych i dostosowania wprowadzone w niej jako automatyczne komentarze dodane do kodu T-SQL.

  3. Przejrzyj komentarze na początku skryptu, aby zobaczyć zmiany wprowadzone w skrycie.

  4. Przejrzyj i napraw uszkodzone skrypty, korzystając z informacji o błędach i dokumentacji.

  5. Aby użyć narzędzia Copilot do pomocy opartej na sztucznej inteligencji w naprawianiu błędów, wybierz pozycję Napraw błędy zapytań w sekcji Sugerowana akcja. Copilot aktualizuje skrypt z sugestiami. Błędy mogą wystąpić, gdy copilot używa sztucznej inteligencji, więc zweryfikuj sugestie dotyczące kodu i wprowadź potrzebne zmiany.

    Zrzut ekranu z portalu Fabric edytora zapytań przedstawiający zapytania T-SQL, które nie udało się zmigrować, oraz komentarze i poprawki sugerowane przez Copilot.

  6. Wybierz pozycję Uruchom, aby zweryfikować i utworzyć obiekt.

  7. Otwiera się następny skrypt do naprawy.

  8. Kontynuuj naprawianie pozostałych skryptów. Możesz pominąć naprawianie skryptów, których nie potrzebujesz w tym kroku.

  9. Gdy wszystkie żądane metadane są gotowe do migracji, wybierz przycisk Wstecz w okienku Rozwiązywanie problemów , aby zwrócić widok najwyższego poziomu narzędzia Asystent migracji. Sprawdź krok 2. Rozwiązywanie problemów w narzędziu Asystent migracji.

Kopiowanie danych przy użyciu narzędzia Asystent migracji

Kopiowanie danych ułatwia migrowanie danych używanych przez migrowane obiekty. Aby wykonać to ręcznie, możesz użyć zadania kopiowania Fabric Data Factory, lub możesz wykonać następujące kroki, aby zintegrować zadanie kopiowania w narzędziu Asystent migracji.

  1. Wybierz krok kopiowania danych w narzędziu Asystent migracji.

  2. Wybierz Użyj zadania kopiowania.

  3. Przypisz nazwę do nowego zadania, a następnie wybierz pozycję Utwórz.

  4. Na stronie Connect to data source podaj dane poświadczenia połączeń dla systemu źródłowego. Wybierz Dalej.

  5. Na stronie Wybierz dane wybierz tabele, które chcesz przenieść. Wybierz Dalej.

    Zrzut ekranu z portalu Fabric, okienko Wybór danych, z wybranymi tabelami.

  6. Na stronie Wybierz miejsce docelowe danych wybierz nowy element magazynu usługi Fabric z katalogu usługi OneLake. Wybierz Dalej.

  7. Na stronie Mapa do miejsca docelowego skonfiguruj mapowania kolumn dla każdej tabeli. Wybierz Dalej.

  8. Na stronie Tryb zadania kopiowania wybierz tryb kopiowania. Wybierz jednorazową kopię danych (zalecaną do migracji) lub ciągłe kopiowanie przyrostowe. Wybierz Dalej.

  9. Przejrzyj podsumowanie zadania. Wybierz pozycję Zapisz i uruchom.

  10. Po zakończeniu zadania kopiowania sprawdź krok 3. Kopiowanie danych w narzędziu Asystent migracji. Wybierz przycisk Wstecz u góry, aby powrócić do widoku najwyższego poziomu narzędzia Asystent migracji.

Przekierowywanie połączeń

W ostatnim kroku ponownie połącz platformy ładowania i raportowania danych, aby ich połączenia kierowały do nowego magazynu Fabric.

  1. Zidentyfikuj połączenia w istniejącym magazynie danych źródłowych.

    • W wystąpieniu SQL Server można użyć dynamicznych widoków zarządzania, na przykład:
    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
    
    • W dedykowanych pulach SQL Azure Synapse Analytics znajdziesz informacje o sesji, w tym aplikację źródłową, podłączonego użytkownika, źródło połączenia oraz metodę uwierzytelniania:
    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. Zaktualizuj połączenia z platformami raportującymi, aby wskazywały magazyn Fabric.

  3. Przetestuj magazyn Fabric z kilkoma raportami przed przekierowaniem. Przeprowadź testy porównania i weryfikacji danych na platformach raportowania.

  4. Zaktualizuj połączenia dla platform ładowania danych (ETL/ELT), aby wskazywały na magazyn Fabric.

    • W przypadku potoków Power BI/Fabric:
      1. Użyj interfejsu API REST List Connections, aby znaleźć połączenia ze swoim starym źródłem danych, dedykowaną pulą SQL w usłudze Azure Synapse Analytics.
      2. Zaktualizuj połączenia z nowym magazynem przy użyciu strony Zarządzanie połączeniami i bramami w obszarze Ustawienia.
  5. Po zakończeniu sprawdź krok Przekierowuj połączenia w programie Asystent migracji.

Gratulacje! Teraz możesz rozpocząć korzystanie z nowego magazynu.

Zrzut ekranu z asystenta migracji w portalu Fabric, przedstawiający wszystkie cztery zakończone kroki zadania oraz wyskakujące okienko z gratulacjami.