Kehitä varastoprojekteja Visual Studio Code -ohjelmassa

Sovellettavissa:✅ Varasto Microsoft Fabric

Opi perustamaan tietokantaprojekti Fabric tietovarasto -ohjelmalle Visual Studio Code -ohjelmassa. Luot uuden projektin, määrittelet skeemaobjektit, rakennat ja validoit projektin ja julkaiset sen varastossasi.

Tärkeää

Tämä ominaisuus on esikatselutilassa.

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 alusta alkaen 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 tietovarasto Microsoft Fabric kohdealustaksi.

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

   Tärkeää

   Vain SDK-tyyliset-projektit tuetaan Fabric tietovarasto: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 tietovarasto Microsoft Fabric kohdealustaksi.

6. Valitse pyydettäessä Kyllä (suositus) SDK-tyyliselle projektille. Vain SDK-tyyliset-projektit tuetaan Fabric tietovarasto: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. Syötä profiilinimi. Valitse Parametrit.
   3. Syötä palvelimen nimi. Fabric-portaalissa, varastosi asetuksista , valitse SQL-päätepiste ja kopioi annettu merkkijono. Tämä palvelinnimi on varastollesi 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. Syötä projektin nimi ja valitse projektikansio työasemastasi.

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 purku onnistuu, näet seuraavan ilmoituksen: "Purkaa projektitiedostot: Onnistuttu. 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ä tiedosto sisältää Microsoft:n uusimman version. Build.Sql SDK. Esimerkiksi vaihda tiedoston versio Microsoft.Build.Sql muotoon 2.2.0.sqlproj .

      <Sdk Name="Microsoft.Build.Sql" Version="2.2.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.2.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 tietovarasto -tiimi julkaisee usein uusia versioita NuGet-paketeista. Koska tiedoston oletusversioarvot .sqlproj voivat muuttua ajan myötä, päivitä ne paikallisessa projektissasi, jotta pysyt linjassa NuGet for Microsoft:n uusimpien versioiden kanssa. SqlServer.Dacpacs.FabricDw.

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 se ei ole vielä auki.

2. Napsauta projektia oikealla ja valitse Rakenna , jotta voit rakentaa tietokantaprojektin.

   

3. Rakentamisen pitäisi onnistua. Korjaa mahdolliset virheet, jotka perustuvat build-tapahtuman ulostulossa annettuihin viesteihin.

Note

Tällä hetkellä Visual Studio Code -oletuspäätelaitteen täytyy olla PowerShell, jotta rakennusprosessi Database Projects -laajennuksessa onnistuu. Komentopaletissa valitse Terminaali: Valitse oletusprofiili ja sitten PowerShell.

Julkaise Fabric tietovarasto

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. Voit ottaa kokoelmaskeeman käännetyn mallin käyttöön .dacpac-tiedostona kohdevarastoon.

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.

   • Tallenna vaihtoehtoja varastosi julkaisemiseen julkaisuprofiiliin. Visual Studio Code -ilmoitus antaa mahdollisuuden tallentaa aiemmin käyttämäsi julkaisuasetukset julkaisuprofiilitiedostoon.
   • Käytä 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 tietovarasto -yhteysprofiili.

5. Valitse kohdevaraston nimi.

6. Valitse toiminto -vaihtoehdossa voit joko Luo komentosarja tarkistaaksesi komentosarjan ennen julkaisemista tai julkaista projektin varastoon. - Ensimmäisellä kerralla, kun haluat ottaa muutokset käyttöön, luo huolellisesti skripti ja tarkista syntynyt T-SQL, jotta se voidaan soveltaa kohdevarastoon. Skriptin luominen ei muuta kohdevarastoa.

   • Jos valitset Julkaise, prosessi kirjoittaa muutokset kohdevarastoosi.

   

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 otat käyttöön tietokantaprojekteja Fabric tietovarasto:lle, 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.

• PreDeploy Pre-deployment-skriptille

  • Toiminto
    • 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
  • Varovaisuus
    • Varmista, että skriptit ovat idempotentteja , äläkä tee skeemamuutoksia, jotka ovat ristiriidassa käyttöönoton kanssa.

Vinkki

Kun käyttöönottoprosessi tai kysely on idempotentti, voit suorittaa komennon useita kertoja ilman loogisia ongelmia tai epäonnistumisia. Idempotenttikomento kirjoitetaan myös siten, että se voidaan ottaa käyttöön useisiin tietokantoihin ilman, että niiden tilaa tarvitsee etukäteen määrittää.

• PostDeploy Post-deployment scriptille

  • 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- tai testausympäristöissä estääksesi tahattoman datan menetyksen. Lisätietoja ja esimerkkejä löytyy kohdasta Pre-deployment ja post-deployment scripts for Fabric tietovarasto.

Vahvista julkaisu

Yhdistä varastoosi ja käytä skriptiobjekteja, jotka muuttuivat, tai varmista ajamalla järjestelmäkatalogin objektit.

Liittyvä sisältö

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