Подключение к базе данных с расширением MSSQL для Visual Studio Code

Расширение MSSQL для Visual Studio Code сосредоточено на подключениях к SQL Server, Azure SQL и базе данных SQL в Microsoft Fabric. В этой статье показано, как создавать подключения с помощью диалогового окна подключения и какие типы проверки подлинности поддерживает расширение. В нем также объясняется, как упорядочить сохраненные подключения в обозреватель объектов и как выбрать подключение, которое использует расширение при открытии нового SQL-файла.

После подключения см. краткое руководство. Запуск первого запроса с расширением MSSQL для Visual Studio Code для создания базы данных, добавления данных и выполнения инструкций Transact-SQL.

Диалоговое окно подключения

Диалоговое окно подключения является основным способом создания или изменения подключения. Откройте его, выбрав "Добавить подключение" в обозреватель объектов или выполнив команду MS SQL: добавьте команду "Подключение" в палитре команд.

Диалоговое окно состоит из трех основных областей:

• Область формы в середине, в которой вы заполняете сведения о подключении.
• Панель "Сохраненные подключения " и " Последние подключения" в правой части, в которой можно быстро открыть или изменить подключения.
• Нижняя панель с действиями Дополнительно, Проверить подключение, Сохранить без подключения и Подключиться.

Типы входных данных

В верхней части формы селектор входных типов управляет вводом сведений о подключении. Используйте тип ввода, который лучше всего соответствует уже известному целевому серверу.

• Параметры: заполните отдельные поля, такие как имя сервера, имя базы данных, тип проверки подлинности, имя пользователя и пароль. Этот тип входных данных используется по умолчанию и является самым простым вариантом для большинства сценариев.

• Строка подключения: Вставьте полную строку подключения в стиле ADO.NET. Этот тип ввода полезен, если вам уже предоставили строку подключения (например, на портале Azure или администратор), либо если нужно настроить параметры, недоступные в представлении Parameters.

• Обзор Azure: войдите в Azure и выберите сервер и базу данных в своих подписках. Вы можете отфильтровать по подписке и группе ресурсов, чтобы найти нужную базу данных. Этот параметр подходит для База данных SQL Azure и Управляемый экземпляр SQL Azure (перечислены как частные, так и общедоступные конечные точки). Вы можете использовать избранные подписки, чтобы они отображались в верхней части списка и загружались автоматически.

• Перейдите Fabric. Войдите в Microsoft Fabric и выберите базу данных SQL из одной из рабочих областей. В диалоговом окне перечислены рабочие области, к которых у вас есть доступ и базы данных SQL. Как и при просмотре Azure, вы можете использовать избранные рабочие области, чтобы они отображались в верхней части списка и загружались автоматически.

И Обзор Azure, и Обзор Fabric используют учетные записи Microsoft, с которыми вы входите в Visual Studio Code. Вы можете войти в систему с любым количеством учетных записей Microsoft и переключаться между учетными записями и их арендаторами с помощью раскрывающихся списков в верхней части панели просмотра. учетные записи GitHub нельзя использовать для просмотра Azure и Fabric баз данных.

Выбор базы данных

Поле "База данных " позволяет подключаться к базе данных по умолчанию сервера или к определенной базе данных.

• Оставьте в поле значение <Default>, чтобы подключиться к базе данных по умолчанию, которую сервер назначает для вашей учетной записи. Это самый простой вариант, и вы по-прежнему можете переключить базы данных позже из редактора.

• Выберите определенную базу данных из раскрывающегося списка. После заполнения достаточной информации для проверки подлинности расширение пытается получить список баз данных на сервере в фоновом режиме. Если список загружается успешно, вы можете выбрать его.

• Если не удается загрузить список баз данных , например, если у входа нет разрешения на перечисление баз данных на сервере, вы по-прежнему можете ввести имя базы данных непосредственно в поле.

Расширенные настройки

Выберите "Дополнительно " в нижнем колонтитуле, чтобы открыть боковую панель с полным набором дополнительных параметров подключения, таких как Always Encrypted, Время ожидания команд и намерение приложения (только для чтения или записи). Это те же параметры, которые вы найдете в строке подключения, сгруппированные по таким категориям, как Безопасность, Устойчивость подключений и Пул подключений. Используйте поле поиска в верхней части панели, чтобы быстро найти конкретный параметр.

Действия в нижнем колонтитуле

Кнопки в нижней части окна определяют, что произойдет после завершения заполнения формы.

• Подключение: подключается к базе данных и добавляет соединение в сохраненный список подключений.

• Тестовое подключение: пытается подключиться с помощью текущих значений формы без сохранения ничего. Используйте это для проверки правильности сервера, учетных данных и других параметров перед фиксацией подключения.

• Сохранить без подключения: сохраняет профиль подключения в списке сохраненных подключений, но не открывает сеанс. Это полезно при предварительной настройке подключений или при необходимости переименовать существующее подключение без подключения.

Работа с существующими подключениями

Списки сохраненных подключений и последних подключений в правой части диалогового окна позволяют легко начать работу с уже имеющегося подключения.

• Наведите указатель мыши на сохраненное подключение, чтобы открыть меню действий. Оттуда можно изменить сведения о подключении, создать новое подключение на основе существующего (полезного сочетания клавиш, когда несколько подключений совместно используют один и тот же сервер, но разные базы данных или учетные данные), или удалить подключение из списка.

• Последние подключения работают так же, но ограничены подключениями, которые вы использовали недавно, даже если они не сохраняются.

Поддерживаемые типы аутентификации

Расширение MSSQL поддерживает несколько типов проверки подлинности. Выберите тот, который соответствует настройке сервера.

логин SQL

Введите имя пользователя и пароль, определенные в самом SQL Server. SQL-вход поддерживается в SQL Server, База данных SQL Azure и Управляемый экземпляр SQL Azure.

При необходимости можно сохранить пароль, чтобы при каждом подключении не было необходимости повторно входить.

Проверка подлинности Windows

Используйте текущую учетную запись Windows для входа на сервер без имени пользователя или пароля. Windows проверка подлинности работает только при подключении к экземпляру SQL Server, настроенному для его принятия, как правило, в сети, присоединенной к домену, или на том же компьютере, что и сервер.

Этот параметр иногда называется встроенной проверкой подлинности. Он недоступен для База данных SQL Azure, Управляемый экземпляр SQL Azure или базы данных SQL в Fabric.

Microsoft Entra ID — универсальная с MFA

Войдите с помощью учетной записи Microsoft Entra ID. Этот параметр поддерживает многофакторную проверку подлинности (MFA), политики условного доступа и персональные учетные записи Microsoft, которые являются гостями в клиенте Microsoft Entra.

При выборе этого параметра диалоговое окно предложит вам выбрать или добавить учетную запись Microsoft Entra ID, а также выбрать арендатора, если у этой учетной записи есть доступ более чем к одному арендатору.

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

Microsoft Entra ID — по умолчанию

Этот параметр использует проверку подлинности по умолчанию Microsoft Entra ID. Драйвер MICROSOFT Data SQL (MDS) автоматически выбирает доступное удостоверение Microsoft Entra ID от поставщиков учетных данных, установленных в вашей системе. Этот тип проверки подлинности полезен, если у вас есть определенные требования к проверке подлинности, которые не поддерживаются напрямую расширением MSSQL.

Учетные данные могут поступать из нескольких разных источников, таких как сеанс Azure CLI с выполненным входом (az login) или переменные среды, и вы можете указать, какое именно удостоверение следует использовать, установив флажок User name. Дополнительные сведения о выборе удостоверения по умолчанию см. в разделе DefaultAzureCredential в клиентской библиотеке Azure Identity.

Microsoft Entra ID — Service Principal

Проверка подлинности в качестве субъекта-службы Microsoft Entra ID (удостоверение приложения, а не пользователя). Используйте этот параметр для сценариев автоматизации, общих рабочих станций или любого случая, когда предпочтительнее предоставить доступ к базе данных удостоверению приложения вместо человека.

При выборе этого параметра поля "Имя пользователя " и "Пароль " переназначаются:

• Введите идентификатор приложения (клиента) субъекта-службы в качестве имени пользователя.
• Введите секрет клиента субъекта-службы в качестве пароля.

Дополнительные сведения об использовании субъект-службы с SQL см. в статье Субъект-служба в клиентской библиотеке Azure Identity

Подключения в обозреватель объектов

Каждое соединение, создаваемое из диалогового окна подключения (немедленное подключение или сохранение без подключения), отображается в обозреватель объектов в представлении MSSQL. В обозреватель объектов вы можете просматривать содержимое сервера, выполнять такие действия, как резервные копии и повторно подключаться к базам данных, которые вы использовали раньше.

Группы подключений

Подключения можно упорядочить в группы соединений. Группы действуют как папки: их можно назвать, назначить цвет и поместить подключения внутри них для визуального разделения сред (например, Production, Staging и Local).

• Создайте группу: используйте команду "Новая группа подключений " или назначьте новую группу при создании или редактировании подключения.

• Перетащите, чтобы упорядочить: перетащите подключение на группу, чтобы переместить его в эту группу. Перетащите группу на другую группу, чтобы вложить ее. Вы можете создавать вложенные группы с несколькими уровнями вложенности.

• Развернуть и свернуть: используйте стрелки рядом с каждой группой, чтобы развернуть или свернуть её и видеть только те подключения, с которыми вы сейчас работаете. Чтобы всегда начинать с групп, свернутых при запуске Visual Studio Code, включите mssql.collapseConnectionGroupsOnStartup этот параметр.

Контекстное меню подключения

Щелкните правой кнопкой мыши подключение к серверу в обозреватель объектов, чтобы увидеть действия, которые применяются к самому подключению. К наиболее часто используемым параметрам подключения относятся:

• Подключиться / Отключиться: Запуск или завершение сеанса с сервером.
• Изменение подключения. Откройте диалоговое окно подключения с профилем подключения, загруженным для изменения параметров.
• Скопировать строку подключения: Скопируйте строку подключения для сохранённого подключения в буфер обмена. Это удобно, если необходимо поделиться подключением с другим инструментом или вставить его в код приложения. Пароли и секретные данные не включаются.
• Удаление подключения: удаление подключения из сохраненного списка.

Правила брандмауэра для Azure SQL

При подключении к База данных SQL Azure или Управляемый экземпляр SQL Azure из IP-адреса клиента, который не разрешен брандмауэром сервера, можно использовать расширение MSSQL для добавления правила брандмауэра с помощью диалогового окна добавления правила брандмауэра.

В диалоговом окне "Добавление правила брандмауэра" войдите с помощью учетная запись Майкрософт с разрешением на управление сервером, присвойте правилу имя и выберите, следует ли разрешать только текущий IP-адрес или диапазон. После сохранения правила подключение будет автоматически возвращено.

Подключения к рабочему пространству

Сохраненные подключения и группы подключений хранятся в вашем Visual Studio Code settings.json. Расширение считывает подключения из двух областей:

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

• Параметры рабочей области. Подключения, сохраненные на уровне рабочей области, доступны только в том случае, если эта рабочая область открыта. Эта область полезна для подключений, относящихся к конкретному проекту, которыми вы хотите поделиться с коллегами, добавив файл рабочей области .code-workspace в систему управления версиями.

Чтобы переместить соединение из параметров пользователя в параметры рабочей области, скопируйте запись JSON подключения из пользователя settings.json в рабочую область settings.json, а затем удалите ее из конфигурации пользователя.

Если сохранить подключение с паролем или секретом, пароль или секрет не будет сохранён в settings.json. Пароли хранятся отдельно в безопасном хранилище учетных данных Visual Studio Code.

Выбор подключения при открытии нового sql-файла или редактора

При открытии .sql файла или создании нового редактора SQL расширение может оставить редактор отключенным или автоматически подключить его.

Это поведение управляется параметром mssql.newEditorConnectionBehavior , который поддерживает три режима:

Эти параметры можно изменить в интерфейсе параметров Visual Studio Code, выполнив поиск по запросу mssql.newEditorConnectionBehavior или mssql.defaultConnectionId.

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

• Краткое руководство. Запуск первого запроса с расширением MSSQL для Visual Studio Code
• Что такое расширение MSSQL для Visual Studio Code?
• Расширение GitHub Copilot для MSSQL для Visual Studio Code
• Руководство. Написание инструкций Transact-SQL
• Документация по Visual Studio Code
• Расширение MSSQL для репозитория Visual Studio Code на сайте GitHub