Справочник по языку SQL

Это справочник команд SQL для Databricks SQL и Databricks Runtime.

Сведения о том, как понять и использовать нотацию синтаксиса и символы в этой ссылке, см. в статье "Использование ссылки SQL".

Сведения об использовании SQL с декларативными конвейерами Spark Lakeflow см. в справочнике по языку SQL для конвейеров.

Note

Databricks SQL Serverless, недоступен в Azure Китай. Databricks SQL недоступен в регионах Azure Government.

Общие справочные материалы

Эта общая ссылка описывает типы данных, функции, идентификаторы, литералы и семантику.

Основы языка

Reference	Description
Добавление комментариев в инструкции SQL	Добавление комментариев в код SQL
Зарезервированные слова и схемы	Ключевые слова, зарезервированные средство синтаксического анализа SQL
Identifiers	Правила именования объектов базы данных
Names	Соглашения об именовании объектов
IDENTIFIER оговорка	Динамическое разрешение идентификаторов
Выражение SQL	Синтаксис и оценка выражений SQL
Семантика NULL	Обработка значений NULL
Маркеры параметров	Параметризованные заполнители запросов
Variables	Сеансы и временные переменные
Разрешение имен	Разрешение имен объектов
Выражение пути JSON	Навигация по структурам данных JSON
Collation	Правила сравнения строк и сортировки
Partitions	Основные понятия секционирования таблиц

Типы данных

Reference	Description
Типы данных	Обзор всех поддерживаемых типов данных
Правила типа данных SQL	Правила приведения типов и преобразования
Шаблоны даты и времени	Форматирование шаблонов для дат и времени

Параметры конфигурации

Reference	Description
Параметры конфигурации	Обзор конфигурации SQL
ANSI_MODE	Режим соответствия ANSI SQL
LEGACY_TIME_PARSER_POLICY	Поведение синтаксического анализа времени
MAX_FILE_PARTITION_BYTES	Ограничение размера секции файла
READ_ONLY_EXTERNAL_METASTORE	Режим доступа к внешнему хранилищу метаданных
STATEMENT_TIMEOUT	Параметр времени ожидания запроса
TIMEZONE	Часовой пояс сеанса
USE_CACHED_RESULT	Кэширование результатов запроса

Функции

Reference	Description
Functions	Общие сведения о функциях SQL
Встроенные функции	Все встроенные функции
Алфавитный список встроенных функций	Полный справочник по функции A-Z
Функции окна	Функции аналитики и ранжирования
Лямбда-функции	Анонимные выражения функций
Геопространственные функции H3	Шестнадцатеричный иерархический пространственный индекс
Геопространственные функции ST	Стандартные геопространственные функции
Определяемые пользователем агрегатные функции (UDAFs)	Пользовательские функции агрегирования
Внешние определяемые пользователем скалярные функции (UDF)	Пользовательские скалярные функции
Интеграция с UDF, UDAF и UDTF в Hive	Совместимость функций Hive
Вызов функции	Как вызывать функции

Основные понятия каталога Unity

Reference	Description
Основной	Пользователи, группы и субъекты-службы
Привилегии и защищаемые объекты в каталоге Unity	Управление доступом в каталоге Unity
Привилегии и защищаемые объекты в хранилище метаданных Hive	Устаревший контроль доступа к хранилищу метаданных
Внешние расположения	Расположения облачного хранилища
внешние таблицы	Таблицы, поддерживаемые внешними данными
Credentials	Учетные данные доступа к хранилищу
Volumes	Управляемое и внешнее хранилище файлов

Специальные разделы

Reference	Description
Соответствие ANSI в Databricks Runtime	Совместимость стандарта ANSI SQL
Обеспечение совместимости с Apache Hive	Совместимость Hive SQL
Скрипты SQL	Процедурная логика SQL
Дельта Шеринг	Совместное использование данных между организациями
Федеративные запросы (Федерация Lakehouse)	Запросы внешних баз данных
Информационная схема	Системные таблицы метаданных

Инструкции DDL

Инструкции определения данных создают или изменяют структуру объектов базы данных.

Инструкции ALTER

Statement	Description
ALTER CATALOG	Изменение свойств каталога
ALTER CONNECTION	Изменение параметров подключения
ALTER CREDENTIAL	Изменение свойств учетных данных
ALTER DATABASE	Изменение свойств базы данных
ALTER EXTERNAL LOCATION	Изменение внешнего расположения
ALTER MATERIALIZED VIEW	Изменение материализованного представления
ALTER PROVIDER	Изменение поставщика данных
ALTER RECIPIENT	Изменение получателя общего ресурса
ALTER SCHEMA	Изменение свойств схемы
ALTER SHARE	Изменение конфигурации общего ресурса
ALTER STREAMING TABLE	Изменение таблицы потоковой передачи
ALTER TABLE	Изменение структуры таблицы
ALTER VIEW	Изменение определения представления
ALTER VOLUME	Изменение свойств тома

Инструкции CREATE

Statement	Description
CREATE BLOOM FILTER INDEX	Создание индекса фильтра блума
CREATE CATALOG	Создание нового каталога
CREATE CONNECTION	Создание внешнего подключения
CREATE DATABASE	Создание базы данных
CREATE FUNCTION (SQL и Python)	Создание функции SQL
CREATE FUNCTION (внешние)	Создание внешней функции
CREATE EXTERNAL LOCATION	Создание внешнего расположения
CREATE MATERIALIZED VIEW	Создание материализованного представления
СОЗДАНИЕ ПРОЦЕДУРЫ	Создание хранимой процедуры
CREATE RECIPIENT	Создание получателя общей папки
CREATE SCHEMA	Создание новой схемы
CREATE SERVER	Создание внешнего сервера
CREATE SHARE	Создание общей папки данных
CREATE STREAMING TABLE	Создание таблицы потоковой передачи
CREATE TABLE	Создание новой таблицы
CREATE VIEW	Создайте представление
CREATE VOLUME	Создание тома

Анализ инструкций

Другие инструкции DDL

Statement	Description
COMMENT ON	Добавление примечаний к объектам
DECLARE VARIABLE	Объявление переменной сеанса
REPAIR TABLE	Восстановление секций таблиц
REFRESH FOREIGN(CATALOG, и SCHEMATABLE)	Обновление внешних метаданных
REFRESH (MATERIALIZED VIEW или STREAMING TABLE)	Обновление материализованных данных
SET ЯРЛЫК	Добавление тегов в объекты
`SYNC`	Синхронизация метаданных
TRUNCATE TABLE	Удаление всех данных таблицы
UNDROP	Восстановление удаленной таблицы
ТЕГ UNSET	Удаление тегов из объектов

Инструкции DML

Операторы обработки данных добавляют, изменяют или удаляют данные в таблицах Delta Lake.

Statement	Description
`COPY INTO`	Загрузка данных из файлов в таблицу
DELETE FROM	Удаление строк из таблицы
INSERT	Вставка строк в таблицу
INSERT OVERWRITE DIRECTORY	Запись результатов запроса в каталог
INSERT OVERWRITE DIRECTORY с форматом Hive	Запись результатов в формате Hive
LOAD DATA	Загрузка данных из файлов
MERGE INTO	Данные Upsert в таблицу
UPDATE	Обновление строк в таблице

Инструкции получения данных

Извлеките строки из таблиц в соответствии с указанными предложениями. Azure Databricks поддерживает стандартный SELECT синтаксис и синтаксис конвейера SQL.

Инструкции запроса

Statement	Description
Query	Полный справочник по синтаксису запросов
SELECT (подвыборка)	Выбор данных из таблиц
VALUES оговорка	Создание встроенной таблицы
синтаксис конвейера SQL	Композиция запросов на основе канала
EXPLAIN	Показать план выполнения запросов

Условия запроса

Предложение	Description
SELECT оговорка	Выбор столбца
§ (звездочка) условие	Выбор всех столбцов
ссылка на таблицу	Источники таблиц и вложенных запросов
JOIN	Объединение строк из таблиц
WHERE оговорка	Фильтрация строк
GROUP BY оговорка	Группирование строк для агрегирования
HAVING оговорка	Фильтрация сгруппированных строк
QUALIFY оговорка	Результаты функции окна фильтра
ORDER BY оговорка	Сортировка строк результатов
SORT BY оговорка	Сортировка в разделах
предложение CLUSTER BY (SELECT)	Распространение и сортировка данных
DISTRIBUTE BY оговорка	Распределение данных между секциями
LIMIT оговорка	Ограничение строк результатов
OFFSET оговорка	Пропуск строк результатов
PIVOT оговорка	Поворот строк на столбцы
UNPIVOT оговорка	Поворот столбцов на строки
LATERAL VIEW оговорка	Применение функции создания таблиц
TABLESAMPLE оговорка	Примеры строк таблицы
вызов функции с табличным значением (TVF)	Функции, возвращающие таблицы
Общее табличное выражение (CTE)	Именованные вложенные запросы
Операторы множеств	UNION, INTERSECT, EXCEPT
WINDOW оговорка	Определения именованных окон
Подсказки	Указания оптимизатора запросов

Инструкции Delta Lake

Управление таблицами, хранящимися в формате Delta Lake. Дополнительные сведения см. в статье "Что такое Delta Lake в Azure Databricks?".

Statement	Description
CACHE SELECT	Результаты запроса кэша
CONVERT TO DELTA	Преобразование Parquet в Delta
DESCRIBE HISTORY	Отображение журнала таблиц
FSCK REPAIR TABLE	Восстановление метаданных таблицы
GENERATE	Создание манифеста таблицы
OPTIMIZE	Компактные файлы таблиц
REORG TABLE	Реорганизация данных таблицы
RESTORE	Восстановление таблицы до предыдущей версии
VACUUM	Удаление старых файлов таблицы

Инструкции сценариев SQL

Выполнение процедурной логики в SQL. Общие сведения см. в скриптах SQL .

Statement	Description
составной инструкции BEGIN END	Группирование операторов в блок
Инструкция CASE	Условное ветвление
Инструкция FOR	Цикл по диапазону или курсору
GET DIAGNOSTICS заявление	Получение сведений о выполнении
оператор IF THEN ELSE выражение	Условное выполнение
Оператор ITERATE	Продолжить итерацию следующего цикла
Оператор LEAVE	Выход из цикла или блока
Оператор LOOP	Безусловный цикл
Инструкция REPEAT	Цикл до тех пор, пока условие не будет true
Инструкция RESIGNAL	Повторное создание исключения
Оператор SIGNAL	Создание исключения
Оператор WHILE	Цикл в то время как условие имеет значение true

Вспомогательные инструкции

Сбор статистики, управление кэшированием, изучение метаданных, настройка конфигураций и управление ресурсами.

Операторы ANALYZE

Statement	Description
ANALYZE TABLE ... СТАТИСТИКА ВЫЧИСЛЕНИЙ	Статистика столбца таблицы вычислений
ANALYZE TABLE ... МЕТРИКИ ХРАНИЛИЩА ВЫЧИСЛЕНИЙ	Метрики хранилища вычислительных таблиц

Инструкции кэша

Применимо к: Среда выполнения Databricks

Statement	Description
CACHE TABLE	Таблица кэша в памяти
CLEAR CACHE	Удаление всех кэшированных данных
REFRESH CACHE	Обновление кэшированных данных
REFRESH FUNCTION	Обновление метаданных функции
REFRESH TABLE	Обновление метаданных таблицы
UNCACHE TABLE	Удаление таблицы из кэша

Инструкции DESCRIBE

Statement	Description
DESCRIBE CATALOG	Отображение сведений о каталоге
DESCRIBE CONNECTION	Отображение сведений о подключении
DESCRIBE CREDENTIAL	Отображение сведений об учетных данных
DESCRIBE DATABASE	Отображение сведений о базе данных
DESCRIBE FUNCTION	Отображение сведений о функции
DESCRIBE EXTERNAL LOCATION	Отображение сведений о расположении
ОПИСАНИЕ ПРОЦЕДУРЫ	Отображение сведений о процедуре
DESCRIBE PROVIDER	Отображение сведений о поставщике
DESCRIBE QUERY	Показать схему вывода запроса
DESCRIBE RECIPIENT	Отображение сведений о получателе
DESCRIBE SCHEMA	Отображение сведений о схеме
DESCRIBE SHARE	Отображение сведений о общих ресурсах
DESCRIBE TABLE	Отображение сведений о таблице
DESCRIBE VOLUME	Отображение сведений о томе

Инструкции SHOW

Statement	Description
LIST	Вывод списка файлов в пути
SHOW ALL IN SHARE	Отображение всех объектов в общей папке
SHOW CATALOGS	Список каталогов
SHOW COLUMNS	Вывод списка столбцов таблицы
SHOW CONNECTIONS	Перечислить подключения
SHOW CREATE TABLE	Отображение DDL таблицы
SHOW CREDENTIALS	Вывод списка учетных данных
SHOW DATABASES	Список баз данных
SHOW FUNCTIONS	Функции для работы со списками
SHOW GROUPS	Список групп
SHOW EXTERNAL LOCATIONS	Вывод списка внешних расположений
SHOW PARTITIONS	Перечисление секций таблиц
ПОКАЗАТЬ ПРОЦЕДУРЫ	Процедуры перечисления
SHOW PROVIDERS	Список поставщиков
SHOW RECIPIENTS	Перечисление получателей
SHOW SCHEMAS	Список схем
SHOW SHARES	Перечисление общих ресурсов
SHOW SHARES IN PROVIDER	Вывод списка общих папок от поставщика
SHOW TABLE EXTENDED	Отображение сведений о таблице
SHOW TABLES	Перечисление таблиц
SHOW TABLES DROPPED	Список удаленных таблиц
SHOW TBLPROPERTIES	Отображение свойств таблицы
SHOW USERS	Список пользователей
SHOW VIEWS	Представления списков
SHOW VOLUMES	Вывод списка томов

Управление конфигурациями и переменными

Statement	Description
CALL	Вызов хранимой процедуры
EXECUTE IMMEDIATE	Выполнение динамического SQL
RESET	Сброс конфигурации по умолчанию
SET	Настройка параметра конфигурации
SET RECIPIENT	Настройка контекста получателя общего ресурса
SET TIME ZONE	Настройка часового пояса сеанса
SET переменной	Установка значения переменной
USE CATALOG	Установка текущего каталога
USE DATABASE	Установка текущей базы данных
USE SCHEMA	Установка текущей схемы

Управление ресурсами