Entwickeln von Lagerprojekten in Visual Studio Code

Gilt für:✅ Warehouse in Microsoft Fabric

Erfahren Sie, wie Sie ein Datenbankprojekt für Fabric Data Warehouse in Visual Studio Code einrichten. Sie erstellen ein neues Projekt, definieren Schemaobjekte, erstellen und validieren das Projekt und veröffentlichen es in Ihrem Lager.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

• Stellen Sie sicher, dass Sie Zugang zu einem bestehenden Warenbestandselement in einem Fabric-Arbeitsbereich mit Berechtigungen als Mitwirkender oder höher haben.
  • Informationen zum Erstellen eines neuen Beispiellagers finden Sie unter Erstellen eines Beispiellagers in Microsoft Fabric.
• Installieren Sie Visual Studio Code auf Ihrer Arbeitsstation.
• Installieren Sie das .NET SDK zum Erstellen und Veröffentlichen von Datenbankprojekten.
• Installieren Sie zwei Visual Studio Code-Erweiterungen: SQL-Datenbankprojekte und SQL Server (mssql).
  • Sie können die erforderlichen Erweiterungen direkt aus dem Visual Studio Code Marketplace installieren, indem Sie nach "SQL-Datenbankprojekte" oder "SQL Server (mssql)" suchen.

Erstellen eines neuen Datenbankprojekts

Sie können ein Datenbankprojekt von Grund auf neu erstellen oder aus einem bestehenden Datenlager.

Option 1: Erstellen eines neuen Datenbankprojekts aus der Befehlspalette in Visual Studio Code

1. Öffnen Sie Visual Studio Code.

2. Öffnen Sie die Befehlspalette (Ctrl+Shift+P oder Cmd+Shift+P auf dem Mac).

3. Nach Datenbankprojekten suchen: Neu.

4. Wählen Sie den Datenbankprojekttyp als SQL Server-Datenbank aus.

5. Wählen Sie einen Projektnamen aus, und wählen Sie den lokalen Ordnerspeicherort aus.

6. Wählen Sie Synapse Data Warehouse in Microsoft Fabric als Zielplattform aus.

7. Wenn Sie dazu aufgefordert werden, wählen Sie "Ja" (empfohlen) für ein SDK-Formatprojekt aus.

   Von Bedeutung

   Nur SDK-Stilprojekte werden für Fabric Data Warehouse unterstützt.

8. Wählen Sie Ja für die Frage Möchten Sie den SQL-Projektbuild als Standard-Buildkonfiguration für diesen Ordner festlegen?

9. Wählen Sie "Ja " aus, um den Autoren der Dateien in diesem Ordner zu vertrauen.

Option 2: Erstellen eines neuen Datenbankprojekts aus der Erweiterung "Datenbankprojekte"

1. Wählen Sie in Visual Studio Code das Erweiterungssymbol " Datenbankprojekte " in der Aktivitätsleiste aus.

2. Wählen Sie im Bereich "Datenbankprojekte " die Option "Neu erstellen" aus.

   

3. Wählen Sie den Datenbankprojekttyp als SQL Server-Datenbank aus.

4. Wählen Sie einen Projektnamen aus, und wählen Sie den lokalen Ordnerspeicherort aus.

5. Wählen Sie Synapse Data Warehouse in Microsoft Fabric als Zielplattform aus.

6. Wenn Sie dazu aufgefordert werden, wählen Sie "Ja" (empfohlen) für ein SDK-Formatprojekt aus. Nur SDK-Stilprojekte werden für Fabric Data Warehouse unterstützt.

7. Wählen Sie Ja für die Frage Möchten Sie den SQL-Projektbuild als Standard-Buildkonfiguration für diesen Ordner festlegen?

8. Wählen Sie "Ja " aus, um den Autoren der Dateien in diesem Ordner zu vertrauen.

Option 3: Erstellen eines Datenbankprojekts aus einem vorhandenen Lagerhaus

1. Erstellen Sie zunächst ein neues Verbindungsprofil für Ihr Lager in Visual Studio Code.

   1. Wählen Sie die SQL Server-Erweiterung in Visual Studio Code in der Aktivitätsleiste aus.
   2. Geben Sie einen Profilnamen an. Wählen Sie "Parameter" aus.
   3. Geben Sie den Servernamen an. Rufen Sie im Fabric-Portal in den Einstellungen Ihres Lagers die SQL-Endpunktzeichenfolge ab. (Dies unterscheidet sich vom SQL-Analyseendpunkt.) Es sieht wie <server unique ID>.datawarehouse.fabric.microsoft.comaus. Dies ist der Servername.
   4. Verwenden Sie für den AuthentifizierungstypMicrosoft Entra ID – Universal mit MFA-Unterstützung. Authentifizieren Sie sich mit Ihrer Microsoft Entra-ID.
   5. Geben Sie andere Informationen als Standard oder gewünschte Informationen an, und wählen Sie "Verbinden" aus.

2. Wählen Sie in Visual Studio Code das Erweiterungssymbol " Datenbankprojekte " in der Aktivitätsleiste aus.

3. Wählen Sie im Bereich ..." die Optionsschaltfläche und dann die Option "Projekt aus Datenbank erstellen" aus.

   

4. Wählen Sie Ihr Lager aus den vorhandenen Verbindungsprofilen aus.

5. Geben Sie einen Projektnamen an, und wählen Sie einen Projektordner auf Ihrer Arbeitsstation aus.

6. Wählen Sie für die Ordnerstruktur schema/Objekttyp (empfohlen) aus.

7. Wählen Sie für "Berechtigungen in Projekt einschließen" die Option "Nein " (Standardeinstellung) aus.

8. Wählen Sie für DAS SDK-Projekt "Ja" (empfohlen) aus.

9. Wählen Sie Ja für die Frage Möchten Sie den SQL-Projektbuild als Standard-Buildkonfiguration für diesen Ordner festlegen?

10. Visual Studio Code extrahiert Projektdateien aus dem Lagerprojekt.

    

11. Nach erfolgreichem Extrahieren wird die folgende Benachrichtigung angezeigt: "Projektdateien extrahieren: Erfolgreich. Abgeschlossen".

12. Wählen Sie "Ja " aus, um den Autoren der Dateien in diesem Ordner zu vertrauen.

Neues Datenbankprojekt für Ihr Lager

Das neue Datenbankprojekt für Ihr Lager wird im Menü "SQL-Datenbankprojekte" angezeigt.

Ihre Projektstruktur sieht wie folgt aus:

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

Konfigurieren des Datenbankprojekts

1. Klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie "SQLPROJ-Datei bearbeiten" aus.

   

2. Überprüfen Sie, ob sich die neueste Version des Microsoft.Build.Sql SDK in der Datei befindet. Ändern Sie z. B. in der .sqlproj Datei die Version von Microsoft.Build.Sql auf 2.0.0.

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

3. Überprüfen Sie die neueste Version von Microsoft.SqlServer.Dacpacs.FabricDw, und fügen Sie einen Verweis innerhalb des Project/ItemGroup XML-Knotens hinzu. Beispiel:

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

   So sollte Ihr Datenbankprojekt für ein Lager nach den Updates aussehen.

    <?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. Speichern Sie Ihre .sqlproj Datei. Wählen Sie auf der Eingabeaufforderung, um Ihr Datenbankprojekt neu zu laden, "Ja" aus.

Von Bedeutung

Das Fabric Data Warehouse-Team veröffentlicht häufig neue Versionen von NuGet-Paketen. Da sich die Standardversionswerte in der Datei im Laufe der .sqlproj Zeit ändern können, müssen Sie sie in Ihrem lokalen Projekt aktualisieren, um mit den neuesten Versionen in Einklang zu bleiben, die über nuGet für Microsoft.SqlServer.Dacpacs.FabricDw verfügbar sind.

Hinzufügen oder Aktualisieren von Datenbankobjekten

Sie können Datenbankobjekte wie Tabellen, Ansichten, gespeicherte Prozeduren und Funktionen innerhalb Ihres Lagerprojekts definieren oder ändern.

Unter dem Ordner für ein Schema, z. B. dbo, können Sie die T-SQL-Definitionen von Objekten in Ihrem Datenlager hinzufügen, löschen oder ändern. Um ein vorhandenes Objekt zu ändern, öffnen Sie die entsprechende .sql Datei, und aktualisieren Sie die Definition nach Bedarf.

Wenn Sie das Projekt erstellen, werden alle neuen und aktualisierten Objekte überprüft und in die generierte dacpac-Datei in {project folder location}/bin/debug/{project name}.dacpac der Datei eingeschlossen.

Änderungen, die hier vorgenommen wurden, sind nur für das Datenbankprojekt vorgesehen und werden erst dann in Microsoft Fabric wiedergegeben, wenn Sie Ihr Projekt erstellen und veröffentlichen .

Erstellen und Überprüfen des Projekts

1. Öffnen Sie das Datenbankprojekt, wenn es noch nicht geöffnet wurde.

2. Klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie "Erstellen" aus, um das Datenbankprojekt zu erstellen.

   

3. Der Build sollte erfolgreich sein. Beheben Sie alle Fehler basierend auf Nachrichten, die in der Build-Ereignis-Ausgabe angegeben sind.

Hinweis

Derzeit muss Ihr Visual Studio Code-Standardterminal PowerShell sein, damit der Buildprozess in der Erweiterung "Datenbankprojekte" erfolgreich ausgeführt werden kann. Wählen Sie in der Befehlspalette"Terminal: Standardprofil" und dann "PowerShell" aus.

Veröffentlichen in Fabric Data Warehouse

Nachdem Sie Ihr Projekt erstellt haben, veröffentlichen Sie es in Ihrem Ziellager. Die Veröffentlichung erstellt ein Skript, um den Unterschied zwischen dem Datenbankprojekt und dem tatsächlichen Lager zu beheben, und führt ein Skript aus, um das Lager mit dem Projekt abzugleichen. Das kompilierte Modell des Lagerschemas in einer DACPAC-Datei kann in einem Ziellager bereitgestellt werden.

1. Klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie "Veröffentlichen" aus.

2. Wählen Sie "Auf einem vorhandenen SQL-Server veröffentlichen" aus.

3. Wählen Sie zum Laden des zu ladenden Veröffentlichungsprofils die Option "Profil nicht verwenden" aus, wenn Sie es zum ersten Mal veröffentlichen.

   • Sie können Optionen zum Veröffentlichen Ihres Lagers in einem Veröffentlichungsprofil speichern. Wenn Sie fertig sind, haben Sie die Möglichkeit in einer Visual Studio Code-Benachrichtigung, die Veröffentlichungsoptionen zu speichern, die Sie gerade für eine Veröffentlichungsprofildatei verwendet haben.
   • Sie können das Veröffentlichungsprofil in Zukunft wiederverwenden, wenn Sie Ihr Projekt in Ihrem Lager veröffentlichen. Möglicherweise haben Sie unterschiedliche Profiloptionen für verschiedene Lagerstätten oder für unterschiedliche Umgebungen in Ihren Entwicklungs-/Test-/Akzeptanz-/Produktionsentwicklungsumgebungen.

4. Wählen Sie das Fabric Data Warehouse-Verbindungsprofil aus der Liste aus.

5. Wählen Sie den Namen des Ziellagers aus.

6. In der Option "Aktion auswählen " können Sie entweder Skript generieren , um das Skript vor der Veröffentlichung zu überprüfen oder projekt in einem Lager zu veröffentlichen.

   • Wenn Sie Zum ersten Mal Änderungen bereitstellen möchten, sollten Sie das Skript sorgfältig generieren und die resultierende T-SQL überprüfen, die auf das Ziellager angewendet werden soll. Am Ziellager werden keine Änderungen vorgenommen.
   • Wenn Sie Veröffentlichen auswählen, werden Änderungen in Ihr Zieldatenlager geschrieben.

   

7. Wählen Sie in der Benachrichtigung Möchten Sie die Einstellungen in einem Profil (.publish.xml) speichern?, wählen Sie Ja aus, und speichern Sie Ihre Veröffentlichungsprofiloptionen für das nächste Mal, wenn Sie veröffentlichen müssen.

Wichtige Bereitstellungseinstellungen für Lagerprojekte

Bei der Bereitstellung von Datenbankprojekten auf Fabric Data Warehouse steuern mehrere Einstellungen die Schemaänderungen und können die Datensicherheit beeinflussen. Verwenden Sie vorsichtig.

• BlockOnPossibleDataLoss

  • Funktionsweise: Verhindert die Bereitstellung, wenn das Risiko eines Datenverlusts besteht (z. B. ablegen einer Spalte oder Tabelle, die Daten enthält).
  • Empfehlung: In der Produktionsumgebung immer auf True einstellen, um kritische Daten zu schützen.
  • Vorsicht: Wenn es auf False festgelegt wird, ist die Bereitstellung auch dann möglich, wenn Daten verloren gehen können. Verwenden Sie nur in kontrollierten Umgebungen (z. B. Dev/Test).

• DropObjectsNotInSource

  • Funktionsweise: Legt Objekte in der Zieldatenbank ab, die in der Projektquelle nicht vorhanden sind.
  • Empfehlung: Verwenden Sie Entwicklungs-/Testumgebungen, um übrig gebliebene Objekte zu bereinigen.
  • Vorsicht: Die Verwendung DropObjectsNotInSource in der Produktion kann wichtige Objekte und Daten löschen. Überprüfen Sie, bevor Sie dies aktivieren.

• Pre-Deployment Scripts

  • Funktionsweise: Führt benutzerdefinierte SQL-Skripts vor der Schemabereitstellung aus.
  • Häufig verwendete Verwendungen:
    • Archiven oder Sichern von Daten vor dem Ablegen von Tabellen
    • Deaktivieren von Einschränkungen oder Triggern vorübergehend
    • Bereinigen von Legacyobjekten
  • Vorsicht: Stellen Sie sicher, dass Skripts idempotent sind und keine Schemaänderungen einführen, die mit der Bereitstellung in Konflikt stehen.

Tipp

Wenn ein Bereitstellungsprozess idempotent ist, kann er mehrmals ausgeführt werden, ohne Probleme zu verursachen, und Sie können in mehreren Datenbanken bereitstellen, ohne den Status vorher festzulegen.

• Post-Deployment Scripts

  • Funktionsweise: Führt benutzerdefinierte SQL-Skripts nach der Schemabereitstellung aus.
  • Häufig verwendete Verwendungen:
    • Saat-Nachschlage- oder Referenzdaten
    • Erneutes Aktivieren von Einschränkungen oder Triggern
    • Einsatzprotokollverlauf
  • Vorsicht: Vermeiden Sie schwere Vorgänge auf großen Tischen in der Produktion; stellen Sie sicher, dass Skripts bei Bedarf mehrmals ausgeführt werden können.

Von Bedeutung

Überprüfen Sie vor der Veröffentlichung immer Bereitstellungsskripts und -einstellungen. Testen Sie zuerst in Entwicklungs-/Testumgebungen, um unbeabsichtigten Datenverlust zu verhindern.

Veröffentlichung überprüfen

Stellen Sie eine Verbindung mit Ihren Lager- und Skriptobjekten her, die geändert wurden, oder überprüfen Sie, indem Sie Systemkatalogobjekte ausführen.

Verwandte Artikel

• Entwicklungs- und Bereitstellungsworkflows
• Entwickeln und Bereitstellen von lagerübergreifenden Abhängigkeiten
• Einstieg in die Nutzung von Fabric-Implementierungspipelines