Ανάπτυξη έργων αποθήκης στον κώδικα του Visual Studio

Ισχύει για:✅ Warehouse στο Microsoft Fabric

Μάθετε πώς μπορείτε να ρυθμίσετε ένα έργο βάσης δεδομένων για το Fabric Data Warehouse στον κώδικα του Visual Studio. Θα δημιουργήσετε ένα νέο έργο, θα ορίσετε αντικείμενα σχήματος, θα δημιουργήσετε και θα επικυρώσετε το έργο και θα το δημοσιεύσετε στην αποθήκη σας.

Προαπαιτούμενα στοιχεία

Πριν ξεκινήσετε, βεβαιωθείτε ότι:

Έχετε πρόσβαση σε ένα υπάρχον στοιχείο αποθήκης σε έναν χώρο εργασίας Fabric με δικαιώματα Συμβάλλοντα ή υψηλότερα.
- Για να δημιουργήσετε ένα νέο δείγμα αποθήκης, ανατρέξτε στο θέμα Δημιουργία δείγματος αποθήκης στο Microsoft Fabric.
Εγκαταστήστε το Visual Studio Code στο σταθμό εργασίας σας.
Εγκαταστήστε το .NET SDK για να δημιουργήσετε και να δημοσιεύσετε έργα βάσης δεδομένων.
Εγκαταστήστε δύο επεκτάσεις κώδικα του Visual Studio: SQL Database Projects και SQL Server (mssql).
- Μπορείτε να εγκαταστήσετε τις απαιτούμενες επεκτάσεις απευθείας από την αγορά κώδικα του Visual Studio αναζητώντας "SQL Database Projects" ή "SQL Server (mssql)".

Δημιουργία νέου έργου βάσης δεδομένων

Μπορείτε να δημιουργήσετε ένα έργο βάσης δεδομένων από την αρχή ή από υπάρχουσα αποθήκη.

Επιλογή 1: Δημιουργήστε ένα νέο έργο βάσης δεδομένων από την παλέτα εντολών στον κώδικα του Visual Studio

Ανοίξτε τον κώδικα του Visual Studio.
Ανοίξτε την Παλέτα εντολών (Ctrl+Shift+P ή Cmd+Shift+P σε Mac).
Αναζήτηση για έργα βάσης δεδομένων: Νέο.
Επιλέξτε Τύπος έργου βάσης δεδομένων ως Βάση δεδομένων SQL Server.
Επιλέξτε ένα όνομα έργου και επιλέξτε τη θέση του τοπικού φακέλου.
Επιλέξτε Synapse Data Warehouse στο Microsoft Fabric ως πλατφόρμα προορισμού.
Όταν σας ζητηθεί, επιλέξτε Ναι (συνιστάται) για ένα έργο τύπου SDK.

Σημαντικό

Υποστηρίζονται μόνο έργα τύπου SDK για το Fabric Data Warehouse.
Επιλέξτε Ναι στην ερώτηση Θέλετε να ρυθμίσετε τις παραμέτρους της δομής έργου SQL ως την προεπιλεγμένη ρύθμιση παραμέτρων δομής για αυτόν το φάκελο;
Επιλέξτε Ναι για να εμπιστευτείτε τους συντάκτες των αρχείων σε αυτόν το φάκελο.

Επιλογή 2: Δημιουργία νέου έργου βάσης δεδομένων από την επέκταση Έργα βάσης δεδομένων

Στο Visual Studio Code, επιλέξτε το εικονίδιο επέκτασης Database Projects από τη γραμμή δραστηριότητας.
Στο τμήμα παραθύρου Έργα βάσης δεδομένων , επιλέξτε Δημιουργία νέου.
Επιλέξτε Τύπος έργου βάσης δεδομένων ως Βάση δεδομένων SQL Server.
Επιλέξτε ένα όνομα έργου και επιλέξτε τη θέση του τοπικού φακέλου.
Επιλέξτε Synapse Data Warehouse στο Microsoft Fabric ως πλατφόρμα προορισμού.
Όταν σας ζητηθεί, επιλέξτε Ναι (συνιστάται) για ένα έργο τύπου SDK. Υποστηρίζονται μόνο έργα τύπου SDK για το Fabric Data Warehouse.
Επιλέξτε Ναι στην ερώτηση Θέλετε να ρυθμίσετε τις παραμέτρους της δομής έργου SQL ως την προεπιλεγμένη ρύθμιση παραμέτρων δομής για αυτόν το φάκελο;
Επιλέξτε Ναι για να εμπιστευτείτε τους συντάκτες των αρχείων σε αυτόν το φάκελο.

Επιλογή 3: Δημιουργία έργου βάσης δεδομένων από υπάρχουσα αποθήκη

Αρχικά, δημιουργήστε ένα νέο προφίλ σύνδεσης για την αποθήκη σας στον κώδικα του Visual Studio.
1. Επιλέξτε την επέκταση SQL Server στον κώδικα του Visual Studio από τη γραμμή δραστηριότητας.
2. Δώστε ένα όνομα προφίλ. Επιλέξτε Παράμετροι.
3. Δώστε το όνομα διακομιστή. Στην πύλη Fabric, στις Ρυθμίσεις της αποθήκης σας, ανακτήστε τη συμβολοσειρά τελικού σημείου SQL . (Αυτό είναι διαφορετικό από το τελικό σημείο ανάλυσης SQL.) Μοιάζει με <server unique ID>.datawarehouse.fabric.microsoft.com. Αυτό είναι το όνομα διακομιστή.
4. Για τον τύπο ελέγχου ταυτότητας, χρησιμοποιήστε το Microsoft Entra ID - Universal με υποστήριξη MFA. Πραγματοποιήστε έλεγχο ταυτότητας με το Microsoft Entra ID σας.
5. Δώστε άλλες πληροφορίες ως προεπιλεγμένες ή επιθυμητές και επιλέξτε Σύνδεση.
Στο Visual Studio Code, επιλέξτε το εικονίδιο επέκτασης Database Projects από τη γραμμή δραστηριότητας.
Επιλέξτε το κουμπί ... επιλογών από το παράθυρο Έργα βάσης δεδομένων και επιλέξτε Δημιουργία έργου από βάση δεδομένων .
Επιλέξτε την αποθήκη σας από τα υπάρχοντα προφίλ σύνδεσης.
Δώστε ένα όνομα έργου και επιλέξτε ένα φάκελο έργου στο σταθμό εργασίας σας.
Για τη δομή φακέλου, επιλέξτε Σχήμα/Τύπος αντικειμένου (συνιστάται).
Για τη Συμπερίληψη δικαιωμάτων στο έργο, επιλέξτε Όχι (προεπιλογή).
Για έργο τύπου SDK, επιλέξτε Ναι (συνιστάται).
Επιλέξτε Ναι στην ερώτηση Θέλετε να ρυθμίσετε τις παραμέτρους της δομής έργου SQL ως την προεπιλεγμένη ρύθμιση παραμέτρων δομής για αυτόν το φάκελο;
Το Visual Studio Code εξάγει αρχεία έργου από το έργο αποθήκης.
Μετά την επιτυχή εξαγωγή, θα δείτε την ακόλουθη ειδοποίηση: "Εξαγωγή αρχείων έργου: Επιτυχής. Ολοκληρώθηκε".
Επιλέξτε Ναι για να εμπιστευτείτε τους συντάκτες των αρχείων σε αυτόν το φάκελο.

Νέο έργο βάσης δεδομένων για την αποθήκη σας

Το νέο έργο βάσης δεδομένων για την αποθήκη σας εμφανίζεται στο μενού Έργα βάσης δεδομένων SQL.

Στιγμιότυπο οθόνης από τον κώδικα του Visual Studio που δείχνει το νέο έργο βάσης δεδομένων για το AdventureWorksDW2022.

Η δομή του έργου σας μοιάζει με αυτό:

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

Ρύθμιση παραμέτρων του έργου βάσης δεδομένων

Κάντε δεξί κλικ στο έργο και επιλέξτε Επεξεργασία αρχείου .sqlproj.
Βεβαιωθείτε ότι η πιο πρόσφατη έκδοση του Microsoft.Build.Sql SDK βρίσκεται στο αρχείο. Για παράδειγμα, στο .sqlproj αρχείο, αλλάξτε την έκδοση για Microsoft.Build.Sql σε 2.0.0.
```
   <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
```

Επαληθεύστε την πιο πρόσφατη έκδοση του Microsoft.SqlServer.Dacpacs.FabricDw και προσθέστε μια αναφορά μέσα στον Project/ItemGroup κόμβο XML. Για παράδειγμα:

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

Έτσι θα πρέπει να μοιάζει το έργο της βάσης δεδομένων σας για μια αποθήκη μετά τις ενημερώσεις.

 <?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>

Αποθηκεύστε το αρχείο σας .sqlproj . Στην προτροπή για επαναφόρτωση του έργου βάσης δεδομένων, επιλέξτε Ναι.

Σημαντικό

Η ομάδα του Fabric Data Warehouse κυκλοφορεί συχνά νέες εκδόσεις των πακέτων NuGet. Δεδομένου ότι οι προεπιλεγμένες τιμές έκδοσης στο αρχείο μπορούν να αλλάξουν με την .sqlproj πάροδο του χρόνου, φροντίστε να τις ενημερώσετε στο τοπικό σας έργο για να παραμείνετε ευθυγραμμισμένες με τις πιο πρόσφατες εκδόσεις που είναι διαθέσιμες από το NuGet για Microsoft.SqlServer.Dacpacs.FabricDw.

Προσθήκη ή ενημέρωση αντικειμένων βάσης δεδομένων

Μπορείτε να ορίσετε ή να τροποποιήσετε αντικείμενα βάσης δεδομένων, όπως πίνακες, προβολές, αποθηκευμένες διαδικασίες και συναρτήσεις στο έργο αποθήκης σας.

Κάτω από το φάκελο για ένα σχήμα, για παράδειγμα dbo, προσθέστε ή διαγράψτε ή κάντε αλλαγές στους ορισμούς T-SQL των αντικειμένων στην αποθήκη σας. Για να τροποποιήσετε ένα υπάρχον αντικείμενο, ανοίξτε το αντίστοιχο .sql αρχείο του και ενημερώστε τον ορισμό όπως απαιτείται.

Όταν δημιουργείτε το έργο, όλα τα νέα και ενημερωμένα αντικείμενα επικυρώνονται και περιλαμβάνονται στο αρχείο dacpac που {project folder location}/bin/debug/{project name}.dacpac δημιουργήθηκε.

Οι αλλαγές που γίνονται εδώ αφορούν μόνο το έργο βάσης δεδομένων και δεν αντικατοπτρίζονται στο Microsoft Fabric μέχρι να δημιουργήσετε και να δημοσιεύσετε το έργο σας.

Δημιουργήστε και επικυρώστε το έργο

Ανοίξτε το έργο βάσης δεδομένων εάν δεν έχει ήδη ανοιχτεί.
Κάντε δεξί κλικ στο έργο και επιλέξτε Δημιουργία για να δημιουργήσετε το έργο βάσης δεδομένων.
Η κατασκευή πρέπει να είναι επιτυχής. Διορθώστε τυχόν σφάλματα με βάση τα μηνύματα που παρέχονται στην έξοδο του συμβάντος κατασκευής.

Σημείωμα

Προς το παρόν, το προεπιλεγμένο τερματικό του Visual Studio Code πρέπει να είναι το PowerShell για να είναι επιτυχής η διαδικασία δημιουργίας στην επέκταση Database Projects. Στην Παλέτα εντολών, επιλέξτε Τερματικό: Επιλέξτε Προεπιλεγμένο προφίλ και, στη συνέχεια, επιλέξτε PowerShell.

Δημοσίευση στην αποθήκη δεδομένων Fabric

Αφού δημιουργήσετε το έργο σας, δημοσιεύστε το στην αποθήκη-στόχο σας. Η δημοσίευση δημιουργεί μια δέσμη ενεργειών για την επίλυση της διαφοράς μεταξύ του έργου βάσης δεδομένων και της πραγματικής αποθήκης και εκτελεί μια δέσμη ενεργειών για να κάνει την αποθήκη να ταιριάζει με το έργο. Το μεταγλωττισμένο μοντέλο του σχήματος αποθήκης σε ένα αρχείο .dacpac μπορεί να αναπτυχθεί σε μια αποθήκη προορισμού.

Κάντε δεξί κλικ στο έργο και επιλέξτε Δημοσίευση.
Επιλέξτε Δημοσίευση σε υπάρχοντα διακομιστή SQL.
Για την επιλογή δημοσίευσης προφίλ για φόρτωση, την πρώτη φορά που θα δημοσιεύσετε, επιλέξτε Να μην χρησιμοποιείται προφίλ.
- Μπορείτε να αποθηκεύσετε επιλογές για τη δημοσίευση της αποθήκης σας σε ένα προφίλ δημοσίευσης. Όταν ολοκληρώσετε, σας δίνεται η επιλογή σε μια ειδοποίηση κώδικα του Visual Studio να αποθηκεύσετε τις επιλογές δημοσίευσης που μόλις χρησιμοποιήσατε σε ένα αρχείο προφίλ δημοσίευσης.
- Μπορείτε να χρησιμοποιήσετε ξανά το προφίλ δημοσίευσης στο μέλλον όταν δημοσιεύσετε το έργο σας στην αποθήκη σας. Μπορεί να έχετε διαφορετικές επιλογές προφίλ για διαφορετικές αποθήκες ή για διαφορετικά περιβάλλοντα στα περιβάλλοντα ανάπτυξης/δοκιμής/αποδοχής/ανάπτυξης παραγωγής.
Επιλέξτε το προφίλ σύνδεσης Fabric Data Warehouse από τη λίστα.
Επιλέξτε το όνομα της αποθήκης προορισμού.
Στην επιλογή Επιλογή ενέργειας , μπορείτε είτε να δημιουργήσετε δέσμη ενεργειών για να αναθεωρήσετε τη δέσμη ενεργειών πριν από τη δημοσίευση είτε να δημοσιεύσετε το έργο σε μια αποθήκη.
- Την πρώτη φορά που θέλετε να αναπτύξετε αλλαγές, θα πρέπει να δημιουργήσετε προσεκτικά το σενάριο και να ελέγξετε το T-SQL που προκύπτει που θα εφαρμοστεί στην αποθήκη προορισμού. Δεν γίνονται αλλαγές στην αποθήκη προορισμού.
- Εάν επιλέξετε Δημοσίευση, οι αλλαγές θα εγγραφούν στην αποθήκη προορισμού σας.
Στην ειδοποίηση Θέλετε να αποθηκεύσετε τις ρυθμίσεις σε ένα προφίλ (.publish.xml);, επιλέξτε Ναι και αποθηκεύστε τις επιλογές δημοσίευσης του προφίλ σας για την επόμενη φορά που θα χρειαστεί να δημοσιεύσετε.

Σημαντικές ρυθμίσεις ανάπτυξης για έργα αποθήκης

Κατά την ανάπτυξη έργων βάσης δεδομένων στο Fabric Data Warehouse, πολλές ρυθμίσεις ελέγχουν τις αλλαγές σχήματος και μπορούν να επηρεάσουν την ασφάλεια των δεδομένων. Χρησιμοποιήστε με προσοχή.

BlockOnPossibleDataLoss
- Τι κάνει: Αποτρέπει την ανάπτυξη εάν υπάρχει κίνδυνος απώλειας δεδομένων (για παράδειγμα, απόθεση στήλης ή πίνακα που περιέχει δεδομένα).
- Σύσταση: Πάντα ρυθμισμένο σε True in production για την προστασία κρίσιμων δεδομένων.
- Προσοχή: Η ρύθμισή του επιτρέπει την False ανάπτυξη ακόμα και αν τα δεδομένα μπορεί να χαθούν. Χρησιμοποιήστε μόνο σε ελεγχόμενα περιβάλλοντα (για παράδειγμα, dev/test).
DropObjectsNotInSource
- Τι κάνει: Απορρίπτει αντικείμενα στη βάση δεδομένων προορισμού που δεν υπάρχουν στην προέλευση του έργου.
- Σύσταση: Χρησιμοποιήστε το σε περιβάλλοντα ανάπτυξης/δοκιμής για να καθαρίσετε αντικείμενα που έχουν απομείνει.
- Προσοχή: Η χρήση DropObjectsNotInSource στην παραγωγή μπορεί να διαγράψει σημαντικά αντικείμενα και δεδομένα. Ελέγξτε ξανά πριν την ενεργοποίηση.
Pre-Deployment Scripts
- Τι κάνει: Εκτελεί προσαρμοσμένες δέσμες ενεργειών SQL πριν από την ανάπτυξη του σχήματος.
- Κοινές χρήσεις:
  - Αρχειοθετήστε ή δημιουργήστε αντίγραφα ασφαλείας δεδομένων πριν από την απόρριψη πινάκων
  - Απενεργοποιήστε προσωρινά περιορισμούς ή εναύσματα
  - Εκκαθάριση αντικειμένων παλαιού τύπου
- Προσοχή: Βεβαιωθείτε ότι οι δέσμες ενεργειών είναι ανίκανες και δεν εισάγουν αλλαγές σχήματος που έρχονται σε διένεξη με την ανάπτυξη.

Tip

Όταν μια διαδικασία ανάπτυξης είναι ανίκανη, μπορεί να εκτελεστεί πολλές φορές χωρίς να προκαλέσει προβλήματα και μπορείτε να την αναπτύξετε σε πολλές βάσεις δεδομένων χωρίς να χρειάζεται να προκαθορίσετε την κατάστασή τους.

Post-Deployment Scripts
- Τι κάνει: Εκτελεί προσαρμοσμένες δέσμες ενεργειών SQL μετά την ανάπτυξη του σχήματος.
- Κοινές χρήσεις:
  - Αρχική αναζήτηση ή δεδομένα αναφοράς
  - Εκ νέου ενεργοποίηση περιορισμών ή εναυσμάτων
  - Ιστορικό ανάπτυξης αρχείων καταγραφής
- Προσοχή: Αποφύγετε τις βαριές εργασίες σε μεγάλα τραπέζια στην παραγωγή. Βεβαιωθείτε ότι τα σενάρια μπορούν να εκτελεστούν με ασφάλεια πολλές φορές, εάν χρειαστεί.

Σημαντικό

Να ελέγχετε πάντα τις δέσμες ενεργειών και τις ρυθμίσεις ανάπτυξης πριν από τη δημοσίευση. Δοκιμάστε πρώτα σε περιβάλλοντα ανάπτυξης/δοκιμής για να αποτρέψετε την ακούσια απώλεια δεδομένων.

Επαλήθευση δημοσίευσης

Συνδεθείτε στην αποθήκη σας και δέστε σενάρια αντικειμένων που άλλαξαν ή επαληθεύτηκαν εκτελώντας αντικείμενα καταλόγου συστήματος.

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2025-11-19