Siirrä lataamalla tiedosto Fabric Migration Assistant

Sovellettavissa:✅ Varasto Microsoft Fabric

Fabric Migration Assistant tarjoaa ohjatun kokemuksen lähdemetatietojen ja datan siirtämiseen Fabric tietovarasto. Tämä opas selittää, miten metatietoja siirretään seuraavista lähteistä:

  • Azure Synapse Analytics tai SQL Server käyttämällä DACPAC-tiedostoa
  • Teradata käyttämällä .zip arkistoa .sql ja/tai .bteq tiedostoja

Edellytykset

Ennen kuin aloitat, varmista, että seuraavat ovat valmiita:

Jotta voit käyttää Migration Assistantin tekoälyavusteisia migraatioominaisuuksia migraatioongelmien korjaamiseen, sinun täytyy aktivoida Copilot:

Metatietojen kopioiminen

  1. Valitse Fabric-työtilassa kohteen toimintopaketin Siirrä-painike .

    Näyttökuva Kohteen toimintopinon Siirrä-painikkeen Kangas-portaalista.

  2. Migrate to Fabric -lähdevalikosta, Migrate to a warehouse, valitse lähdejärjestelmäruutu:

    • Azure Synapse Analytics varten valitse Azure Synapse Analytics dedicated SQL pool.
    • SQL Server-, Azure SQL Database- tai Azure SQL Managed Instance-tiedostoja varten valitse SQL Server database.
    • Teradatalle valitse Teradata (Preview).

    Kuvakaappaus lähdejärjestelmän laattojen Fabric-portaalista.

  3. Jos Valitse metodisi -sivu näkyy, valitse Lataa tiedosto lähdemetatiedoilla ja valitse Seuraava.

    Kuvakaappaus Fabric-portaalista, joka näyttää, miten tiedosto ladataan siirtoa varten.

  4. Kun aseta lähdekoodi, valitse Valitse tiedosto, valitse lähdetiedosto ja sitten seuraava.

    Kuvakaappaus Fabric-portaalista lähdemetatietojen tiedoston latausvaiheesta Migration Assistant -ohjelmassa.

  5. Valitse siirrettävät objektit -sivulla valitse siirrettävät objektit.

    Kuvakaappaus Fabric-portaalista, jossa näkyy objektin valintavaihe.

  6. Aseta kohde -sivulla anna Fabric-työtilan ja uuden varastokohteen nimi, johon haluat siirtyä. Valitse Seuraava.

  7. Tarkista syötteesi ja valitse Migrate. Migration Assistant luo uuden varastokohteen ja aloittaa metatietojen siirron.

    Note

    Kun käytetään Migration Assistantia, uudessa varastossa on kirjainkoon puuttuva kokoaminen, riippumatta oletusvaraston kokoamisasetuksista.

    Näyttökuva siirtoavustajan Tarkistus-sivun Fabric-portaalista. Lähde on DACPAC-tiedosto ja Kohde on uusi varastokohde nimeltä AdventureWorks.

    Tässä vaiheessa Migration Assistant muuntaa T-SQL-metatiedot tuetuksi T-SQL-syntaksiksi Fabric tietovarastossa. Metatietojen siirron päätyttyä Migration Assistant avautuu. Voit käyttää Migration Assistantia milloin tahansa käyttämällä varastonauhan Home-välilehden Migration-painiketta .

  8. Tarkista metatietojen siirtämisen yhteenveto siirtoavustajan kohdasta. Näet siirrettyjen objektien määrän ja ne objektit, jotka täytyy korjata ennen siirtoa.

    Näyttökuva siirtoavustajan metatietojen siirtoyhteenvedon Kangas-portaalista. Näytä siirretyt objektit -vaihtoehto näkyy korostettuna.

  9. Valitse Näytä siirretyt objektit laajentaaksesi osion ja nähdäksesi listan objekteista, jotka olet onnistuneesti siirtänyt Kangasvarastoosi.

    Näyttökuva siirtoavustajan metatietojen siirtoyhteenvedon ja siirrettyjen objektien luettelosta Fabric-portaalista.

    Tila-sarake kertoo, onko Migration Assistant säätänyt objektin metatietoja käännöksen aikana Fabric tietovarastoen. Saatat esimerkiksi nähdä, että tietyt sarakkeiden tietotyypit tai T-SQL-kielen rakenteet muunnetaan automaattisesti Fabricissa tuettuihin tietotyyppeihin. Yksityiskohdat-sarakkeessa näkyy tiedot niistä säädöistä, joita Migration Assistant on tehnyt objekteille.

  10. Valitse mikä tahansa objekti nähdäksesi, mitä muutoksia Migration Assistant teki siirron aikana.

  11. Avaa metatietojen siirron yhteenveto koko näytön näkymässä luettavuuden parantamiseksi. Käytä suodattimia tiettyjen objektityyppien tarkastelemiseen.

    Näyttökuva Siirtymisavustajan siirrettyjen objektien metatietojen siirron yhteenvedon koko näytön näkymästä.

Korjaa ongelmat käyttämällä Migration Assistantia

Joidenkin tietokantaobjektien metatietojen siirtäminen voi epäonnistua. Usein tämä virhe johtuu siitä, että Migration Assistant ei pystynyt kääntämään T-SQL-metatietoja Fabric tietovarasto:n tuetuiksi tai käännetty koodi ei sovellu T-SQL:ään.

Korjataan nämä komentosarjat siirtoavustajan avulla.

  1. Valitse Korjaa ongelmat osavaihe siirtoavustajasta, jotta näet komentosarjat, joiden siirtäminen epäonnistui.

    näyttökuva siirtoavustajan Korjaa ongelmat -luettelon Fabric-portaalista.

  2. Valitse tietokantaobjekti, jonka siirtäminen epäonnistui. Uusi kysely avautuu Jaettujen kyselyiden -kohtaan Explorerin. Tämä uusi kysely näyttää metatietojen määrityksen ja siihen tehdyt muutokset automaattisina kommentteina, jotka on lisätty T-SQL-koodiin.

  3. Tarkista komentosarjan alussa olevat kommentit, jotta näet komentosarjaan tehdyt muutokset.

  4. Tarkista ja korjaa rikkinäiset skriptit käyttämällä virhetietoja ja dokumentaatiota.

  5. Jos haluat käyttää Copilot-toimintoa tekoälyavusteiselle avulle virheiden korjaamisessa, valitse Korjaa kyselyvirheetEhdotettu toiminto -osassa. Copilot päivittää komentosarjan ehdotuksilla. Virheitä voi tapahtua, kun Copilot käyttää tekoälyä, joten tarkista koodiehdotukset ja tee tarvitsemasi muutokset.

    Kyselyeditorin Kangas-portaalin näyttökuva, joka näyttää siirtämisen epäonnistuneet T-SQL-kyselyt ja Copilotin ehdottamat kommentit ja korjaukset.

  6. Valitse Suorita objektin vahvistamiseksi ja luomiseksi.

  7. Seuraava korjattava skripti avautuu.

  8. Jatka muiden komentosarjojen korjaamista. Voit ohittaa korjaamassa komentosarjoja, joita et tarvitse tämän vaiheen aikana.

  9. Kun kaikki halutut metatiedot ovat valmiita siirrettäväksi, valitse Korjaa-ongelma-paneelista takaisin-painike palauttaaksesi Migration Assistantin ylätason näkymän. Tarkista kakkonen. Korjaa ongelmat Migration Assistantissa.

Hanki lisää objekteja siirrettäväksi

Käytä inkrementaalista migraatiota lisätäksesi tai päivittääksesi objekteja olemassa olevassa Fabric-varastossa. Anna uusi lähdesyöte, valitse vain tarvitsemasi objektit ja valitse miten käsittelet kohteita, jotka ovat jo olemassa kohteessa. Esimerkiksi siirrä yksi skeemaryhmä, validoita tulos ja palaa myöhemmin siirtämään lisää objekteja tai päivitettyjä määritelmiä.

  1. Aloita asteittainen siirtyminen jommastakin seuraavista paikoista:

    • Avaa varasto, valitse Migration-välilehti nauhasta ja valitse sitten Lisää objekteja.

      Kuvakaappaus Lisää objekteja varaston Migraatio-välilehdeltä.

    • Migraatiotiivistelmässä laajenna Kopioi metatiedot ja valitse sitten Lisää objekteja.

      Kuvakaappaus Lisää objekteja valmiilta Kopioi-metatietosivulta.

  2. Valitse lähde, valitse syötetapa ja jatka Lisää objekteja siirrettäväksi -vaiheeseen.

    Kuvakaappaus Migration Assistant -sivuston Choose more objects to migre -sivusta.

  3. Valitse lisää objekteja siirrettäväksi, valitse siirrettävät objektit:

    • Käytä suodatinta nähdäksesi kaikki lähdeobjektit, oliot, joilla on nimiristiriidat tai oliot ilman nimikonflikteja.

      Kuvakaappaus nimeämiskonfliktin suodattimesta Lisää objekteja siirrettäväksi -sivulla.

    • Esineet, joiden nimet ovat jo varastossa, näyttävät varoituskuvakkeen. Jos valitset jonkin näistä objekteista, ratkaiset nimikonfliktin myöhemmin siirron aikana.

      Kuvakaappaus varoituskuvakkeesta ja työkaluvihjeestä objektille, jonka nimi on jo varastossa.

    • Oletuksena Migration Assistant sisältää suoria riippuvuuksia, kun valitset objektin. Valitse objektin nimi nähdäksesi sen suorat riippuvuudet oikeassa paneelissa.

      Kuvakaappaus valitun objektin suorista riippuvuuksista.

    • Jos syötetiedoston objektilla ei ole skeeman nimeä, Migration Assistant määrittää objektin oletusskeemalledbo.

  4. Tarkastelussa varmista lähde, kohde ja objektien migraatioyhteenveto.

    Kuvakaappaus lähteen, kohteen ja objektin migraation yhteenvedosta Arvostelusivulla.

  5. Valitse Migrate. Migration Assistant kääntää valitut objektit ja luo objekteja, joissa ei ole nimikonflikteja. Nimikonflikteilla varustetut objektit pysyvät odottamassa, kunnes jokainen konflikti ratkeaa.

Ratkaise ristiriidat ja korjaa objektit

Kun päivität olemassa olevan varaston inkrementaalisella siirrolla, konfliktinratkaisu antaa sinun valita, minkä objektimääritelmän säilytät.

  1. Migration Assistant -yhteenvedossa tarkista ristiriidat laskennan ratkaisemiseksi. Laajenna 2. Ratkaise ristiriidat ja korjaa esineitä.

    Kuvakaappaus ratkaisevista ristiriidoista lasketaan ja Ratkaise konfliktit ja korjaa objektit -vaihe.

  2. Konfliktit-välilehdellä käy läpi ne objektit, joissa on nimiristiriitoja.

    Kuvakaappaus esineistä Konfliktit-välilehdellä.

  3. Valitse objekti vertaillaksesi sen SQL-määritelmiä. Nykyinen määritelmä näkyy vasemmalla ja saapuva käännetty määritelmä oikealla.

    Kuvakaappaus, jossa vertailet olemassa olevia ja saapuvia SQL-määritelmiä objektille.

  4. Valitse jokin seuraavista toiminnoista objektille:

    • Pidä olemassaolo: Säilytä olemassa oleva objektimääritelmä ja hylkää saapuva käännetty määritelmä.
    • Jatka saapumista: Korvaa olemassa oleva objektimääritelmä saapuvalla käännetyllä määritelmällä. Vahvista toiminto pyydettäessä.
    • Nimeä saapuva uudelleen: Luo saapuva olio eri nimellä ja säilytä olemassa oleva olio.

    Kuvakaappaus Keep incoming, Keep existing ja Renime saapuvat toiminnot objektille.

    Jos valitset Renimeä saapuva, syötä skeema ja objektin nimi, ja valitse sitten Rename.

    Kuvakaappaus Uudelleennimeä siirretystä objektivalikosta.

  5. Valinnainen: Muokkaa saapuvaa skriptiä ennen kuin säilytät sen. Poistaaksesi muokkaukset ja palauttaaksesi käännetyn skriptin, valitse Reset incoming.

    Kuvakaappaus Reset-toiminnosta muokatun saapuvan SQL-määritelmän yläpuolella.

  6. Saapuvan määritelmän soveltamiseksi valitse Keep incoming (overwrite existing). Jos muokkasit saapuvaa skriptiä, valitse Overwrite existing sen sijaan.

    Varoitus

    Taulukossa säilytä saapuvat pudotukset ja luo olemassa oleva taulukko uudelleen. Jos taulukossa on dataa, tämä toiminto aiheuttaa tietojen menetyksen, ja sinun täytyy ladata data uudelleen. Jos Migration Assistant ei pysty soveltamaan saapuvaa skriptiä, se palauttaa aiemman objektimääritelmän, mutta ei palauta pudonneita tietoja.

    Taululle valitse Korvaa taulu vahvistaaksesi toiminnon.

    Kuvakaappaus vahvistusdialogista olemassa olevan taulukon vaihtamisesta.

  7. Kun skripti toimii onnistuneesti, Migration Assistant merkitsee konfliktin ratkaistuksi.

    Kuvakaappaus, joka näyttää, että objektin konflikti on ratkaistu.

  8. Toista nämä vaiheet jokaiselle nimeämisristiriidassa olevalle objektille. Jos haluat soveltaa samaa toimintoa useisiin objekteihin, valitse objektit ja valitse sitten Säilytä olemassa tai Pidä saapuvat.

    Kuvakaappaus massasta Jatka saapumista ja Säilytä olemassa olevat toiminnot.

  9. Varmista, että jokainen onnistuneesti käsitelty objekti on merkitty ratkaistuksi. Jos objekti tarvitsee lisää muutoksia, tarkista tiedot oikeassa ruudussa.

Kopioi tiedot käyttämällä Migration Assistantia

Tietojen kopiointi auttaa siirtämään tietoja, joita siirtämäsi objektit käyttävät. Voit tehdä sen manuaalisesti Fabric Data Factory -kopiotehtävällä tai noudattaa näitä vaiheita kopiotyön integraatiossa Migration Assistantissa.

  1. Valitse siirtymisavustajan Tietojen kopioiminen vaihe.

  2. Valitse Käytä kopiotyötä.

  3. Määritä nimi uudelle työlle ja valitse sitten Luo.

  4. Yhdistä datalähteeseen -sivulla, anna lähdejärjestelmäsi yhteystiedot. Valitse Seuraava.

  5. Valitse Valitse-data-sivulla haluamasi siirtämät taulukot. Valitse Seuraava.

    Näyttökuva Valitse tiedot -ruudun Kangas-portaalista, jossa on valittuna joitakin taulukoita.

  6. Valitse Valitse tietokohde -sivulla uusi Fabric-varastokohde OneLake -luettelon. Valitse Seuraava.

  7. Määritä kunkin taulukon sarakkeiden yhdistämismääritykset Map to destination -sivulla. Valitse Seuraava.

  8. Valitse Kopioi työtila -sivulla kopiointitila. Valitse kertaluontoinen tietojen kopio (suositeltu siirtoa varten) tai jatkuva lisäävä kopiointi. Valitse Seuraava.

  9. Tarkista työn yhteenveto. Valitse Tallenna + Suorita.

  10. Kun kopiointityö on valmis, tarkista 3. Kopioi data -vaihe Migration Assistantissa. Valitse ylhäällä oleva takapainike palataksesi Migration Assistantin ylätasonäkymään.

Yhteyksien uudelleen järjestäminen

Viimeisessä vaiheessa yhdistä datan lataus- ja raportointialustat niin, että niiden yhteydet osoittavat uuteen Fabric-varastoosi.

  1. Tunnista yhteydet olemassa olevasta lähdevarastosta.

    • SQL Server -instanssissa voit käyttää dynaamisia hallintanäkymiä, esimerkiksi:
    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
    
    • Azure Synapse Analytics -omistetuissa SQL-pooleissa löydät istuntotiedot, kuten lähdesovelluksen, yhdistetyn käyttäjän, yhteyden alkuperän ja todennusmenetelmän:
    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. Päivitä raportointiympäristöjen yhteydet niin, että ne osoittavat Fabric-varastoosi.

  3. Testaa Fabric-varastoa jollakin raportoinnilla ennen uudelleen reitimistä. Suorita vertailu- ja tietojen vahvistustestejä raportointiympäristössäsi.

  4. Päivitä tietojen lataamisympäristöjen (ETL/ELT) yhteydet niin, että ne osoittavat Fabric-varastoosi.

    • Power BI/Fabric-putket:
      1. Etsi List Connections REST -ohjelmointirajapinnan avulla yhteydet vanhaan tietolähteeseen, Azure Synapse Analyticsin erilliseen SQL-varantoon.
      2. Päivitä uuden varaston yhteydet käyttämällä Hallinnoi yhteyksiä ja portteja -sivua Asetuksista.
  5. Kun olet valmis, tarkista Migration Assistantista Reroute connections -vaihe.

Onnittelut! Olet nyt valmis aloittamaan uuden varastosi käytön.

Kangasportaalin siirtoavustajan näyttökuva, joka näyttää kaikki neljä työvaihetta valmiina ja onnittelut-ponnahdusikkunan.