Varastoprojektien kehittäminen Visual Studio Codessa

Koskee:✅ Microsoft Fabric -varasto

Lue, miten voit määrittää tietokantaprojektin Fabric Data Warehouselle Visual Studio Codessa. Luot uuden projektin, määrität rakenneobjektit, rakennat ja vahvistat projektin ja julkaiset sen varastossasi.

Edellytykset

Ennen kuin aloitat, varmista, että:

• Sinulla on pääsy aiemmin luotuun varastonimikkeeseen Fabric-työtilassa osallistuja- tai korkeammalla käyttöoikeudella.
  • Jos haluat luoda uuden näytevaraston, katso Mallivaraston luominen Microsoft Fabricissa.
• Asenna Visual Studio Code työasemallesi.
• Asenna .NET SDK tietokantaprojektien luomista ja julkaisemista varten.
• Asenna kaksi Visual Studio Code -laajennusta: SQL Database Projects ja SQL Server (mssql).
  • Voit asentaa tarvittavat laajennukset suoraan Visual Studio Code Marketplacesta hakemalla "SQL Database Projects" tai "SQL Server (mssql)".

Luo uusi tietokantaprojekti

Voit luoda tietokantaprojektin tyhjästä tai olemassa olevasta varastosta.

Vaihtoehto 1: Luo uusi tietokantaprojekti Visual Studio Coden komentopaletista

1. Avaa Visual Studio Code.

2. Avaa komentopaletti (Ctrl+Shift+P tai Cmd+Shift+P Macissa).

3. Hae tietokantaprojekteja: Uusi.

4. Valitse tietokannan projektityypiksiSQL Server -tietokanta.

5. Valitse projektin nimi ja valitse paikallisen kansion sijainti.

6. Valitse kohdeympäristöksi Synapse Data Warehouse Microsoft Fabricissa .

7. Valitse pyydettäessä Kyllä (suositus) SDK-tyyliselle projektille.

   Tärkeää

   Vain SDK-tyylisiä projekteja tuetaan Fabric Data Warehousessa.

8. Valitse Kyllä kysymykseen Haluatko määrittää SQL-projektin koontiversion tämän kansion oletuskoontimääritykseksi?

9. Valitse Kyllä , jos haluat luottaa tämän kansion tiedostojen tekijöihin.

Vaihtoehto 2: Luo uusi tietokantaprojekti Tietokantaprojektit-laajennuksesta

1. Valitse Visual Studio Codessa Tietokantaprojektit-laajennuskuvakeaktiviteettipalkista.

2. Valitse Tietokantaprojektit-ruudussaLuo uusi.

   

3. Valitse tietokannan projektityypiksiSQL Server -tietokanta.

4. Valitse projektin nimi ja valitse paikallisen kansion sijainti.

5. Valitse kohdeympäristöksi Synapse Data Warehouse Microsoft Fabricissa .

6. Valitse pyydettäessä Kyllä (suositus) SDK-tyyliselle projektille. Vain SDK-tyylisiä projekteja tuetaan Fabric Data Warehousessa.

7. Valitse Kyllä kysymykseen Haluatko määrittää SQL-projektin koontiversion tämän kansion oletuskoontimääritykseksi?

8. Valitse Kyllä , jos haluat luottaa tämän kansion tiedostojen tekijöihin.

Vaihtoehto 3: Luo tietokantaprojekti olemassa olevasta varastosta

1. Luo ensin varastolle uusi yhteysprofiili Visual Studio Codessa.

   1. Valitse SQL Server -laajennus Visual Studio Codessa toimintopalkista.
   2. Anna profiilin nimi. Valitse Parametrit.
   3. Anna palvelimen nimi. Hae Fabric-portaalin varaston asetuksistaSQL-päätepisteen merkkijono. (Tämä eroaa SQL-analytiikan päätepisteestä.) Näyttää siltä, että <server unique ID>.datawarehouse.fabric.microsoft.com. Tämä on palvelimen nimi.
   4. Käytä TodennustyypissäMicrosoft Entra ID – Universal monimenetelmäisen todentamisen tuella. Todenna Microsoft Entra ID:lläsi.
   5. Anna muut tiedot oletuksena tai haluttuna ja valitse Yhdistä.

2. Valitse Visual Studio Codessa Tietokantaprojektit-laajennuskuvake aktiviteettipalkista.

3. Valitse ... asetuspainike ja valitse Luo projekti tietokannasta -vaihtoehto.

   

4. Valitse varasto aiemmin luoduista yhteysprofiileista.

5. Anna projektin nimi ja valitse projektikansio työasemaltasi.

6. Valitse kansiorakenteeksi Skeema/objektityyppi (suositus).

7. Valitse Sisällytä käyttöoikeudet projektiin -kohdassa Ei (oletus).

8. Valitse SDK-tyylisessä projektissa Kyllä (suositus).

9. Valitse Kyllä kysymykseen Haluatko määrittää SQL-projektin koontiversion tämän kansion oletuskoontimääritykseksi?

10. Visual Studio Code poimii projektitiedostot varastoprojektista.

    

11. Kun puru on onnistunut, näet seuraavan ilmoituksen: "Pura projektitiedostot: Onnistui. Valmis".

12. Valitse Kyllä , jos haluat luottaa tämän kansion tiedostojen tekijöihin.

Uusi tietokantaprojekti varastollesi

Varaston uusi tietokantaprojekti näkyy SQL-tietokantaprojektit-valikossa.

Projektisi rakenne näyttää tältä:

 | Project Name
 ├── Database References
 ├── SQLCMD Variables
 ├── .vscode/
 └── schema/
     ├── Functions
     ├── Tables
     └── Views

Tietokantaprojektin määrittäminen

1. Napsauta projektia hiiren kakkospainikkeella ja valitse Muokkaa .sqlproj-tiedostoa.

   

2. Varmista, että Microsoft.Build.Sql SDK:n uusin versio on tiedostossa. Muuta esimerkiksi tiedoston .sqlproj versioksi Microsoft.Build.Sql .2.0.0

      <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
   

3. Tarkista Microsoft.SqlServer.Dacpacs.FabricDw:n uusin versio ja lisää viittaus Project/ItemGroup XML-solmuun. Esimerkiksi:

      <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />
   

   Tältä varaston tietokantaprojektin pitäisi näyttää päivitysten jälkeen.

    <?xml version="1.0" encoding="utf-8"?>
    <Project DefaultTargets="Build">
      <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
      <PropertyGroup>
        <Name>DatabaseProject715wh</Name>
        <ProjectGuid>{2E278BCC-F118-4DDB-9255-94697F2930B4}</ProjectGuid>
        <DSP>Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider</DSP>
        <ModelCollation>1033, CI</ModelCollation>
      </PropertyGroup>
      <ItemGroup>
        <None Include=".vscode\tasks.json" />
        <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />
      </ItemGroup>
      <Target Name="BeforeBuild">
        <Delete Files="$(BaseIntermediateOutputPath)\project.assets.json" />
      </Target>
    </Project>
   

4. Tallenna tiedosto..sqlproj Valitse tietokantaprojektin uudelleenlataamista koskevassa kehotteessa Kyllä.

Tärkeää

Fabric Data Warehouse -tiimi julkaisee usein uusia versioita NuGet-paketeista. Koska tiedoston .sqlproj oletusversioarvot voivat muuttua ajan myötä, muista päivittää ne paikallisessa projektissasi, jotta ne pysyvät linjassa NuGet for Microsoft.SqlServer.Dacpacs.FabricDw:n uusimpien versioiden kanssa.

Tietokantaobjektien lisääminen tai päivittäminen

Voit määrittää tai muokata tietokantaobjekteja, kuten taulukoita, näkymiä, tallennettuja toimintosarjoja ja toimintoja varastoprojektissa.

Lisää tai poista tai tee muutoksia esimerkiksi rakenteen dbokansioon varastossasi olevien objektien T-SQL-määrityksiin. Jos haluat muokata olemassa olevaa objektia, avaa sitä vastaava .sql tiedosto ja päivitä määritys tarvittaessa.

Kun rakennat projektia, kaikki uudet ja päivitetyt objektit tarkistetaan ja sisällytetään luotuun dacpac-tiedostoon tiedostossa {project folder location}/bin/debug/{project name}.dacpac .

Tässä tehdyt muutokset koskevat vain tietokantaprojektia, eivätkä ne näy Microsoft Fabricissa, ennen kuin luot ja julkaiset projektin.

Rakenna ja validoi projekti

1. Avaa tietokantaprojekti, jos sitä ei ole vielä avattu.

2. Napsauta projektia hiiren kakkospainikkeella ja luo tietokantaprojekti valitsemalla Luo.

   

3. Rakentamisen pitäisi olla onnistunut. Korjaa mahdolliset virheet koontitapahtuman tulosteessa annettujen viestien perusteella.

Note

Tällä hetkellä Visual Studio Coden oletuspäätteen on oltava PowerShell , jotta Tietokantaprojektit-laajennuksen koontiprosessi onnistuu. Valitse komentopaletissaPääte: Valitse Oletusprofiili ja valitse sitten PowerShell.

Julkaise Fabric-tietovarastoon

Kun olet rakentanut projektisi, julkaise se kohdevarastossasi. Julkaiseminen luo komentosarjan, joka ratkaisee tietokantaprojektin ja todellisen varaston välisen eron, ja suorittaa komentosarjan, joka saa varaston vastaamaan projektia. Varastorakenteen käännetty malli .dacpac-tiedostossa voidaan ottaa käyttöön kohdevarastossa.

1. Napsauta projektia hiiren kakkospainikkeella ja valitse Julkaise.

2. Valitse Julkaise aiemmin luotuun SQL-palvelimeen.

3. Valitse Valitse ladattava julkaisuprofiili -kohdassa Älä käytä profiilia ensimmäisellä julkaisukerralla.

   • Voit tallentaa vaihtoehdot varaston julkaisemiseksi julkaisuprofiiliin. Kun olet valmis, sinulle annetaan Visual Studio Code -ilmoituksessa mahdollisuus tallentaa juuri käyttämäsi julkaisuasetukset julkaisuprofiilitiedostoon.
   • Voit käyttää julkaisuprofiilia uudelleen tulevaisuudessa, kun julkaiset projektin varastoosi. Sinulla voi olla erilaisia profiilivaihtoehtoja eri varastoille tai eri ympäristöille kehitys-, testaus-, hyväksyntä- ja tuotantokehitysympäristöissä.

4. Valitse luettelosta Fabric Data Warehouse -yhteysprofiili.

5. Valitse kohdevaraston nimi.

6. Valitse toiminto -vaihtoehdossa voit joko Luo komentosarja tarkistaaksesi komentosarjan ennen julkaisemista tai julkaista projektin varastoon.

   • Kun haluat ottaa muutokset käyttöön ensimmäisen kerran, luo komentosarja huolellisesti ja tarkista tuloksena oleva T-SQL, jota käytetään kohdevarastossa. Kohdevarastoon ei tehdä muutoksia.
   • Jos valitset Julkaise, muutokset kirjoitetaan kohdevarastoon.

   

7. Valitse ilmoituksessa Haluatko tallentaa asetukset profiiliin (.publish.xml)?, valitse Kyllä ja tallenna julkaisuprofiilivalinnat seuraavaa julkaisukertaa varten.

Tärkeitä käyttöönottoympäristöjä varastoprojekteille

Kun tietokantaprojekteja otetaan käyttöön Fabric Data Warehouseen, useat asetukset ohjaavat skeemamuutoksia ja voivat vaikuttaa tietoturvaan. Käytä varoen.

• BlockOnPossibleDataLoss

  • Mitä se tekee: Estää käyttöönoton, jos datan menetyksen riski on olemassa (esimerkiksi sarakkeen tai taulukon pudottaminen, joka sisältää dataa).
  • Suositus: Aina tuotannossa True kriittisen datan suojaamiseksi.
  • Varoitus: Sen asettaminen sallii False käyttöönoton, vaikka data voisi kadota. Käytä vain kontrolloiduissa ympäristöissä (esimerkiksi kehitys/testaus).

• DropObjectsNotInSource

  • Mitä se tekee: Pudottaa kohdetietokantaan objekteja, joita ei ole projektin lähteessä.
  • Suositus: Käytä kehitys- ja testausympäristöissä jäljelle jääneiden objektien siivoamiseen.
  • Varoitus: Tuotantokäytössä DropObjectsNotInSource voi poistaa tärkeitä objekteja ja dataa. Tarkista vielä ennen käyttöönottoa.

• Pre-Deployment Scripts

  • Mitä se tekee: Suorittaa mukautettuja SQL-skriptejä ennen skeeman käyttöönottoa.
  • Yleiset käyttötarkoitukset:
    • Arkistoi tai varmuuskopioi tiedot ennen taulukoiden poistamista
    • Poista rajoitukset tai laukaisijat tilapäisesti käytöstä
    • Siivousperintöesineet
  • Varoitus: Varmista, että skriptit ovat idempotentteja , äläkä tee skeemamuutoksia, jotka ovat ristiriidassa käyttöönoton kanssa.

Vihje

Kun käyttöönottoprosessi on idempotentti, sitä voidaan ajaa useita kertoja ilman ongelmia, ja voit ottaa sen käyttöön useisiin tietokantoihin ilman, että niiden tilaa tarvitsee etukäteen määrittää.

• Post-Deployment Scripts

  • Mitä se tekee: Suorittaa mukautettuja SQL-skriptejä skeeman käyttöönoton jälkeen.
  • Yleiset käyttötarkoitukset:
    • Siemenhaku tai viitedata
    • Ota rajoitteet tai laukaisijat uudelleen käyttöön
    • Loki-käyttöönottohistoria
  • Varoitus: Vältä raskaita operaatioita suurilla pöydillä tuotannossa; Varmista, että skriptit voivat turvallisesti pyöriä useita kertoja tarvittaessa.

Tärkeää

Tarkista aina käyttöönottoskriptit ja asetukset ennen julkaisua. Testaa ensin kehitys- ja testausympäristöissä estääksesi tahattoman datan menetyksen.

Vahvista julkaisu

Muodosta yhteys varastoon ja komentosarjaobjekteihin, joita on muutettu, tai tarkista suorittamalla järjestelmäluetteloobjekteja.

Aiheeseen liittyvät artikkelit

• Kehitys- ja käyttöönottotyönkulut
• Kehitä ja ottaa käyttöön varastoinvälisiä riippuvuuksia
• Fabricin käyttöönottoputkien käytön aloittaminen