Поддержка T-SQL в записных книжках Microsoft Fabric

Функция записной книжки T-SQL в Microsoft Fabric позволяет создавать и запускать код T-SQL в записной книжке. Записные книжки T-SQL можно использовать для управления сложными запросами и написания более эффективной документации markdown. Он также позволяет напрямую выполнять T-SQL в подключенном хранилище или конечной точке аналитики SQL. Добавив конечную точку хранилища данных или аналитики SQL в записную книжку, разработчики T-SQL могут выполнять запросы непосредственно в подключенной конечной точке. Аналитики бизнес-аналитики также могут выполнять межбазовые запросы для сбора аналитических сведений из нескольких хранилищ и конечных точек аналитики SQL.

Большинство существующих функций записной книжки доступны для записных книжек T-SQL. К ним относятся результаты запроса диаграммы, совместное редактирование записных книжек, планирование регулярных выполнений и активация выполнения в конвейерах Интеграция данных.

Внимание

Эта функция доступна в предварительной версии.

Вы узнаете, как выполнять следующие задачи:

• Создание записной книжки T-SQL
• Добавление конечной точки хранилища данных или аналитики SQL в записную книжку
• Создание и запуск кода T-SQL в записной книжке
• Использование функций диаграммы для графического представления результатов запроса
• Сохранение запроса в виде представления или таблицы
• Выполнение запросов между хранилищами
• Пропустить выполнение кода, отличного от T-SQL

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

Чтобы приступить к работе с этим интерфейсом, вы можете создать записную книжку T-SQL следующими способами:

1. Создайте записную книжку T-SQL из рабочей области Fabric: выберите новый элемент, а затем выберите Записная книжка на открывающейся панели.

   

2. Создайте записную книжку T-SQL из уже существующего редактора хранилища: перейдите к существующему хранилищу и на верхней ленте навигации выберите Новый SQL запрос, а затем Создать новую записную книжку для запросов T-SQL.

   

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

Добавление конечной точки хранилища данных или аналитики SQL в записную книжку

Чтобы добавить конечную точку хранилища данных или аналитики SQL в записную книжку, в редакторе записной книжки нажмите кнопку +Источники данных и выберите "Хранилища". На панели концентратора данных выберите хранилище данных или конечную точку аналитики SQL, к которой вы хотите подключиться.

Установка основного хранилища

В записную книжку можно добавить несколько хранилищ или конечных точек аналитики SQL, при этом один из них устанавливается как основной. Основное хранилище запускает код T-SQL. Чтобы задать его, перейдите в обозреватель объектов, выберите ... рядом с хранилищем и выберите "Задать как основной".

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

Создание и запуск кода T-SQL в записной книжке

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

Вы можете автоматически генерировать код T-SQL с помощью шаблона кода из контекстного меню обозревателя объектов. Для записных книжек T-SQL доступны следующие шаблоны:

• Выбор первых 100 элементов
• Создать таблицу
• Создать как выбрать
• Удалить
• Удаление и создание

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

Примечание.

Каждая ячейка кода выполняется в отдельном сеансе, поэтому переменные, определенные в одной ячейке, недоступны в другой ячейке.

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

После выполнения кода разверните панель сообщений, чтобы проверить сводку выполнения.

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

Использование функций диаграммы для графического представления результатов запроса

Щелкнув "Проверить", можно увидеть диаграммы, представляющие качество данных и распределение каждого столбца.

Сохранение запроса в виде представления или таблицы

Меню "Сохранить как таблицу" можно использовать для сохранения результатов запроса в таблицу с помощью команды CTAS. Чтобы использовать это меню, выберите текст запроса из ячейки кода и выберите команду "Сохранить как таблицу ".

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

Примечание.

• Так как меню "Сохранить как таблицу" и "Сохранить как" доступно только для выбранного текста запроса, перед использованием этих меню необходимо выбрать текст запроса.

• Создание представления не поддерживает трехкомпонентное именование, поэтому представление всегда создается в основном хранилище, задав хранилище в качестве основного хранилища.

Запрос между хранилищем

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

Пропустить выполнение кода, отличного от T-SQL

В одной записной книжке можно создать ячейки кода, использующие разные языки. Например, ячейка кода PySpark может предшествовать ячейке кода T-SQL. В таком случае пользователь может пропустить запуск любого кода PySpark для записной книжки T-SQL. Это диалоговое окно отображается при запуске всех ячеек кода, нажав кнопку "Запустить все " на панели инструментов.

Ограничения общедоступной предварительной версии

• Ячейка параметров пока не поддерживается в записной книжке T-SQL. Параметр, переданный из конвейера или планировщика, не сможет использоваться в записной книжке T-SQL.
• Функция недавнего запуска пока не поддерживается в записной книжке T-SQL. Для проверки журнала выполнения записной книжки T-SQL необходимо использовать текущую функцию мониторинга хранилища данных. Дополнительные сведения см. в статье "Мониторинг хранилища данных".
• URL-адрес монитора внутри выполнения конвейера еще не поддерживается в записной книжке T-SQL.
• Функция моментального снимка еще не поддерживается в записной книжке T-SQL.
• Поддержка Git и конвейера развертывания пока не предусмотрена в записной книжке T-SQL.

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

Дополнительные сведения о записных книжках Fabric см. в следующих статьях.

• Что такое хранение данных в Microsoft Fabric?
• Вопросы? Попробуйте запросить сообщество Fabric.
• Есть предложения? Участие в разработке идей по улучшению Структуры.