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 a kimeneti összetevő egy .dacpac fájl. Az új és meglévő adatbázisok az SQL Database-projekt és az SQL Database Projects bővítmény közzétételével, illetve az .dacpac.dacpac parancssori felületének közzétételével frissíthetők a tartalomnak megfelelően.

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/szkriptek rendezése mappákban.
• 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énynek szüksége van a .NET SDK-ra (kötelező) és kapcsolódik az AutoRest.Sql-hez (nem kötelező).

.NET SDK

A .NET SDK szükséges a projekt buildelési funkcióihoz, és a rendszer kérni fogja a .NET SDK telepítését, ha a bővítmény nem észlel támogatott verziót. A .NET SDK letölthető és telepíthető Windows, macOS és Linux rendszerekre.

Ha ellenőrizni szeretné a dotnet SDK jelenleg telepített verzióit , 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

Nuget.org a források listájából való kihagyás olyan hibaüzeneteket eredményezhet, 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).

Ha azt szeretné, hogy az SQL Database Projects bővítmény a .NET SDK v6.x verzióját használja több verzió telepítésekor, 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 az SQL-projektek buildelésével kapcsolatos hibaelhárítási útmutatóban találhatók.

SQLCLR

Az adatbázisprojektekben lévő SQLCLR-objektumok nem támogatottak a Visual Studio Code-ban, mert 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. Az aktuális munkaterületen megnyitott mappákban lévő összes SQL-projekt alapértelmezés szerint elérhető az SQL Database Projects nézetben.

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

A következő példafájlban a .code-workspace tömb felsorolja az Explorer panelen található összes mappát, míg a folders tömb a dataworkspace.excludedProjects panelek közül a settings panelről kizárt összes SQL-projektet sorolja fel.

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

Kapcsolódó tartalom

• Mik azok az SQL Database-projektek?
• Az SQL Database Projects bővítmény használatának első lépései
• Segítségkérés az SQL Database Projects bővítményhez