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 sestavování projektu SQL Database vytvoříte .dacpac soubor. Nové a existující databáze můžete aktualizovat tak, aby odpovídaly obsahu .dacpac, publikováním projektu SQL databáze s rozšířením SQL Database Projects 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 a 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í pro projekty SQL Database závisí na sadě .NET SDK (povinné) a AutoRest.Sql (volitelné).

.NET SDK

Rozšíření vyžaduje sadu .NET SDK pro funkci sestavení projektu. Pokud rozšíření nedokáže rozpoznat podporovanou verzi, zobrazí se výzva k instalaci sady .NET SDK. Sadu .NET SDK pro Windows, macOS a Linux si můžete stáhnout a nainstalovat .

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ějící nuget.org ze seznamu zdrojů může vést k chybám, například:

    • 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).

    Rozšíření SQL Database Projects můžete přinutit, aby při instalaci více verzí používalo .NET SDK verze 6.x. Uděláte to tak, že do složky, která obsahuje projekt SQL, přidáte global.json soubor.

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

SQLCLR

Visual Studio Code nepodporuje objekty SQLCLR v databázových projektech, protože tyto objekty se spoléhají na rozhraní .NET Framework a rozšíření Projekty služby SQL Database používá k sestavování projektů .NET.

Workspace

Projekty databáze SQL jsou obsaženy v logickém pracovním prostoru (složce) v editoru Visual Studio Code. Ve výchozím nastavení máte přístup ke všem projektům SQL v rámci složek otevřených v aktuálním pracovním prostoru v zobrazení projektů 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 . V případě potřeby můžete nastavení pracovního prostoru v .code-workspace souboru ručně upravit.

V následujícím ukázkovém .code-workspace souboru pole folders obsahuje seznam všech složek zahrnutých v podokně Průzkumníka. Pole dataworkspace.excludedProjects v seznamu settings obsahuje všechny projekty SQL vyloučené z podokna Projekty .

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

Související obsah

  • Last updated on