Megosztás:

SQL Database Projects-bővítmény

Fontos

Az Azure Data Studio 2026. február 28-án megszűnik. Javasoljuk, hogy használja Visual Studio Code. A Visual Studio Code-ba való migrálásról további információkért látogasson el ide: Mi történik az Azure Data Studióval?

Az SQL Database Projects bővítmény egy Visual Studio Code-bővítmény az SQL-adatbázisok projektalapú fejlesztési környezetben való fejlesztéséhez. A kompatibilis adatbázisok közé tartozik az SQL Server, az Azure SQL Database, az Azure SQL Managed Instance, a Warehouse in Fabric és az SQL Database a Fabricben. Az SQL-projektek olyan SQL-objektumok helyi ábrázolása, amelyek egyetlen adatbázis sémáját alkotják, például táblákat, tárolt eljárásokat vagy függvényeket. SQL Database-projekt létrehozásakor létre kell hoznia egy .dacpac fájlt. Az új és meglévő adatbázisokat úgy frissítheti, hogy azok megfeleljenek az .dacpac SQL Database-projekt tartalmának az SQL Database-projektek bővítményével vagy az .dacpacSqlPackage parancssori felületének közzétételével.

Képernyőkép az sql-adatbázisprojektek összegzéséről, amely előre üzembe helyezést és üzembe helyezés utáni szkripteket, valamint adatbázis-objektumokat tartalmaz.

További információ az SQL-projektek fogalmairól: Mik azok az SQL-adatbázisprojektek?

Bővítményfunkciók

Az SQL Database Projects bővítmény a következő funkciókat biztosítja:

  • Hozzon létre egy új üres Microsoft.Build.Sql-projektet.
  • Hozzon létre egy új projektet egy csatlakoztatott adatbázisból.
  • Nyisson meg egy korábban a Visual Studio Code-ban vagy az SQL Server Data Toolsban létrehozott projektet.
  • Projekt szerkesztése objektumok (táblák, nézetek, tárolt eljárások) vagy egyéni szkriptek hozzáadásával vagy eltávolításával a projektben.
  • Fájlok és szkriptek mappákba rendezése.
  • Adjon hozzá hivatkozásokat a rendszeradatbázisokra vagy egy felhasználói dacpac-ra.
  • Egyetlen projekt létrehozása.
  • Egyetlen projekt üzembe helyezése.
  • Töltse be a kapcsolat részleteit (SQL Windows-hitelesítés) és SQLCMD-változókat az üzembehelyezési profilból.

Install

Az SQL Database Project bővítményt a Visual Studio Code-ban telepítheti.

Az SQL Database Projects bővítmény a Visual Studio Code mssql-bővítményével van telepítve.

Függőségek

Az SQL Database Projects bővítmény a .NET SDK-tól (kötelező) és az AutoRest.SQL-től függ (nem kötelező).

.NET SDK

A bővítményhez a .NET SDK szükséges a projekt buildelési funkcióihoz. Ha a bővítmény nem észlel támogatott verziót, a .NET SDK telepítésére kéri. Letöltheti és telepítheti a .NET SDK-t Windowshoz, macOS-hez és Linuxhoz.

A dotnet SDK jelenleg telepített verzióinak ellenőrzéséhez nyisson meg egy terminált, és futtassa a következő parancsot:

dotnet --list-sdks

A .NET SDK telepítése után a környezet készen áll az SQL Database Projects bővítmény használatára.

Gyakori problémák

  • A források listájából hiányzó nuget.org olyan hibaüzeneteket eredményezhetnek, mint például:

    • 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

    Annak ellenőrzéséhez, hogy nuget.org forrásként van-e regisztrálva, futtassa dotnet nuget list source a parancssorból, és tekintse át a nuget.org hivatkozó elem eredményeit [Enabled] . Ha nuget.org nincs regisztrálva forrásként, futtassa a parancsot dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

  • A nem támogatott .NET SDK-verziók a következő hibaüzeneteket eredményezhetik:

    • 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]_ (ahol a hivatkozott nem létező fájl záró szögletes zárójele nem egyezik).

    Több verzió telepítésekor kényszerítheti az SQL Database Projects bővítményt a .NET SDK v6.x verziójának használatára. Ehhez adjon hozzá egy global.json fájlt az SQL-projektet tartalmazó mappához.

Az SQL-projektek buildelésével kapcsolatos hibaelhárítással kapcsolatos további információkért tekintse meg az SQL-projektek összeállításának hibaelhárításával foglalkozó témakört.

SQLCLR

A Visual Studio Code nem támogatja az SQLCLR-objektumokat az adatbázisprojektekben, mivel ezek az objektumok a .NET-keretrendszerre támaszkodnak, és az SQL Database Projects bővítmény a .NET-et használja a projektek létrehozásához.

Workspace

Az SQL-adatbázisprojektek a Visual Studio Code logikai munkaterületén (mappájában) találhatók. Alapértelmezés szerint az SQL Database Projects nézetben az aktuális munkaterületen megnyitott mappákban lévő összes SQL-projektet elérheti.

A projekteket manuálisan is felveheti és eltávolíthatja a munkaterületről a Projektek panel felületén keresztül. Szükség esetén manuálisan szerkesztheti a fájlban lévő .code-workspace munkaterület beállításait.

A következő példafájlban .code-workspace a tömb felsorolja az folders Explorer panelen található összes mappát. A dataworkspace.excludedProjects tömb a settingsProjektek panelről kizárt összes SQL-projektet listázza.

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

Kapcsolódó tartalom

  • Last updated on