Расширение SQL Server для Visual Studio Code

Применимо к: SQL Server Azure SQL DatabaseУправляемый экземпляр SQL AzureAzure Synapse Analytics

В этой статье показано, как использовать расширение mssql для Visual Studio Code для работы с базами данных в SQL Server в Windows, macOS и Linux, а также в Базе данных SQL Azure, Управляемом экземпляре SQL Azure и Azure Synapse Analytics. Расширение mssql для Visual Studio Code позволяет подключаться к SQL Server, выполнять запросы с помощью Transact-SQL (T-SQL) и просматривать результаты.

Создание или открытие файла SQL

Чтобы выполнять команды mssql и пользоваться технологией IntelliSense для T-SQL в редакторе кода, необходимо выбрать языковой режим SQL.

1. Выберите пункт Файл>Создать файл или нажмите клавиши CTRL+N. По умолчанию в Visual Studio Code открывается обычный текстовый файл.

2. В нижней строке состояния выберите Обычный текст или нажмите клавиши CTRL+K>M, а затем выберите в раскрывающемся списке языков пункт SQL.

   

   Примечание

   Если расширение используется впервые, оно устанавливает службу sql Tools в фоновом режиме.

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

Подключение к SQL Server

Чтобы создать профиль подключения и подключиться к SQL Server, выполните указанные ниже действия.

1. Нажмите клавиши CTRL+SHIFT+P или F1, чтобы открыть палитру команд.

2. Введите sql, чтобы отобразить команды mssql, или введите sqlcon, а затем выберите в раскрывающемся списке пункт MS SQL: подключение.

   

   Примечание

   Чтобы можно было выполнять команды mssql, необходимо установить фокус на файл SQL, например созданный пустой файл SQL, в редакторе кода.

3. Выберите команду MS SQL: управление профилями подключения.

4. Затем нажмите Создать, чтобы создать профиль подключения для SQL Server.

5. Следуя указаниям, настройте свойства для нового профиля подключения. После указания каждого значения нажимайте клавишу ВВОД, чтобы продолжить.

   Свойства подключения	Описание
   Имя сервера или строка подключения ADO	Укажите имя экземпляра SQL Server. Чтобы подключиться к экземпляру SQL Server на локальном компьютере, введите localhost. Чтобы подключиться к удаленному серверу SQL Server, введите имя целевого сервера SQL Server или его IP-адрес. Чтобы подключиться к контейнеру SQL Server, укажите IP-адрес хост-компьютера контейнера. Если необходимо указать порт, отделите его от имени запятой. Например, для сервера, ожидающего передачи данных через порт 1401, введите <servername or IP>,1401. По умолчанию строка подключения использует порт 1433. Экземпляр SQL Server по умолчанию использует порт 1433, если этот параметр не изменен. Если экземпляр прослушивает порт 1433, порт указывать не нужно. В качестве альтернативы можно ввести строку подключения ADO для своей базы данных.
   Имя базы данных (необязательно)	База данных, которую необходимо использовать. Чтобы подключиться к базе данных по умолчанию, не указывайте имя.
   Тип проверки подлинности	Выберите Встроенная или Вход SQL.
   Имя пользователя	Если выбран Вход SQL, введите имя пользователя с доступом к базе данных на сервере.
   Пароль	Введите пароль для указанного пользователя.
   Сохранить пароль	Нажмите клавишу ВВОД, чтобы выбрать вариант Да и сохранить пароль. Выберите Нет, чтобы пароль запрашивался при каждом использовании профиля подключения.
   Имя профиля (необязательно)	Введите имя профиля подключения, например профиль localhost.

   После ввода всех значений и нажатия клавиши ВВОД Visual Studio Code создает профиль подключения и подключается к SQL Server.

   Совет

   Если подключиться не удается, попробуйте диагностировать проблему в сообщении об ошибке на панели Вывод в Visual Studio Code. Чтобы открыть панель Вывод, выберите пункт Вид>Вывод. Кроме того, ознакомьтесь с рекомендациями по устранению неполадок с подключением.

6. Проверьте состояние подключения в нижней строке состояния.

   

Вместо выполнения предыдущих инструкций создавать и изменять профили подключения можно также в файле параметров пользователя (settings.json). Чтобы открыть файл параметров, выберите Файл>Настройки>Параметры. Дополнительные сведения см. в статье Управление профилями подключения.

Шифрование и доверие сертификата сервера

Расширение mssql для VS Code версии 1.17.0 и более поздних версий включает важное изменение в свойстве Encrypt, которое теперь по умолчанию включено (имеет значение True) для подключений поставщика MSSQL, и SQL Server должны быть настроены с сертификатами TLS, подписанными доверенным корневым центром сертификации. Кроме того, если начальная попытка подключения завершается сбоем с включенным шифрованием (по умолчанию), расширение mssql предоставит запрос на уведомление с возможностью попытки подключения с включенным сертификатом сервера доверия. Свойства сертификата сервера Encrypt и Trust также доступны для редактирования вручную в файле параметров пользователя (settings.json). Рекомендуется поддерживать надежное зашифрованное подключение к серверу.

Для пользователей, подключающихся к базе данных Azure SQL, изменения существующих сохраненных подключений не требуются; база данных Azure SQL поддерживает зашифрованные подключения и настраивается с использованием доверенных сертификатов.

Для пользователей, подключающихся к локальной SQL Server или SQL Server на виртуальной машине, если для параметра Шифрование задано значение True, убедитесь, что у вас есть сертификат из доверенного центра сертификации (например, не самозаверяющий сертификат). Кроме того, вы можете подключиться без шифрования (для параметра Encrypt задано значение False) или для доверия сертификату сервера (для параметра Шифрование задано значение True, а для параметра Доверять сертификату сервера — значение True).

Создание базы данных

1. В новом файле SQL, открытом ранее, введите sql, чтобы получить список редактируемых фрагментов кода.

   

2. Выберите sqlCreateDatabase.

3. Во фрагменте введите TutorialDB вместо DatabaseName:

   -- Create a new database called 'TutorialDB'
   -- Connect to the 'master' database to run this snippet
   USE master
   GO
   IF NOT EXISTS (
      SELECT name
      FROM sys.databases
      WHERE name = N'TutorialDB'
   )
   CREATE DATABASE [TutorialDB]
   GO
   

4. Нажмите клавиши CTRL+SHIFT+E, чтобы выполнить команды Transact-SQL. Просмотрите результаты в окне запроса.

   

   Совет

   Сочетания клавиш для команд mssql можно настроить. См. статью Customize Shortcuts (Настройка сочетаний клавиш).

Создание таблицы

1. Удалите содержимое в окне редактора кода.

2. Нажмите клавиши CTRL+SHIFT+P или F1, чтобы открыть палитру команд.

3. Введите sql, чтобы отобразить команды mssql, или введите sqluse, а затем выберите команду MS SQL: использовать базу данных.

4. Выберите новую базу данных TutorialDB.

   

5. В редакторе кода введите sql, чтобы отобразить фрагменты кода, выберите фрагмент sqlCreateTable и нажмите клавишу ВВОД.

6. Во фрагменте введите Employees в качестве имени таблицы.

7. Нажмите клавишу TAB, чтобы перейти к следующему полю, а затем введите dbo в качестве имени схемы.

8. Замените определения столбцов следующими столбцами:

   EmployeesId INT NOT NULL PRIMARY KEY,
   Name [NVARCHAR](50)  NOT NULL,
   Location [NVARCHAR](50)  NOT NULL
   

9. Нажмите клавиши CTRL+SHIFT+E, чтобы создать таблицу.

Вставка и запрос

1. Добавьте приведенные ниже инструкции, чтобы вставить четыре строки в таблицу Employees.

   -- Insert rows into table 'Employees'
   INSERT INTO Employees
      ([EmployeesId],[Name],[Location])
   VALUES
      ( 1, N'Jared', N'Australia'),
      ( 2, N'Nikita', N'India'),
      ( 3, N'Tom', N'Germany'),
      ( 4, N'Jake', N'United States')
   GO
   -- Query the total count of employees
   SELECT COUNT(*) as EmployeeCount FROM dbo.Employees;
   -- Query all employee information
   SELECT e.EmployeesId, e.Name, e.Location
   FROM dbo.Employees as e
   GO
   

   В процессе ввода технология IntelliSense для T-SQL помогает завершать инструкции:

   

   Совет

   Расширение mssql также предоставляет команды, помогающие создавать инструкции INSERT и SELECT. В предыдущем примере они не использовались.

2. Нажмите клавиши CTRL+SHIFT+E, чтобы выполнить команды. В окне Результаты отобразятся два результирующих набора.

   

Просмотр и сохранение результата

1. Выберите пункты Вид>Макет редактора>Перевернуть макет, чтобы выбрать макет с вертикальным или горизонтальным разбиением.

2. Чтобы свернуть или развернуть панели Результаты и Сообщение, щелкните их заголовки.

   

   Совет

   Поведение по умолчанию расширения mssql можно настроить. См. статью Customize extension options (Настройка параметров расширения).

3. Щелкните значок увеличения сетки во второй сетке результатов, чтобы увеличить масштаб.

   

   Примечание

   Значок увеличения отображается, если скрипт T-SQL создает две или несколько сеток результатов.

4. Откройте контекстное меню сетки, щелкнув ее правой кнопкой мыши.

   

5. Выберите команду Выбрать все.

6. Снова откройте контекстное меню сетки и выберите команду Сохранить как JSON, чтобы сохранить результат в файле JSON.

7. Укажите имя файла JSON.

8. Убедитесь в том, что файл JSON сохранился и открывается в Visual Studio Code.

   

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

Дальнейшие действия

• Если вы не знакомы с T-SQL, изучите разделы Учебник. Составление инструкций Transact-SQL и Справочник по Transact-SQL (ядро СУБД).
• Разработка для баз данных SQL в Visual Studio Code с помощью расширения "Проекты Баз данных SQL"
• Дополнительные сведения об использовании расширения mssql или участии в его создании см. на вики-сайте проекта расширения mssql.
• Дополнительные сведения об использовании Visual Studio Code см. в документации по Visual Studio Code.