Sdílet prostřednictvím

Rozšíření SQL Database Projects

Důležité

Azure Data Studio se ukončuje 28. února 2026. Doporučujeme používat Visual Studio Code. Další informace o migraci do editoru Visual Studio Code najdete v tématu Co se děje se sadou Azure Data Studio?

Rozšíření SQL Database Projects je rozšíření editoru Visual Studio Code pro vývoj databází SQL v projektovém vývojovém prostředí. Mezi kompatibilní databáze patří SQL Server, Azure SQL Database, Azure SQL Managed Instance, Warehouse ve Fabricu a SQL databáze ve Fabricu. Projekt SQL je místní reprezentace objektů SQL, které tvoří schéma pro jednu databázi, jako jsou tabulky, uložené procedury nebo funkce. Při sestavení projektu SQL Database je výstupní artefakt .dacpac souborem. Nové a existující databáze je možné aktualizovat tak, aby odpovídaly obsahu projektu .dacpac publikováním projektu SQL Database pomocí rozšíření projektů SQL Database nebo publikováním .dacpac pomocí rozhraní příkazového řádku SqlPackage.

Snímek obrazovky se souhrnem projektů služby SQL Database obsahujících předem připravené skripty a skripty po nasazení a databázové objekty

Další informace o konceptech projektů SQL najdete v tématu Co jsou projekty databáze SQL?

Funkce rozšíření

Rozšíření Sql Database Projects poskytuje následující funkce:

  • Vytvořte nový prázdný projekt Microsoft.Build.Sql.
  • Vytvořte nový projekt z připojené databáze.
  • Otevřete projekt vytvořený v editoru Visual Studio Code nebo v nástrojích SQL Server Data Tools.
  • Upravte projekt přidáním nebo odebráním objektů (tabulek, zobrazení, uložených procedur) nebo vlastních skriptů v projektu.
  • Uspořádejte soubory nebo skripty ve složkách.
  • Přidejte odkazy na systémové databáze nebo uživatelský dacpac.
  • Vytvořte jeden projekt.
  • Nasazení jednoho projektu
  • Načtěte podrobnosti o připojení (ověřování SYSTÉMU SQL Windows) a proměnné SQLCMD z profilu nasazení.

Install

Rozšíření projektu služby SQL Database můžete nainstalovat v editoru Visual Studio Code.

Rozšíření SQL Database Projects je nainstalované s rozšířením mssql pro Visual Studio Code.

Závislosti

Rozšíření Sql Database Projects má závislost na sadě .NET SDK (povinné) a AutoRest.Sql (volitelné).

.NET SDK

Sada .NET SDK se vyžaduje pro funkci sestavení projektu a zobrazí se výzva k instalaci sady .NET SDK, pokud rozšíření nedokáže zjistit podporovanou verzi. Sadu .NET SDK je možné stáhnout a nainstalovat pro Windows, macOS a Linux.

Pokud chcete zkontrolovat aktuálně nainstalované verze sady dotnet SDK, otevřete terminál a spusťte následující příkaz:

dotnet --list-sdks

Po instalaci sady .NET SDK je vaše prostředí připravené k použití rozšíření SQL Database Projects.

Běžné problémy

Chybí-li Nuget.org v seznamu zdrojů, mohou se objevit chybové zprávy, jako jsou:

  • 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

Pokud chcete zkontrolovat, jestli je nuget.org zaregistrovaný jako zdroj, spusťte dotnet nuget list source z příkazového řádku a zkontrolujte výsledky [Enabled] pro položku odkazující na nuget.org. Pokud nuget.org není zaregistrovaný jako zdroj, spusťte dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.orgpříkaz .

Nepodporované verze sady .NET SDK můžou mít za následek chybové zprávy, například:

  • 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]_ (kde propojený neexistující soubor obsahuje chybějící hranatou závorku).

Chcete-li vynutit, aby rozšíření SQL Database Projekty používalo .NET SDK ve verzi v6.x, když jsou nainstalovány více verze, přidejte do složky, která obsahuje projekt SQL, soubor global.json.

Další informace o řešení potíží s sestavením projektů SQL najdete v tématu Řešení potíží s sestavením projektu SQL.

SQLCLR

Objekty SQLCLR v databázových projektech nejsou v nástroji Visual Studio Code podporovány, protože spoléhají na rozhraní .NET Framework, a rozšíření SQL Database Projects používá .NET k sestavování projektů.

Workspace

Projekty databáze SQL jsou obsaženy v logickém pracovním prostoru (složce) v editoru Visual Studio Code. Všechny projekty SQL v rámci složek otevřených v aktuálním pracovním prostoru jsou ve výchozím nastavení k dispozici v zobrazení Projekty služby SQL Database.

Projekty můžete ručně přidávat a odebírat z pracovního prostoru prostřednictvím rozhraní v podokně Projekty . Nastavení pracovního prostoru je možné v případě potřeby ručně upravit v .code-workspace souboru.

V následujícím příkladovém .code-workspace souboru obsahuje pole folders seznam všech složek zahrnutých v podokně Průzkumníku a pole dataworkspace.excludedProjects uvnitř settings obsahuje seznam všech projektů SQL vyloučených z podokna „Projekty“.

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

Související obsah

  • Last updated on