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

Блокноты SQL (предварительная версия)

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

Подсказка

Записные книжки SQL в настоящее время находятся в предварительной версии и могут изменяться на основе отзывов. Присоединитесь к сообществу в GitHub Discussions , чтобы поделиться идеями или сообщить о проблемах.

Features

Записные книжки SQL предоставляют следующие возможности:

  • Выполнение запросов T-SQL в интерактивном режиме в ячейках кода записной книжки с встроенными результатами, отображаемыми под каждой ячейкой.

  • Используйте собственный формат записной книжки Visual Studio Code Jupyter (.ipynb файлы) для полной совместимости с существующими инструментами записной книжки.

  • Просмотр результатов запроса в интерактивной сетке данных с функциями сортировки, фильтрации, выделения ячеек, подсветки значений NULL и параметрами копирования (включая копирование с заголовками).

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

  • Добавляйте текстовые ячейки Markdown наряду с ячейками кода SQL, чтобы документировать запросы, аннотировать результаты и создавать повествовательные рабочие процессы.

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

  • Запустите ячейки по отдельности или выполните все ячейки последовательно.

  • Используйте GitHub Copilot для встроенных предложений запросов в ячейках кода и создании записных книжек на основе чата, чтобы создать полные записные книжки из описания естественного языка.

  • Объедините ячейки SQL с другими ядрами языка (например, Python) в той же записной книжке, установив расширение Jupyter.

  • Экспортируйте и делитесь записными книжками в виде .ipynb файлов, которые другие пользователи могут открывать в Visual Studio Code или любой среде, совместимой с Jupyter.

Необходимые условия

Перед использованием записных книжек SQL убедитесь, что выполнены следующие требования:

Создание записной книжки SQL

Создать записную книжку SQL можно несколькими способами:

  • Откройте палитру команд (CTRL+SHIFT+P в Windows и Linux или CMD+SHIFT+P в macOS), введите New Notebookи выберите команду.

  • Перейдите в меню "Файл " и выберите новый файл, а затем выберите тип Jupyter Notebook.

  • Щелкните правой кнопкой мыши базу данных в обозревателе объектов расширения MSSQL и выберите "Создать записную книжку " в контекстном меню.

При создании записной книжки выберите ядро MSSQL , чтобы включить выполнение T-SQL в ячейках кода.

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

Каждой записной книжке SQL требуется активное подключение к базе данных для выполнения запросов. При открытии записной книжки с ядром MSSQL расширение предложит выбрать профиль подключения или создать новую.

Это важно

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

Запись и запуск ячеек SQL

Ячейки кода SQL позволяют создавать и выполнять запросы T-SQL в интерактивном режиме в записной книжке.

  1. Выберите +Код на панели инструментов записной книжки, чтобы добавить новую ячейку кода.

  2. Введите запрос T-SQL в ячейку. Ячейка предоставляет тот же интерфейс редактирования SQL, что и стандартный редактор запросов, включая IntelliSense с предложениями по имени таблицы и столбца из подключенной базы данных.

  3. Нажмите «Выполнить ячейку» (кнопка воспроизведения слева от ячейки), чтобы выполнить запрос.

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

Чтобы запустить все ячейки записной книжки последовательно, выберите "Выполнить все " на панели инструментов записной книжки.

Подсказка

Используйте CTRL+ВВОД (Windows и Linux) или CMD+ВВОД (macOS), чтобы запустить текущую ячейку и оставаться на ней. Используйте SHIFT+ВВОД , чтобы запустить текущую ячейку и перейти к следующей.

Результаты запроса

Результаты запросов в записных книжках SQL предоставляют тот же широкий интерфейс сетки данных, доступный в стандартном редакторе запросов:

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

Добавление ячеек Markdown

Ячейки Markdown можно использовать для добавления форматированного текста, заголовков, списков и ссылок вместе с ячейками кода SQL. Используйте их для документирования запросов, объяснения бизнес-логики или добавления заметок о ожидаемых результатах.

  1. Выберите +Markdown на панели инструментов записной книжки, чтобы добавить новую текстовую ячейку.

  2. Введите содержимое Markdown. Предварительный просмотр отображается по мере ввода.

  3. Выберите вне ячейки, чтобы отобразить текст Markdown.

Снова выберите ячейку, чтобы вернуться в режим редактирования.

Использование нескольких ядер

Расширение MSSQL предоставляет SQL-ядро из коробки. Вы можете расширить записные книжки с дополнительными ядрами языка, установив расширение Jupyter, которое объединяет поддержку Python и других ядер. Запросы данных SQL можно объединить с ячейками обработки и визуализации данных Python в одной записной книжке.

Интеграция GitHub Copilot

GitHub Copilot работает с записными книжками SQL для создания запросов и создания записных книжек. При установке расширения GitHub Copilot вы получите:

  • Встроенные предложения: В процессе ввода в ячейки кода SQL, GitHub Copilot предлагает завершения запросов, учитывая контекст вашей базы данных и содержимое окружающих ячеек Markdown.

  • Создание записной книжки на основе чата: используйте GitHub Copilot Chat для создания полных записных книжек с чередованием ячеек Markdown и SQL. Описать анализ, который требуется выполнить, и GitHub Copilot создает полную структуру записной книжки.

Например, можно открыть GitHub Copilot Chat и использовать запрос, например:

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

GitHub Copilot создает ячейки с документацией в формате Markdown и ячейки с кодом T-SQL, которые затем можно запускать по отдельности или одновременно с помощью Запуска всех.

Переключить базы данных

Чтобы переключиться на другую базу данных в одном подключении к серверу:

  1. Выберите имя базы данных, отображаемое в области состояния подключения ноутбука.

  2. Выберите другую базу данных из раскрывающегося списка.

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

Замечание

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

Ограничения

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

Отзывы и поддержка

Если у вас есть идеи, отзывы или хотите взаимодействовать с сообществом, присоединитесь к обсуждению https://aka.ms/vscode-mssql-discussions. Чтобы сообщить об ошибке, посетите сайт https://aka.ms/vscode-mssql-bug. Чтобы запросить новую функцию, перейдите в раздел https://aka.ms/vscode-mssql-feature-request.

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

  • Last updated on