Поделиться через

Расширение для проектов базы данных SQL

Это важно

Azure Data Studio прекратит работу 28 февраля 2026 г.. Мы рекомендуем вам использовать Visual Studio Code. Дополнительные сведения о миграции в Visual Studio Code см. в Что происходит с Azure Data Studio?

Расширение "Проекты баз данных SQL" — это расширение Visual Studio Code для разработки баз данных SQL в среде разработки на основе проекта. Совместимые базы данных включают SQL Server, Базу данных SQL Azure, Управляемый экземпляр SQL Azure, хранилище в Fabric и базу данных SQL в Fabric. Проект SQL — это локальное представление объектов SQL, составляющих схему для одной базы данных, например таблиц, хранимых процедур или функций. При создании проекта базы данных SQL создается .dacpac файл. Вы можете обновить новые и существующие базы данных, чтобы они соответствовали содержимому .dacpac, публикуя проект базы данных SQL с расширением "Проекты баз данных SQL" или используя интерфейс командной строки SqlPackage для публикации .dacpac.

Снимок экрана: сводка проектов базы данных SQL, содержащих скрипты предварительного развертывания и скрипты после развертывания, а также объекты базы данных.

Дополнительные сведения о концепциях проектов SQL см. в разделе "Что такое проекты базы данных SQL"?

Функции расширения

Расширение "Проекты баз данных SQL" предоставляет следующие функции:

  • Создайте пустой проект Microsoft.Build.Sql.
  • Создайте проект из подключенной базы данных.
  • Откройте проект, созданный ранее в Visual Studio Code или в SQL Server Data Tools.
  • Изменение проекта путем добавления или удаления объектов (таблиц, представлений, хранимых процедур) или пользовательских скриптов в проекте.
  • Упорядочение файлов и скриптов в папках.
  • Добавьте ссылки на системные базы данных или на пользовательский dacpac файл.
  • Создание одного проекта.
  • Разверните один проект.
  • Загрузка сведений о подключении (проверка подлинности SQL Windows) и переменных SQLCMD из профиля развертывания.

Install

Расширение проекта базы данных SQL можно установить в Visual Studio Code.

Расширение "Проекты баз данных SQL" устанавливается с расширением mssql для Visual Studio Code.

Зависимости

Расширение проектов базы данных SQL зависит от пакета SDK для .NET (обязательно) и AutoRest.Sql (необязательно).

Пакет SDK для .NET

Для расширения требуется пакет SDK для .NET для функциональных возможностей сборки проекта. Если расширение не может обнаружить поддерживаемую версию, она предложит установить пакет SDK для .NET. Вы можете скачать и установить пакет SDK для .NET для Windows, macOS и Linux.

Чтобы проверить установленные в настоящее время версии пакета SDK dotnet, откройте терминал и выполните следующую команду:

dotnet --list-sdks

После установки пакета SDK для .NET среда готова к использованию расширения "Проекты баз данных SQL".

Общие проблемы

  • Отсутствие nuget.org в списке источников может привести к возникновению сообщений об ошибках, таких как:

    • 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

    Чтобы проверить, зарегистрирован ли nuget.org в качестве источника, запустите dotnet nuget list source из командной строки и проверьте результаты на предмет элемента, который ссылается на nuget.org. Если nuget.org не зарегистрирован в качестве источника, запустите [Enabled].

  • Неподдерживаемые версии пакета SDK для .NET могут привести к возникновению таких сообщений об ошибках, как:

    • 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]_ (где связанный несуществующий файл имеет неподходящую закрывающую квадратную скобку).

    Вы можете заставить расширение проектов баз данных SQL использовать версию 6.x SDK для .NET при установке нескольких версий. Для этого добавьте global.json файл в папку, содержащую проект SQL.

Дополнительные сведения об устранении неполадок сборки проектов SQL см. в разделе "Устранение неполадок сборки проекта SQL".

SQLCLR

Visual Studio Code не поддерживает объекты SQLCLR в проектах базы данных, так как эти объекты используют .NET Framework, а расширение "Проекты баз данных SQL" использует .NET для создания проектов.

Workspace

Проекты базы данных SQL содержатся в логической рабочей области (папке) в Visual Studio Code. По умолчанию можно получить доступ ко всем проектам SQL в папках, открытых в текущей рабочей области в представлении проектов базы данных SQL .

Вы можете вручную добавлять и удалять проекты из рабочей области с помощью интерфейса в области "Проекты ". При необходимости можно вручную изменить параметры рабочей области в .code-workspace файле.

В следующем примере .code-workspace файла массив перечисляет все папки, folders включенные в область обозревателя. Массив dataworkspace.excludedProjects в settings перечисляет все проекты SQL, исключенные из панели Проекты.

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

Связанный контент

  • Last updated on