Jaa

SQL-tietokantalähteen hallinnan integrointi Microsoft Fabricissa

  • Artikkeli

Koskee Microsoft Fabricin SQL-tietokantaa✅

Tässä opetusohjelmassa opit käyttämään SQL-tietokantaa Fabricissa Fabric Git -integroinnin lähteen hallinnan avulla.

Microsoft Fabricin SQL-tietokannassa on lähteen hallinnan integrointi eli Git-integrointi, jonka avulla SQL-käyttäjät voivat seurata tietokantaobjektien määrityksiä ajan kuluessa. Tämän integraation avulla tiimi voi:

  • Vahvista tietokanta lähdekoodin hallintaan, mikä muuntaa reaaliaikaisen tietokannan automaattisesti koodiksi määritetyssä lähteen hallinnan säilössä (kuten Azure DevOps).
  • Päivitä tietokantaobjektit lähteen ohjausobjektin sisällöstä, joka vahvistaa koodin lähteen ohjausobjektin säilössä ennen eriytetyn muutoksen käyttämistä tietokannassa.

Kaavio yksinkertaisesta vahvistus- ja päivitysjaksosta reaaliaikaisen tietokannan ja lähteen hallinnan välillä.

Jos et tunne Gitiä, seuraavassa on muutamia suositeltuja resursseja:

Tässä artikkelissa esitellään useita hyödyllisiä skenaarioita, joita voi käyttää yksitellen tai yhdessä hallitakseen kehitysprosessiasi Fabricin SQL-tietokannan avulla:

Edellytykset

Asetusten määrittäminen

Tämä säilöyhteys koskee työtilan tasoa siten, että kyseiseen työtilaan liitetään säilön yksi haara. Säilössä voi olla useita haaroja, mutta vain työtilan asetuksissa valitun haaran koodi vaikuttaa suoraan työtilaan.

Ohjeet työtilan yhdistämiseksi lähteen hallinnan säilöön ovat kohdassa Git-integroinnin aloittaminen. Työtilasi voidaan yhdistää Azure DevOps- tai GitHub-etäsäilöön.

Fabric SQL -tietokannan lisääminen lähteen hallintaan

Tässä skenaariossa vahvistat tietokantaobjektit lähteen hallintaan. Olet ehkä kehittämässä sovellusta, jossa luot objekteja suoraan testitietokantaan ja seuraat tietokantaa lähteen hallinnassa, aivan kuten sovelluskoodiakin. Tämän ansiosta voit käyttää tietokantaobjektien määritelmien historiaa ja mukauttaa kehitysprosessia edelleen Git-käsitteiden, kuten haarautumisen ja yhdistämisen, avulla.

  1. Muodosta yhteys SQL-tietokantaan Fabric SQL -editorissa, SQL Server Management Studiossa, mssql-laajennuksessa Visual Studio Codella tai muilla ulkoisilla työkaluilla.
  2. Luo uusi taulukko, tallennettu toimintosarja tai muu tietokannan objekti.
  3. Valitse ... tietokannan valikko ja valitse Päivitä Git-synkronoinnin tila.
  4. Avaa lähdeohjauspaneeli valitsemalla Lähde-ohjausobjektin painike.
  5. Valitse haluamasi tietokannan vieressä oleva valintaruutu. Valitse Vahvista. Fabric-palvelu lukee objektimääritykset tietokannasta ja kirjoittaa ne etäsäilöön.
  6. Voit nyt tarkastella tietokantaobjektien historiaa koodisäilön lähdenäkymässä.

Kun jatkat tietokannan muokkaamista ja aiemmin luotujen objektien muokkaamista, voit sitoa nämä muutokset lähteen hallintaan edellä annettujen ohjeiden mukaisesti.

Päivitä Fabric SQL -tietokanta lähdekoodin hallinnasta

Tässä skenaariossa luot tietokantaobjekteja koodina VS Coden SQL-projektilaajennuksessa ja vahvistat sitten tiedostot lähteen hallintaan ennen Kuin päivität Fabric SQL -tietokannan lähdeohjausobjektin integroinnista. Tämä skenaario on tarkoitettu kehittäjille, jotka haluavat työskennellä VS Codessa, käyttää olemassa olevia sovelluksia SQL-projektien avulla tai joilla on edistyneempiä CI/CD-putkia koskevia vaatimuksia.

  1. Varmista, että olet asentanut VS Coden uusimman julkaisuversion sekä VS Coden mssql- ja SQL-projektilaajennukset.
  2. Luo uusi SQL-tietokanta työtilaasi ja vahvista se lähteen hallintaan lisäämättä objekteja. Tämä vaihe lisää tyhjät SQL-projektin ja SQL-tietokantakohteen metatiedot säilöön.
  3. Kloonaa lähteen ohjausobjektien säilö paikalliseen tietokoneeseen.
    • Jos käytät Azure DevOpsia, valitse ... lähdeohjausprojektin pikavalikko. Kopioi Azure DevOps -säilösi paikalliseen tietokoneellesi valitsemalla Kloonaa . Jos olet uusi Azure DevOps -käyttäjä, tutustu Azure DevOpsin Git-oppaan koodiin.
    • Jos käytät GitHubia, valitse Koodi-painike säilöstä ja kopioi URL-osoite kloonataksesi säilön paikalliseen tietokoneeseen. Jos et ole aiemmin käyttänyt GitHubia, tutustu säilön kloonausoppaaseen .
  4. Avaa kloonattu kansio Visual Studio Codessa. Työtilaasi liittyvä haara ei välttämättä ole oletus. Sinun pitäisi nähdä kansio, joka on nimetty <yourdatabase>.SQLDatabase VS Codessa haaran vaihtamisen jälkeen.
  5. .sql Luo tiedosto vähintään yhdelle taulukolle, jonka haluat luoda tietokannassa tietokantasi kansiorakenteessa. Tiedoston tulee sisältää taulukon CREATE TABLE lauseke. Voit esimerkiksi luoda kansioon dbo/Tables nimetyn MyTable.sql tiedoston, jossa on seuraava sisältö:
    CREATE TABLE dbo.MyTable
(
    Id INT PRIMARY KEY,
    ExampleColumn NVARCHAR(50)
);
  6. Jotta syntaksi olisi kelvollinen, voimme vahvistaa tietokantamallin SQL-projektilla. Kun olet lisännyt tiedostot, luo projekti VS Coden Tietokantaprojektit-näkymässä.
  7. Onnistuneen koontiversiotoiminnon jälkeen vahvista tiedostot lähteen hallintaan VS Coden lähdeohjausnäkymässä tai ensisijaisessa paikallisessa Git-käyttöliittymässä.
  8. Lähetä/synkronoi vahvistuksesi etäsäilöön. Tarkista, että uudet tiedostosi ovat ilmestyneet Azure DevOpsissa tai GitHubissa.
  9. Palaa Fabric-verkkoliittymään ja avaa työtilan Source-ohjauspaneeli . Sinulla saattaa jo olla ilmoitus, että "sinulla on odottavia muutoksia Gitistä". Valitse Päivitä (Päivitä kaikki) -painike, jos haluat ottaa koodin käyttöön SQL-projektista tietokantaan.
    • Saatat nähdä tietokannan heti sen merkiksi, että se on "Sitomaton" päivityksen jälkeen. Tämä johtuu siitä, että Git-integrointitoiminto tekee suoran vertailun kaikesta kohteen määritelmälle luodusta tiedostosisällöstä ja jotkin tahattomat erot ovat mahdollisia. Yksi esimerkki on sarakkeiden sisäiset määritteet. Näissä tapauksissa sinun on sitouduttava takaisin lähteen hallintaan Fabric-verkkoliittymässä, jotta voit synkronoida määrityksen sen kanssa, mitä luodaan osana vahvistustoimintoa.
  10. Kun päivitys on valmis, muodosta yhteys tietokantaan valitsemallasi työkalulla. SQL-projektiin lisäämäsi objektit näkyvät tietokannassa.

Muistiinpano

Kun teet muutoksia paikalliseen SQL-projektiin ja Jos Fabricissa on syntaksivirhe tai ominaisuuksien käyttöä, joita ei tueta, tietokannan päivitys epäonnistuu. Sinun on palautettava lähdeohjausobjektin muutos manuaalisesti, ennen kuin voit jatkaa.

Haaratyötilan luominen

Tässä skenaariossa luot Uuden kehitysympäristön Fabricissa luomalla kaksoiskappalejoukon resursseja lähteen ohjausobjektin määrityksen perusteella. Tietokannan kaksoiskappale sisältää tietokantaobjektit, jotka olemme kirjautuneet lähteen ohjausobjektiin. Tämä skenaario on suunnattu kehittäjille, jotka jatkavat sovelluskehityksen elinkaartaan Fabricissa ja käyttävät Fabricin lähdekoodin hallinnan integrointia.

  1. Suorita skenaario , jossa Fabric SQL -tietokanta muunnetaan lähdekoodiksi.
    • Lähdeohjaussäilössä pitäisi olla haara, joka sisältää sekä SQL-projektin että Fabric-objektin metatiedot.
  2. Avaa Fabric-työtilassa lähdekoodin ohjauspaneeli . Valitse Lähde-ohjausobjektivalikon Haarat-välilehdestä Haara ulos uuteen työtilaan.
  3. Määritä luotavan haaran ja työtilan nimet. Haara luodaan lähteen hallinnan säilöön, ja se täytetään haaraan liitetyn haaran sitoutuneella sisällöllä, josta haara olet haarautumassa. Työtila luodaan Fabricissa.
  4. Siirry juuri luotuun työtilaan Fabricissa. Kun tietokannan luominen on valmis, juuri luotu tietokanta sisältää nyt koodisäilössä määritetyt objektit. Jos avaat Fabric-kyselyeditorin ja siirryt Object Exploreriin, tietokannassa on uusia (tyhjiä) taulukoita ja muita objekteja.

Muutosten yhdistäminen haarasta toiseen

Tässä skenaariossa käytät lähteen hallintasäilöä tietokannan muutosten tarkistamiseen, ennen kuin ne ovat käytettävissä käyttöönottoa varten. Tämä skenaario on tarkoitettu kehittäjille, jotka työskentelevät ryhmäympäristössä ja käyttävät lähdekoodin hallintaa tietokantamuutosten hallintaan.

Luo kaksi työtilaa, joihin liittyy haaroja samassa säilössä edellisessä skenaariossa kuvatulla tavalla.

  1. Kun tietokanta on toissijaisessa haarassa, tee muutoksia tietokantaobjekteihin.
    • Voit esimerkiksi muokata aiemmin luotua tallennettua toimintosarjaa tai luoda uuden taulukon.
  2. Tarkista nämä lähdeohjausobjektiin tehdyt muutokset Fabric-lähteen ohjauspaneelin Vahvista-painikkeella .
  3. Luo Azure DevOpsissa tai GitHubissa pull-pyyntö toissijaisesta haarasta ensisijaiseen haaraan.
    • Pull-pyynnössä näet tietokantakoodin muutokset ensisijaisen työtilan ja toissijaisen työtilan välillä.
  4. Kun olet tehnyt pull-pyynnön, lähteen ohjausobjekti päivitetään, mutta ensisijaisen työtilan Fabric-tietokantaa ei muuteta. Voit muuttaa ensisijaista tietokantaa päivittämällä ensisijaisen työtilan lähdeohjausobjektista Fabricin lähdeohjauspaneelin Päivitä-painikkeella .

Liittyvä sisältö