Udostępnij za pomocą

Rozszerzenie SQL Database Projects

Ważne

Usługa Azure Data Studio zostanie wycofana 28 lutego 2026 r.. Zalecamy używanie programu Visual Studio Code. Aby uzyskać więcej informacji na temat migracji do programu Visual Studio Code, odwiedź Co się dzieje z usługą Azure Data Studio?

Rozszerzenie SQL Database Projects to rozszerzenie programu Visual Studio Code do tworzenia baz danych SQL w środowisku projektowym. Zgodne bazy danych obejmują program SQL Server, usługę Azure SQL Database, usługę Azure SQL Managed Instance, magazyn w sieci szkieletowej i bazę danych SQL w sieci szkieletowej. Projekt SQL to lokalna reprezentacja obiektów SQL, które składają się na schemat pojedynczej bazy danych, takich jak tabele, procedury składowane lub funkcje. Gdy projekt usługi SQL Database zostanie skompilowany, artefakt wyjściowy jest plikiem .dacpac . Nowe i istniejące bazy danych można zaktualizować tak, aby były zgodne z zawartością .dacpac obiektu, publikując projekt usługi SQL Database za pomocą rozszerzenia SQL Database Projects lub publikując element .dacpac za pomocą interfejsu wiersza polecenia SqlPackage .

Zrzut ekranu przedstawiający podsumowanie projektów usługi SQL Database zawierających skrypty przed wdrożeniem i po wdrożeniu, a także obiekty bazy danych.

Aby uzyskać więcej informacji na temat pojęć dotyczących projektów SQL, zobacz Co to są projekty bazy danych SQL?

Funkcje rozszerzenia

Rozszerzenie SQL Database Projects udostępnia następujące funkcje:

  • Utwórz nowy pusty projekt Microsoft.Build.Sql.
  • Utwórz nowy projekt na podstawie połączonej bazy danych.
  • Otwórz projekt utworzony wcześniej w programie Visual Studio Code lub w narzędziach SQL Server Data Tools.
  • Edytuj projekt, dodając lub usuwając obiekty (tabele, widoki, procedury składowane) lub niestandardowe skrypty w projekcie.
  • Organizowanie plików/skryptów w folderach.
  • Dodaj odwołania do baz danych systemowych lub pakietu dacpac użytkownika.
  • Skompiluj pojedynczy projekt.
  • Wdrażanie pojedynczego projektu.
  • Załaduj szczegóły połączenia (uwierzytelnianie Windows SQL) i zmienne SQLCMD z profilu wdrożenia.

Install

Rozszerzenie projektu usługi SQL Database można zainstalować w programie Visual Studio Code.

Rozszerzenie SQL Database Projects jest instalowane z rozszerzeniem mssql dla programu Visual Studio Code.

Zależności

Rozszerzenie SQL Database Projects ma zależność od zestawu .NET SDK (wymagane) i rozwiązania AutoRest.Sql (opcjonalnie).

Pakiet SDK dla platformy .NET

Zestaw SDK platformy .NET jest wymagany w przypadku funkcji kompilacji projektu i zostanie wyświetlony monit o zainstalowanie zestawu SDK platformy .NET, jeśli nie można wykryć obsługiwanej wersji przez rozszerzenie. Zestaw .NET SDK można pobrać i zainstalować dla systemów Windows, macOS i Linux.

Jeśli chcesz sprawdzić aktualnie zainstalowane wersje zestawu dotnet SDK, otwórz terminal i uruchom następujące polecenie:

dotnet --list-sdks

Po zainstalowaniu zestawu SDK platformy .NET środowisko jest gotowe do korzystania z rozszerzenia SQL Database Projects.

Typowe problemy

Nuget.org brak z listy źródeł może spowodować wyświetlenie komunikatów o błędach, takich jak:

  • 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

Aby sprawdzić, czy nuget.org jest zarejestrowana jako źródło, uruchom polecenie dotnet nuget list source z wiersza polecenia i przejrzyj wyniki dla elementu odwołującego [Enabled] się nuget.org. Jeśli nuget.org nie jest zarejestrowana jako źródło, uruchom polecenie dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org.

Nieobsługiwane wersje zestawu .NET SDK mogą powodować komunikaty o błędach, takie jak:

  • 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]_ (gdzie połączony nieistniejący plik ma niedopasowany nawias kwadratowy zamykający).

Aby wymusić, aby rozszerzenie SQL Database Projects używało wersji 6.x zestawu .NET SDK po zainstalowaniu wielu wersji, dodaj plik global.json do folderu zawierającego projekt SQL.

Więcej informacji na temat rozwiązywania problemów z kompilacją projektów SQL można znaleźć w temacie Rozwiązywanie problemów z kompilacją projektu SQL.

SQLCLR

Obiekty SQLCLR w projektach baz danych nie są obsługiwane w programie Visual Studio Code, ponieważ korzystają one z programu .NET Framework, a rozszerzenie SQL Database Projects używa platformy .NET do kompilowania projektów.

Workspace

Projekty bazy danych SQL znajdują się w logicznym obszarze roboczym (folderze) w programie Visual Studio Code. Wszystkie projekty SQL w folderach otwartych w bieżącym obszarze roboczym są domyślnie dostępne w widoku Projekty usługi SQL Database.

Możesz ręcznie dodawać i usuwać projekty z obszaru roboczego za pośrednictwem interfejsu w okienku Projekty . W razie potrzeby ustawienia obszaru roboczego można edytować ręcznie w .code-workspace pliku.

W poniższym przykładowym .code-workspace pliku tablica folders zawiera listę wszystkich folderów zawartych w okienku Eksplorator i tablicę dataworkspace.excludedProjects w ramach settings listy wszystkich projektów SQL wykluczonych z okienka Projekty .

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

Treści powiązane

  • Last updated on