Dela via

SQL Database Projects-tillägg

Viktigt!

Azure Data Studio går i pension den 28 februari 2026. Vi rekommenderar att du använder Visual Studio Code. Mer information om hur du migrerar till Visual Studio Code finns i Vad händer med Azure Data Studio?

SQL Database Projects-tillägget är ett Visual Studio Code-tillägg för utveckling av SQL-databaser i en projektbaserad utvecklingsmiljö. Kompatibla databaser är SQL Server, Azure SQL Database, Azure SQL Managed Instance, Warehouse in Fabric och SQL Database i Fabric. Ett SQL-projekt är en lokal representation av SQL-objekt som utgör schemat för en enskild databas, till exempel tabeller, lagrade procedurer eller funktioner. När du skapar ett SQL Database-projekt skapar du en .dacpac fil. Du kan uppdatera nya och befintliga databaser så att de matchar innehållet i .dacpac genom att publicera SQL Database-projektet med SQL Database Projects-tillägget eller genom att publicera .dacpac med sqlPackage-kommandoradsgränssnittet .

Skärmbild av sammanfattning av SQL Database Projects som innehåller fördistributions- och efterdistributionsskript samt databasobjekt.

Mer information om begrepp för SQL-projekt finns i Vad är SQL-databasprojekt?

Tilläggsfunktioner

SQL Database Projects-tillägget innehåller följande funktioner:

  • Skapa ett nytt tomt Microsoft.Build.Sql-projekt.
  • Skapa ett nytt projekt från en ansluten databas.
  • Öppna ett projekt som tidigare skapats i Visual Studio Code eller i SQL Server Data Tools.
  • Redigera ett projekt genom att lägga till eller ta bort objekt (tabeller, vyer, lagrade procedurer) eller anpassade skript i projektet.
  • Organisera filer och skript i mappar.
  • Lägg till referenser till systemdatabaser eller en användar-dacpac.
  • Skapa ett enda projekt.
  • Implementera ett enskilt projekt.
  • Läs in anslutningsinformation (SQL Windows-autentisering) och SQLCMD-variabler från distributionsprofilen.

Install

Du kan installera SQL Database Project-tillägget i Visual Studio Code.

SQL Database Projects-tillägget installeras med mssql-tillägget för Visual Studio Code.

Beroenden

SQL Database Projects-tillägget beror på .NET SDK (krävs) och AutoRest.Sql (valfritt).

.NET SDK

Tillägget kräver .NET SDK för projektversionsfunktioner. Om tillägget inte kan identifiera en version som stöds uppmanas du att installera .NET SDK. Du kan ladda ned och installera .NET SDK för Windows, macOS och Linux.

Om du vill kontrollera installerade versioner av dotnet SDK öppnar du en terminal och kör följande kommando:

dotnet --list-sdks

När du har installerat .NET SDK är din miljö redo att använda SQL Database Projects-tillägget.

Vanliga problem

  • Om nuget.org saknas i listan över källor kan det resultera i felmeddelanden som:

    • error MSB4236: The SDK 'Microsoft.Build.Sql/0.1.9-preview' specified could not be found.

    • Unable to find package Microsoft.Build.Sql. No packages exist with this id in source(s): Microsoft Visual Studio Offline Packages

    Om du vill kontrollera om nuget.org är registrerad som källa kör dotnet nuget list source du från kommandoraden och granskar resultatet för ett [Enabled] objekt som refererar till nuget.org. Om nuget.org inte är registrerad som källa kör du dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

  • .NET SDK-versioner som inte stöds kan resultera i felmeddelanden som:

    • error MSB4018: The "SqlBuildTask" task failed unexpectedly.

    • error MSB4018: System.TypeInitializationException: The type initializer for 'SqlSchemaModelStaticState' threw an exception. ---> System.IO.FileNotFoundException: Could not load file or assembly 'System.Runtime, Version=4.2.2.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'. The system cannot find the file specified. [c:\Users\ .sqlproj]_ (där den länkade nonexisting-filen har en omatchad avslutande hakparentes).

    Du kan tvinga SQL Database Projects-tillägget att använda v6.x-versionen av .NET SDK när flera versioner är installerade. Det gör du genom att lägga till en global.json fil i mappen som innehåller SQL-projektet.

Mer information om hur du felsöker SQL-projektversion finns i Felsöka SQL-projektversion.

SQLCLR

Visual Studio Code stöder inte SQLCLR-objekt i databasprojekt eftersom dessa objekt förlitar sig på .NET Framework och SQL Database Projects-tillägget använder .NET för att skapa projekt.

Workspace

SQL-databasprojekt finns i en logisk arbetsyta (mapp) i Visual Studio Code. Som standard kan du komma åt alla SQL-projekt i mapparna som är öppna i den aktuella arbetsytan i vyn SQL Database Projects .

Du kan lägga till och ta bort projekt manuellt från en arbetsyta via gränssnittet i fönstret Projekt . Du kan redigera inställningarna för en arbetsyta i .code-workspace filen manuellt om det behövs.

I följande exempelfil .code-workspace visar matrisen folders alla mappar som ingår i explorer-fönstret. Matrisen dataworkspace.excludedProjects i settings listar alla SQL-projekt som undantas från fönstret Projekt .

{
  "folders": [
    {
      "path": "."
    },
    {
      "name": "WideWorldImportersDW",
      "path": "..\\WideWorldImportersDW"
    }
  ],
  "settings": {
    "dataworkspace.excludedProjects": [
      "AdventureWorksLT.sqlproj"
    ]
  }
}

Relaterat innehåll

  • Last updated on