Kehitä varastoprojekteja Visual Studio Code -ohjelmassa

Sovellettavissa:✅ Varasto Microsoft Fabric

Opi perustamaan tietokantaprojekti Fabric Data Warehouse -ohjelmalle Visual Studio Code -ohjelmassa. 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.
  • Uuden näytevaraston luomiseksi katso Luo näytevarasto Microsoft Fabric.
• Asenna Visual Studio Code työasemallesi.
• Asenna .NET SDK rakentaaksesi ja julkaisaksesi tietokantaprojekteja.
• Asenna kaksi Visual Studio Code-laajennusta: SQL Database Projects ja SQL Server (mssql).
  • Voit asentaa tarvittavat laajennukset suoraan Visual Studio Code -markkinapaikalta 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 komentopaletista Visual Studio Code

1. Avaa Visual Studio Code.

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

3. Hae tietokantaprojekteja: Uusi.

4. Valitse Database Project Type muodossa SQL Server Database.

5. Valitse projektin nimi ja valitse paikallisen kansion sijainti.

6. Valitse Synapse Data Warehouse Microsoft Fabric kohdealustaksi.

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

   Tärkeää

   Vain SDK-tyyliset-projektit tuetaan Fabric Data Warehouse:lle.

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. Vuonna Visual Studio Code valitse Database Projects -laajennuskuvake Activity Bar:sta.

2. Valitse Tietokantaprojektit-ruudussaLuo uusi.

   

3. Valitse Database Project Type muodossa SQL Server Database.

4. Valitse projektin nimi ja valitse paikallisen kansion sijainti.

5. Valitse Synapse Data Warehouse Microsoft Fabric kohdealustaksi.

6. Valitse pyydettäessä Kyllä (suositus) SDK-tyyliselle projektille. Vain SDK-tyyliset-projektit tuetaan Fabric Data Warehouse:lle.

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. Ensiksi luo uusi yhteysprofiili varastollesi Visual Studio Code -ohjelmassa.

   1. Valitse SQL Server-laajennus Visual Studio Code:ssa Activity Bar -palkista.
   2. Anna profiilin nimi. Valitse Parametrit.
   3. Anna palvelimen nimi. Fabric-portaalissa, varastosi asetuksista , valitse SQL-päätepiste ja kopioi annettu merkkijono. Tämä on varastosi palvelimen nimi ja eroaa SQL-analytiikan päätepisteestä. Näyttää siltä kuin <server unique ID>.datawarehouse.fabric.microsoft.com.
   4. Todennustyyppi varten käytä Microsoft Entra ID - Universal MFA-tuella. Tunnista Microsoft Entra ID:lläsi.
   5. Anna muut tiedot oletuksena tai haluttuna ja valitse Yhdistä.

2. Vuonna Visual Studio Code valitse Database Projects -laajennuskuvake Activity Barista.

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

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ä näy Microsoft Fabric ennen kuin Build ja Publish projektisi.

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.

Julkaise Fabric Data Warehouse

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, saat Visual Studio Code -ilmoituksessa mahdollisuuden tallentaa juuri käyttämäsi julkaisuasetukset julkaisuprofiilitiedostoon.
   • Voit käyttää julkaisuprofiilia uudelleen tulevaisuudessa, kun julkaiset projektisi varastossasi. Sinulla voi olla erilaisia profiilivaihtoehtoja eri varastoille tai eri ympäristöille kehitys-, testaus-, hyväksyntä- ja tuotantokehitysympäristöissä.

4. Valitse listasta 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 Warehouse, useat asetukset ohjaavat skeeman muutoksia 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.

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

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