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

Wymagania wstępne

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

• 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 Asystent migracji tworzy nowy magazyn.
• Plik metadanych źródłowych w jednym z tych formatów:
  • Plik DACPAC wyodrębniony z Azure Synapse Analytics lub SQL Server. DACPAC zawiera metadane obiektów bazy danych, w tym tabel, widoków, procedur przechowywanych i funkcji.
    • Aby utworzyć plik DACPAC z usługi Azure Synapse Analytics, zobacz Wyodrębnianie aplikacji warstwy danych (DAC) z dedykowanej puli SQL usługi Azure Synapse w programie Visual Studio 2022.
    • Możesz także użyć kreatora Generowania skryptów w SQL Server Management Studio (SSMS),projektów baz danych w stylu SDK z Visual Studio Code lub narzędzia wiersza poleceń SqlPackage.
  • Archiwum ZIP plików Teradata .sql i/lub .bteq, zawierające definicje obiektów i zależności potrzebne do migracji.

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:

• 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 Twój tenant lub pojemność znajduje się poza USA lub Francją, Copilot jest domyślnie wyłączony, chyba że administrator tenanta Fabric umożliwi Dane przesyłane do Azure OpenAI mogą być przetwarzane poza regionem geograficznym Twojej pojemności, granicą zgodności lub krajowym settingiem instancji chmury wustawieniach kataloguOneLake>Govern>Configurations>.
• 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 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).

   

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

   

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

   

5. Na stronie Wybierz obiekty do migracji wybierz obiekty do migracji.

   

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

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

   

   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.

8. 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.

   

9. 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 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.

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

11. Otwórz podsumowanie migracji metadanych w widoku pełnoekranowym, aby uzyskać lepszą czytelność. Zastosuj filtry, aby wyświetlić określone typy 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ść.

   

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

Zdobądź więcej obiektów do migracji

Użyj migracji przyrostowej, aby dodawać lub aktualizować obiekty w istniejącym magazynie Fabric. Wprowadź nowe dane wejściowe źródłowe, wybierz tylko potrzebne obiekty i wybierz sposób obsługi obiektów, które już istnieją w miejscu docelowym. Na przykład zmigruj jedną grupę schematów, zweryfikuj wynik, a następnie wróć później, aby zmigrować więcej obiektów lub zaktualizowane definicje.

1. Rozpocznij migrację stopniową z jednego z następujących miejsc:

   • Otwórz hurtownię, wybierz zakładkę Migracja na wstążce, a następnie wybierz Pobierz więcej obiektów.

     

   • W podsumowaniu migracji rozwiń Kopiuj metadane, a następnie wybierz Pobierz więcej obiektów.

     

2. Wybierz źródło, wybierz metodę wejścia i przejdź do kroku Wybierz więcej obiektów do migracji .

   

3. W opcji Wybierz więcej obiektów do migracji wybierz obiekty do migracji:

   • Użyj filtra, aby zobaczyć wszystkie obiekty źródłowe, obiekty z konfliktami nazewnictwa lub obiekty bez konfliktów nazewnictwa.

     

   • Obiekty, których nazwy już istnieją w magazynie, wyświetlają ikonę ostrzegawczą. Jeśli wybierzesz jeden z tych obiektów, konflikt nazewnictwa rozwiązujesz później w migracji.

     

   • Domyślnie Asystent migracji zawiera bezpośrednie zależności przy wyborze obiektu. Wybierz nazwę obiektu, aby zobaczyć jego bezpośrednie zależności w prawym panelu.

     

   • Jeśli obiekt w pliku wejściowym nie ma nazwy schematu, Asystent migracji przypisuje go do domyślnego dbo schematu.

4. Na ekranie Przegląd zweryfikuj podsumowanie migracji źródła, miejsca docelowego i obiektów.

   

5. Wybierz Migrate. Asystent migracji tłumaczy wybrane obiekty i tworzy obiekty, jeśli nie powoduje to konfliktów nazw. Obiekty z konfliktem nazewnictwa pozostają w stanie oczekiwania, dopóki nie rozwiążesz każdego konfliktu.

Rozwiąż konflikty i napraw obiekty

Gdy aktualizujesz istniejący magazyn poprzez migrację stopniową, rozwiązywanie konfliktów pozwala wybrać, którą definicję obiektu zachować.

1. W podsumowaniu Asystent migracji sprawdź liczbę Konflikty do rozwiązania. Rozwiń 2. Rozwiązuj konflikty i naprawiaj obiekty.

   

2. Na zakładce Konflikty przejrzyj obiekty, które mają konflikty nazewnictwa.

   

3. Wybierz obiekt, aby porównać jego definicje SQL. Istniejąca definicja pojawia się po lewej, a przychodząca przetłumaczona definicja po prawej.

   

4. Wybierz jedną z następujących akcji dla obiektu:

   • Zachowaj istniejącą: Zachowaj istniejącą definicję obiektu i odrzuć przychodzącą przetłumaczoną definicję.
   • Zachowaj przychodzące: Zamień istniejącą definicję obiektu na przychodzącą przetłumaczoną definicję. Po wyświetleniu monitu potwierdź działanie.
   • Zmień nazwę przychodzącego obiektu: Stwórz przychodzący obiekt z inną nazwą i zachowaj istniejący obiekt.

   

   Jeśli wybierzesz Rename incoming, wpisz schemat i nazwę obiektu, a następnie wybierz Rename.

   

5. Opcjonalnie: Edytuj nadchodzący skrypt, zanim go zachowasz. Aby usunąć swoje zmiany i przywrócić przetłumaczony skrypt, wybierz Reset incoming.

   

6. Aby zastosować definicję wejściową, wybierz Zachowaj przychodzącą (nadpisz istniejącą). Jeśli edytowałeś importowany skrypt, wybierz zamiast tego Nadpisz istniejący.

   Warning

   W przypadku tabeli opcja Zachowaj przychodzące usuwa i ponownie tworzy istniejącą tabelę. Jeśli tabela zawiera dane, ta akcja powoduje ich utratę i musisz je ponownie załadować. Jeśli Asystent migracji nie może zastosować przychodzącego skryptu, przywraca poprzednią definicję obiektu, ale nie odzyskuje utraconych danych.

   W przypadku tabeli wybierz Zamień tabelę, aby potwierdzić akcję.

   

7. Po pomyślnym uruchomieniu skryptu Asystent migracji oznacza konflikt jako rozwiązany.

   

8. Powtarzaj te kroki dla każdego obiektu z konfliktem nazewnictwa. Aby zastosować tę samą akcję do wielu obiektów, zaznacz obiekty, a następnie wybierz Zachowaj istniejące lub Zachowaj przychodzące.

   

9. Potwierdź, że każdy pomyślnie przetworzony obiekt jest oznaczony jako rozwiązany. Jeśli obiekt wymaga dalszych zmian, przejrzyj informacje w prawym panelu.

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.

   

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.

Treści powiązane

• Asystent Migracji Tkaniny dla Hurtowni Danych
• Omówienie migracji usługi Microsoft Fabric