Migrowanie za pomocą pliku DACPAC

Dotyczy: ✅ Magazynu w platformie Microsoft Fabric

Narzędzie Fabric Migration Assistant to środowisko migracji, którego można użyć do bezproblemowego kopiowania dedykowanych pul SQL w usłudze Azure Synapse Analytics, baz danych w programie SQL Server oraz baz danych z innych platform Aparatu Baz Danych SQL do magazynu danych Fabric.

Ten przewodnik prowadzi Cię przez kroki migracji z dedykowanej puli SQL Azure Synapse Analytics do magazynu Fabric za pomocą pliku DACPAC.

Wskazówka

Aby uzyskać więcej informacji na temat funkcji i możliwości programu Migration Assistant, zobacz Fabric Migration Assistant for Data Warehouse.

Aby uzyskać więcej informacji na temat strategii i planowania migracji, zobacz Planowanie migracji: dedykowane pule SQL usługi Azure Synapse Analytics w usłudze Fabric Data Warehouse.

Wymagania wstępne

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

• Obszar roboczy Fabric z aktywną pojemnością lub pojemnością próbną.
• Utwórz obszar roboczy lub wybierz istniejący obszar roboczy, do którego chcesz przeprowadzić migrację. Narzędzie Migration Assistant tworzy nowy magazyn.
• Plik DACPAC wyodrębniony z dedykowanej puli SQL usługi Azure Synapse Analytics. Plik DACPAC (pakiet aplikacji warstwy danych) jest tworzony na podstawie projektów bazy danych SQL i zawiera metadane obiektów bazy danych, w tym schemat tabel, widoków, procedur składowanych, funkcji i nie tylko.
  • Aby utworzyć moduł DAC w programie Visual Studio 2022 z narzędziami SQL Server Data Tools, zobacz Wyodrębnianie aplikacji warstwy danych (DAC) z dedykowanej puli SQL usługi Azure Synapse w programie Visual Studio 2022.
  • Można również używać projektów bazy danych w stylu zestawu SDK z programem VS Code lub narzędziem wiersza polecenia SqlPackage.

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

• Administrator musi aktywować umożliwienie zmiany dzierżawcy przed rozpoczęciem korzystania z Copilota. Aby uzyskać więcej informacji, zobacz Ustawienia dzierżawcy Copilot.
• Pojemność F2 lub P1 musi znajdować się w jednym z regionów wymienionych w dostępności regionów Fabric.
• Jeśli twoja dzierżawa lub pojemność znajduje się poza Stanami Zjednoczonymi lub Francją, Copilot jest domyślnie wyłączony, chyba że administrator dzierżawy w Fabric umożliwi ustawienie dzierżawy Dane wysyłane do Azure OpenAI mogą być przetwarzane poza geograficznym regionem pojemności, granicą zgodności lub wystąpieniem chmury krajowej w portalu administracyjnym Fabric.
• Rozwiązanie Copilot w usłudze Microsoft Fabric nie jest obsługiwane w przypadku SKU wersji próbnej. Obecnie obsługiwane są tylko płatne jednostki SKU (F2 lub nowsze lub P1 lub nowsze).
• Aby uzyskać więcej informacji, zobacz Omówienie narzędzia Copilot w Fabric i Power BI.

Kopiowanie metadanych

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

   

2. W menu źródłowym Migrate to Fabric pod Migrowanie do magazynu, wybierz kafelek systemu źródłowego.

   • Jeśli przeprowadzasz migrację z dedykowanej puli SQL usługi Azure Synapse Analytics, wybierz kafelek dedykowanej puli SQL usługi Azure Synapse Analytics .
   • Jeśli przeprowadzasz migrację z dowolnej innej bazy danych T-SQL, takiej jak baza danych w programie SQL Server, usłudze Azure SQL Database lub usłudze Azure SQL Managed Instance, wybierz kafelek bazy danych programu SQL Server .

   

3. Na stronie Wybierz metodę wybierz pozycję Przekaż plik z metadanymi źródłowymi , a następnie wybierz pozycję Dalej.

4. Wybierz Wybierz plik i przekaż plik DACPAC źródłowego magazynu danych. Po zakończeniu przesyłania wybierz opcję Dalej.

   

5. Na stronie Ustaw cel wprowadź nazwę nowego obszaru roboczego Fabric i nowego elementu magazynu, do którego chcesz przeprowadzić migrację. Wybierz Dalej.

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

   Uwaga / Notatka

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

   

   W tym kroku narzędzie Migration Assistant 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 Migration Assistant. Program Migration Assistant 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 Migration Assistant. Zobaczysz liczbę migrowanych obiektów i obiektów, które należy naprawić, zanim będą mogły zostać zmigrowane.

   

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

   

   Kolumna State wskazuje, czy narzędzie Migration Assistant 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. W kolumnie Details (Szczegóły ) są wyświetlane informacje o korektach wprowadzonych w portalu do obiektów.

9. Wybierz dowolny obiekt, aby wyświetlić korekty wprowadzone przez narzędzie Migration Assistant 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.

    

11. Opcjonalnie wybierz menu Eksportuj , aby pobrać podsumowanie migracji jako plik programu Excel lub plik CSV.

    • Pobrany plik programu Excel to w pełni ustrukturyzowany skoroszyt z dwoma arkuszami: zmigrowane obiekty i obiekty do naprawienia. Jest ona zgodna ze standardem MIP i jest zgodna z etykietami poufności organizacji.
    • Plik CSV jest lekki i przyjazny dla narzędzi.

    

    Każdy wyeksportowany plik zapewnia ustrukturyzowany, kompleksowy widok wyników migracji, w tym:

    Nazwa pola	Opis	Przykładowe wartości
    Nazwa obiektu	Nazwa obiektu SQL
    Typ obiektu	Typy obiektów SQL	Tabela, widok, procedura składowana, funkcja
    Stan	Stan tłumaczenia	Dostosowano: aktualizacje zgodne z Fabric Data Warehouse są stosowane Nie dostosowano: brak zmian w oryginalnym scenariuszu
    Szczegóły	Lista zastosowanych korekt lub komunikatów o błędach
    Typ błędu	Typ błędu tłumaczenia	Komunikat tłumaczenia, błąd tłumaczenia, błąd stosowania tłumaczenia

Rozwiązywanie problemów przy użyciu narzędzia Migration Assistant

Migracja niektórych metadanych obiektu bazy danych może zakończyć się niepowodzeniem. Zazwyczaj ten błąd występuje, ponieważ program Migration Assistant nie może przekształcić metadanych języka T-SQL na te, które są obsługiwane w hurtowni danych Fabric, lub przetłumaczony kod nie działa poprawnie w T-SQL.

Napraw te skrypty przy użyciu narzędzia Migration Assistant.

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

   

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.

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 Migration Assistant. Sprawdź krok 2. Rozwiązywanie problemów w narzędziu Migration Assistant.

Kopiowanie danych przy użyciu narzędzia Migration Assistant

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 Migration Assistant.

1. Wybierz krok kopiowania danych w narzędziu Migration Assistant.

2. Wybierz przycisk Użyj zadania kopiowania.

3. Wprowadź nazwę nowego zadania, a następnie wybierz pozycję Utwórz.

4. Na stronie Nawiązywanie połączenia ze źródłem danych wprowadź poświadczenia połączenia dla źródłowej dedykowanej puli SQL usługi Azure Synapse Analytics (SQL DW). Wybierz Dalej.

5. Na stronie Wybierz dane wybierz tabele, które chcesz przenieść. Metadane obiektu powinny już istnieć w magazynie docelowym. Wybierz Dalej.

   

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 Migration Assistant. Wybierz przycisk Wstecz u góry, aby powrócić do widoku najwyższego poziomu narzędzia Migration Assistant.

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.

   • Na przykład w dedykowanych pulach SQL usługi Azure Synapse Analytics można znaleźć informacje o sesji, w tym informacje o aplikacji źródłowej, połączonej, lokalizacji, z której pochodzi połączenie, oraz o tym, czy korzysta z uwierzytelniania Microsoft Entra lub SQL:

   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 Migration Assistant.

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

Treści powiązane

• Asystent Migracji Tkaniny dla Hurtowni Danych
• Omówienie migracji usługi Microsoft Fabric
• Uaktualnij potoki usługi Azure Data Factory do Fabric