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

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

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

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

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

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

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

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

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

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

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

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

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

Замечание

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

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

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

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

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

Замечание

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

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

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

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

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

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

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

   

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

Запрос источников данных

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

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

Запрос стандартной таблицы или представления

В следующем примере выполняется запрос таблицы из samples каталога.

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

Запрос представления метрик

В следующем примере выполняется запрос представления метрик, использующего таблицу из каталога примеров в качестве источника. Он оценивает три перечисленных мер и агрегирует по Order Month и Order Status. Он возвращает результаты, отсортированные по Order Month. Чтобы создать аналогичное представление метрик в рабочей области, см. статью "Создание представления метрик".

Все оценки мер должны быть упакованы в функцию MEASURE . См.measure агрегатную функцию

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

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

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

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

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

Оптимизация запроса с помощью помощника Databricks

Команда /optimize косой черты призывает Помощника оценивать и оптимизировать запросы. Дополнительные сведения см. в статье "Оптимизация Python,PySpark" и кода SQL.

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

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

Это важно

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

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

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

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

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

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

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

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

   

Замечание

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

• Если запрос сохраняется с ограничением 1000, этот параметр применяется ко всем запускам запросов, включая панели мониторинга.

• Чтобы вернуть все строки (до 64 000), отмените выбор "Limit 1000" из раскрывающегося меню Run (1000).

• Чтобы указать другое ограничение строки, добавьте LIMIT предложение в SQL-запрос.

Максимальное количество строк, возвращаемых в таблице, равно 64 000.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

Добавить тег

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

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

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

   

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

Удалить теги

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

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

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

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

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

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

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

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

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

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

Это важно

Databricks рекомендует использовать панели мониторинга AI/BI (ранее — панели мониторинга Lakeview). Более ранние версии панелей мониторинга, ранее называемые панелями мониторинга Databricks SQL, теперь называются устаревшими панелями мониторинга.

Завершение периода поддержки:

• 12 января 2026 г. Устаревшие панели мониторинга и API больше не доступны напрямую. Однако их можно преобразовать в панели мониторинга искусственного интеллекта и бизнес-аналитики. Страница миграции доступна до 2 марта 2026 г.

Преобразуйте устаревшие панели мониторинга с помощью средства миграции или REST API. Инструкции по использованию встроенного средства миграции см. в разделе "Клонирование устаревшей панели мониторинга на панель мониторинга ИИ/BI". Ознакомьтесь с разделом Использование API Azure Databricks для управления панелями мониторинга, чтобы получить учебники по созданию и управлению панелями мониторинга с помощью 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.