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

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

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

Note

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

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

В этом общем справочнике описаны типы данных, функции, идентификаторы, литералы и семантика:

• метка "Применимо к"
• Как читать схему синтаксиса
• Добавление комментариев в инструкции SQL
• Параметры конфигурации
• Типы данных и литералы
• Functions
• Правила типа данных SQL
• Шаблоны даты и времени
• Геопространственные функции H3
• Геопространственные функции ST
• Лямбда-функции
• Функции окна
• Identifiers
• Names
• IDENTIFIER оговорка
• Семантика NULL
• Expressions
• Маркеры параметров
• Variables
• Разрешение имен
• Выражения пути JSON
• Collation
• Partitions
• Соответствие ANSI в Databricks Runtime
• Обеспечение совместимости с Apache Hive
• Principals
• Привилегии и защищаемые объекты в каталоге Unity
• Привилегии и защищаемые объекты в хранилище метаданных Hive
• Обновление метаданных каталога Unity
• Внешние расположения
• внешние таблицы
• Credentials
• Volumes
• Скрипты SQL
• Дельта Шеринг
• Федеративные запросы (Федерация Lakehouse)
• Информационная схема
• Зарезервированные слова

Инструкции DDL

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

• ALTER CATALOG
• ALTER CONNECTION
• ALTER CREDENTIAL
• ALTER DATABASE
• Изменить местоположение
• ALTER MATERIALIZED VIEW
• ALTER PROVIDER
• ALTER RECIPIENT
• ALTER STREAMING TABLE
• ALTER TABLE
• ALTER SCHEMA
• ALTER SHARE
• ALTER VIEW
• ALTER VOLUME
• COMMENT ON
• CREATE BLOOMFILTER INDEX;
• CREATE CATALOG
• CREATE CONNECTION
• CREATE DATABASE
• CREATE FUNCTION (SQL)
• CREATE FUNCTION (внешние)
• СОЗДАТЬ МЕСТОПОЛОЖЕНИЕ
• CREATE MATERIALIZED VIEW
• СОЗДАНИЕ ПРОЦЕДУРЫ
• CREATE RECIPIENT
• CREATE SCHEMA
• CREATE SERVER
• CREATE SHARE
• CREATE STREAMING TABLE
• CREATE TABLE
• CREATE VIEW
• CREATE VOLUME
• DECLARE VARIABLE
• DROP BLOOMFILTER INDEX;
• DROP CATALOG
• DROP CONNECTION
• DROP DATABASE
• DROP CREDENTIAL
• DROP FUNCTION
• МЕСТО ВЫГРУЗКИ
• ПРОЦЕДУРА DROP
• DROP PROVIDER
• DROP RECIPIENT
• DROP SCHEMA
• DROP SHARE
• DROP TABLE
• DROP VARIABLE
• DROP VIEW
• DROP VOLUME
• MSCK REPAIR TABLE
• REFRESH FOREIGN (CATALOG, SCHEMAили TABLE)
• REFRESH (MATERIALIZED VIEW или STREAMING TABLE)
• SET ЯРЛЫК
• SYNC
• TRUNCATE TABLE
• UNDROP TABLE
• ТЕГ UNSET

Инструкции DML

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

• COPY INTO
• DELETE FROM
• INSERT В
• INSERT OVERWRITE DIRECTORY
• INSERT OVERWRITE DIRECTORY с форматом Hive
• LOAD DATA
• MERGE INTO
• UPDATE

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

Запрос используется для извлечения строк из одной или нескольких таблиц в соответствии с указанными предложениями. Полный синтаксис и краткое описание поддерживаемых предложений описаны в статье "Запрос ". В этот раздел также включены сведения о связанных инструкциях SQL SELECT и VALUES.

Помимо стандартных запросов SQL в стиле SELECT FROM WHERE, Azure Databricks также поддерживает синтаксис конвейера SQL, который создает SQL в виде ряда цепочки операций, таких как FROM |> WHERE |> SELECT.

• Query
• SELECT
• VALUES
• синтаксис конвейера SQL

Databricks SQL также предоставляет возможность проверки созданного логического и физического плана запроса с помощью инструкции EXPLAIN.

• EXPLAIN
• EXPLAIN CREATE MATERIALIZED VIEW

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

Инструкции Delta Lake SQL используются для управления таблицами, хранящимися в формате Delta Lake:

• CACHE SELECT
• CONVERT TO DELTA
• DESCRIBE HISTORY
• FSCK REPAIR TABLE
• GENERATE
• OPTIMIZE
• REORG TABLE
• RESTORE
• VACUUM

Дополнительные сведения об использовании инструкций Delta Lake см. в статье "Что такое Delta Lake в Azure Databricks?".

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

Скрипты SQL используются для выполнения процедурной логики в SQL.

• Инструкция CASE
• составной инструкции BEGIN END
• Инструкция FOR
• GET DIAGNOSTICS заявление
• оператор IF THEN ELSE выражение
• Оператор ITERATE
• Оператор LEAVE
• Оператор LOOP
• Инструкция REPEAT
• Инструкция RESIGNAL
• Оператор SIGNAL
• Оператор WHILE

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

Вспомогательные инструкции используются для сбора статистики, управления кэшированием, изучения метаданных, настройки конфигураций и управления ресурсами:

• Инструкция анализа
• инструкции кэша Apache Spark;
• Описание выражений
• Показать стейтменты
• Инструкции конфигурации, управления переменными и прочие утверждения
• Управление ресурсами

Команда Анализа

• ANALYZE TABLE

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

Область применения: Databricks Runtime

• CACHE TABLE
• CLEAR CACHE
• REFRESH CACHE
• REFRESH FUNCTION
• REFRESH TABLE
• UNCACHE TABLE

Описание выражений

• DESCRIBE CATALOG
• DESCRIBE CONNECTION
• DESCRIBE CREDENTIAL
• DESCRIBE DATABASE
• DESCRIBE FUNCTION
• ОПИСАНИЕ РАСПОЛОЖЕНИЯ
• ОПИСАНИЕ ПРОЦЕДУРЫ
• DESCRIBE PROVIDER
• DESCRIBE QUERY
• DESCRIBE RECIPIENT
• DESCRIBE SCHEMA
• DESCRIBE SHARE
• DESCRIBE TABLE
• DESCRIBE VOLUME

Показать выражения

• LIST
• SHOW ALL IN SHARE
• SHOW CATALOGS
• SHOW COLUMNS
• SHOW CONNECTIONS
• SHOW CREATE TABLE
• SHOW CREDENTIALS
• SHOW DATABASES
• SHOW FUNCTIONS
• SHOW GROUPS
• ОТОБРАЖЕНИЕ РАСПОЛОЖЕНИЙ
• SHOW PARTITIONS
• ПОКАЗАТЬ ПРОЦЕДУРЫ
• SHOW PROVIDERS
• SHOW RECIPIENTS
• SHOW SCHEMAS
• SHOW SHARES
• SHOW SHARES IN PROVIDER
• ПОКАЗАТЬ TABLE
• SHOW TABLES
• SHOW TABLES DROPPED
• SHOW TBLPROPERTIES
• SHOW USERS
• SHOW VIEWS
• SHOW VOLUMES

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

• CALL
• EXECUTE IMMEDIATE
• RESET
• SET
• SET RECIPIENT
• SET TIMEZONE
• SET VARIABLE
• USE CATALOG
• USE DATABASE
• USE SCHEMA

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

Область применения: Databricks Runtime

• ADD ARCHIVE
• ADD FILE
• ADD JAR
• LIST ARCHIVE
• LIST FILE
• LIST JAR

Область применения: для Databricks SQL Connector

• GET
• PUT INTO
• REMOVE

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

Для управления доступом к данным используются инструкции SQL обеспечения безопасности:

• ALTER GROUP
• CREATE GROUP
• DENY
• DROP GROUP
• GRANT
• GRANT ПОДЕЛИТЬСЯ
• ВОССТАНОВЛЕНИЕ ПРИВИЛЕГИЙ
• REVOKE
• REVOKE ПОДЕЛИТЬСЯ
• SHOW GRANTS
• SHOW GRANTS ON SHARE
• SHOW GRANTS TO RECIPIENT

Дополнительные сведения об использовании этих инструкций см. в разделе "Привилегии хранилища метаданных Hive" и защищаемые объекты (устаревшие версии).