Написание запросов и изучение данных в редакторе SQL

Пользовательский интерфейс Azure Databricks включает редактор SQL, который можно использовать для создания запросов, просмотра доступных данных и создания визуализаций. Вы также можете поделиться сохраненными запросами с другими участниками команды в рабочей области. В этой статье объясняется, как использовать редактор SQL для записи, выполнения и управления запросами. Новая версия редактора SQL доступна в общедоступной предварительной версии. Сведения о включении и работе с новым редактором SQL см. в статье "Совместная работа с коллегами" с помощью нового редактора SQL.

Открыв редактор, вы можете создать SQL-запрос или просмотреть доступные данные. Текстовый редактор поддерживает автозавершение, автоформатирование и различные другие сочетания клавиш.

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

Открытие редактора SQL

Чтобы открыть редактор SQL в пользовательском интерфейсе Azure Databricks, щелкните редактор SQL на боковой панели.

Редактор SQL открывается для последнего открытого запроса. Если запрос не существует или все запросы были явно закрыты, откроется новый запрос. Он автоматически называется New Query , и метка времени создания добавляется в заголовок.

Подключить к объекту вычислений

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

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

Значок рядом с хранилищем SQL указывает его состояние:

• Бег
• Пусковой
• Остановленный

Примечание.

Если в списке нет хранилищ SQL, обратитесь к администратору рабочей области.

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

Просмотр объектов данных в редакторе SQL

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

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

Примечание.

Если в браузере схемы или обозревателе каталогов отсутствуют объекты данных, обратитесь к администратору рабочей области.

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

Щелкните имя таблицы, чтобы отобразить столбцы для этой таблицы.

Создание запроса

Вы можете ввести текст для создания запроса в редакторе SQL. Элементы из браузера схем можно вставить для ссылки на каталоги и таблицы.

1. Введите запрос в редакторе SQL.

   Редактор SQL поддерживает автозавершение. При вводе автозавершение предполагает завершение. Например, если подходящим вариантом завершения в положении курсора является столбец, автозавершение предложит имя столбца. Если ввести select * from table_name as t where t., автозавершение распознает, что t является псевдонимом для table_name, и предложит указать столбцы внутри table_name.

   

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

Включение и отключение автозаполнения

Функция интерактивного автозавершения может завершать маркеры схем, идентификаторы синтаксиса запросов (например, SELECT и JOIN), а также заголовки фрагментов запросов. Она включена по умолчанию, если схема базы данных не превышает пять тысяч маркеров (таблиц или столбцов).

Используйте переключатель под редактором SQL, чтобы включить или отключить динамическое автозавершение.

• Чтобы отключить динамическое автозавершение, нажмите клавиши CTRL+ПРОБЕЛ или нажмите кнопку под редактором SQL.

Сохранение запросов

Кнопка "Сохранить " в правом верхнем углу редактора SQL сохраняет запрос.

Внимание

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

Редактирование нескольких запросов

По умолчанию редактор SQL использует вкладки, чтобы одновременно изменять несколько запросов. Чтобы открыть новую вкладку, щелкните +, а затем выберите Create new query (Создать новый запрос) или Open existing query (Открыть существующий запрос). Нажмите Открыть существующий запрос, чтобы просмотреть список сохраненных запросов. Щелкните "Мои запросы" или "Избранное", чтобы отфильтровать список запросов. В строке, содержащей запрос, который необходимо просмотреть, нажмите кнопку Открыть.

Выполнение одного запроса или нескольких запросов

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

1. Выберите хранилище SQL.

2. Выделите запрос в редакторе SQL (если несколько запросов находятся в области запросов).

3. Нажмите клавиши CTRL/CMD + ВВОД или нажмите кнопку "Выполнить" (1000), чтобы отобразить результаты в виде таблицы в области результатов.

   

Примечание.

Ограничение 1000 выбрано по умолчанию для всех запросов, чтобы ограничить возврат запроса до 1000 строк. Если запрос сохраняется с параметром Limit 1000 , этот параметр применяется ко всем запускам запросов (включая панели мониторинга). Чтобы вернуть все строки для этого запроса, можно отменить выбор LIMIT 1000, щелкнув раскрывающийся список "Выполнить" (1000). Если вы хотите указать другое ограничение на количество строк, можно добавить LIMIT предложение в запрос со значением выбранного значения.

Прерывание запроса

Чтобы прервать запрос во время выполнения, нажмите кнопку Отмена. Администратор может остановить исполняемый запрос, запущенный другим пользователем, просмотрев запрос завершения выполнения.

Параметры запроса

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

Возврат к сохраненным запросам

При изменении запроса в контекстном меню запроса отображается параметр Отменить изменения. Вы можете вернуться к сохраненной версии, нажав кнопку Отменить изменения.

Отмена и восстановление запросов

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

• Щелкните контекстное меню кебаб рядом с запросом в редакторе SQL и выберите "Переместить в корзину".
• Нажмите кнопку " Переместить в корзину ", чтобы подтвердить.

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

1. В списке "Все запросы" щелкните .
2. Щелкните запрос.
3. Щелкните контекстное меню kebab в правом верхнем углу редактора SQL и нажмите кнопку "Восстановить".

Настройка описания и просмотра сведений о запросе

Чтобы задать описание запроса, сделайте следующее:

1. Щелкните контекстное меню кебаб рядом с запросом и щелкните "Изменить сведения о запросе".

   

2. В текстовом поле "Описание" введите описание. Затем щелкните Сохранить. В этом диалоговом окне также можно просмотреть журнал запроса, в том числе при его создании и обновлении.

Запросы избранного и тега

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

Избранное. Чтобы выбрать запрос, щелкните звездочку слева от его заголовка в списке запросов. Звездочка станет желтой.

Теги. Вы можете пометить запросы и панели мониторинга с любой понятной строкой в организации.

Добавить тег

Добавьте теги в редактор запросов.

1. Щелкните контекстное меню кебаб рядом с запросом и щелкните "Изменить сведения о запросе". Откроется диалоговое окно сведений о запросе.

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

   

3. Нажмите кнопку "Сохранить", чтобы применить теги и закрыть диалоговое окно.

Удалить теги

1. Щелкните контекстное меню кебаб рядом с запросом и щелкните "Изменить сведения о запросе".
2. Щелкните X на любом теге, который вы хотите удалить.
3. Нажмите кнопку "Сохранить", чтобы закрыть диалоговое окно.

Просмотр результатов запроса

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

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

Визуализации, фильтры и параметры

Щелкните, чтобы добавить визуализацию, фильтр или параметр. Отображаются следующие параметры:

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

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

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

Изменение, скачивание или добавление на панель мониторинга

Внимание

• Databricks рекомендует использовать панели мониторинга AI/BI (ранее — панели мониторинга Lakeview). Более ранние версии панелей мониторинга, ранее называемые панелями мониторинга Databricks SQL, теперь называются устаревшими панелями мониторинга. Databricks не рекомендует создавать новые устаревшие панели мониторинга.
• Преобразуйте устаревшие панели мониторинга с помощью средства миграции или REST API. Инструкции по использованию встроенного средства миграции см . в разделе "Клонирование устаревшей панели мониторинга" на панель мониторинга ИИ/BI. Ознакомьтесь с руководствами по созданию панелей мониторинга и управлению ими с помощью REST API.

Щелкните вкладку результатов, чтобы просмотреть дополнительные параметры.

1. Нажмите кнопку "Изменить" , чтобы настроить результаты, отображаемые в визуализации.
2. Нажмите кнопку "Удалить", чтобы удалить вкладку результатов.
3. Нажмите кнопку " Дублировать" , чтобы клонировать вкладку результатов.
4. Нажмите кнопку "Добавить на панель мониторинга ", чтобы скопировать запрос и визуализацию на новую панель мониторинга.
   • Это действие создает новую панель мониторинга, содержащую все визуализации, связанные с запросом. См . панели мониторинга , чтобы узнать, как изменить панель мониторинга.
   • Вам будет предложено выбрать имя новой панели мониторинга. Новая панель мониторинга сохраняется в домашней папке.
   • Невозможно добавить результаты на существующую панель мониторинга.
5. Нажмите кнопку "Добавить к устаревшей панели мониторинга ", чтобы добавить вкладку результатов в новую или существующую устаревшую панель мониторинга.
6. Щелкните любой из параметров скачивания, чтобы скачать результаты. Дополнительные сведения и ограничения см. в следующем описании.

Скачать результаты: вы можете скачать результаты в виде CSV-файла, TSV или Excel.

Вы можете скачать до примерно 1 ГБ данных результатов из Databricks SQL в формате CSV и TSV и до 100 000 строк в файл Excel.

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

Примечание.

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

Последние выполнения

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

Изучите результаты.

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

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

Фильтрация списка сохраненных запросов в окне запросов

В окне запросов можно отфильтровать список всех запросов по списку созданных запросов (мои запросы), по избранному и по тегам.

Автоматизация обновлений

С помощью кнопки "Расписание " можно задать автоматическую периодичность выполнения запросов. Автоматическое обновление может помочь обеспечить актуальность панелей мониторинга и отчетов с использованием самых актуальных данных. Запросы Schedueled также могут включать оповещения Databricks SQL, специальный тип запланированной задачи, которая отправляет уведомления, когда значение достигает указанного порогового значения.

См. раздел " Планирование запроса".

См. сведения о оповещениях Databricks SQL?

Обмен запросами

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

• Запуск от имени владельца (учетные данные владельца): этот параметр означает, что зрители могут видеть те же результаты запроса, что и владелец запроса. Это относится к запланированным или ручным выполнениям запросов.
• Запуск от имени средства просмотра (учетные данные просмотра): этот параметр ограничивает результаты назначенными разрешениями средства просмотра.

См. раздел "Настройка разрешений запроса".

Следующий шаг

См. статью Access и управление сохраненными запросами, чтобы узнать, как работать с запросами с пользовательским интерфейсом Azure Databricks.