SQL reference for Databricks SQL

Preview

This feature is in Public Preview.

This is a SQL command reference for Databricks SQL.

General reference

This general reference describes data types, functions, identifiers, literals, and semantics:

• How to read a syntax diagram
• Configuration parameters
• Data types and literals
• SQL data type rules
• Datetime patterns
• Built-in functions
• Lambda functions
• Window functions
• Identifiers
• Names
• Null semantics
• Expressions
• JSON path expressions
• Partitions
• Principals
• Privileges and securable objects
• Reserved words

DDL statements

You use data definition statements to create or modify the structure of database objects in a database:

• ALTER DATABASE
• ALTER TABLE
• ALTER SCHEMA
• ALTER VIEW
• COMMENT ON
• CREATE BLOOMFILTER INDEX
• CREATE DATABASE
• CREATE FUNCTION (SQL)
• CREATE SCHEMA
• CREATE TABLE (Databricks SQL)
• CREATE VIEW
• DROP BLOOMFILTER INDEX
• DROP DATABASE
• DROP FUNCTION
• DROP SCHEMA
• DROP TABLE
• DROP VIEW
• MSCK REPAIR TABLE
• TRUNCATE TABLE

DML statements

You use data manipulation statements to add, change, or delete data from a Delta Lake table:

• COPY INTO
• DELETE FROM
• INSERT INTO
• MERGE INTO
• UPDATE

Data retrieval statements

You use a query to retrieve rows from one or more tables according to the specified clauses. The full syntax and brief description of supported clauses are explained in the Query article. The related SQL statements SELECT and VALUES are also included in this section.

• Query
• SELECT
• VALUES

Databricks SQL also provides the ability to generate the logical and physical plan for a query using the EXPLAIN statement.

• EXPLAIN

Delta Lake statements

You use Delta Lake SQL statements to manage tables stored in Delta Lake format:

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

For details on using Delta Lake statements, see Delta Lake guide.

Auxiliary statements

You use auxiliary statements to collect statistics, manage caching, explore metadata, set configurations, and manage resources:

Analyze statement

• ANALYZE TABLE

Describe statements

• DESCRIBE DATABASE
• DESCRIBE FUNCTION
• DESCRIBE QUERY
• DESCRIBE SCHEMA
• DESCRIBE TABLE

Show statements

• SHOW COLUMNS
• SHOW CREATE TABLE
• SHOW DATABASES
• SHOW FUNCTIONS
• SHOW GROUPS
• SHOW PARTITIONS
• SHOW SCHEMAS
• SHOW TABLE
• SHOW TABLES
• SHOW TBLPROPERTIES
• SHOW USERS
• SHOW VIEWS

Configuration management

• RESET
• SET
• SET TIMEZONE
• USE DATABASE
• USE SCHEMA

Security statements

You use security SQL statements to manage access to data:

• ALTER GROUP
• CREATE GROUP
• DENY
• DROP GROUP
• GRANT
• REPAIR PRIVILEGES
• REVOKE
• SHOW GRANTS

For details using these statements, see Data object privileges.