Referência da linguagem SQL
Essa é uma referência de comando SQL para o SQL do Databricks e Databricks Runtime.
Para obter informações sobre como usar o SQL com o Delta Live Tables, consulte Referência de linguagem SQL do Delta Live Tables.
Observação
O Databricks SQL Serverless não está disponível no Azure China. O Databricks SQL não está disponível nas regiões do Azure Governamental.
Referência geral
Esta referência geral descreve os tipos de dados, as funções, os identificadores, os literais e a semântica:
- Rótulo ''Aplica-se a''
- Como ler um diagrama de sintaxe
- Como adicionar comentários a instruções SQL
- Parâmetros de configuração
- Tipos de dados e literais
- Funções
- Regras de tipo de dados SQL
- Padrões de datetime
- Funções H3 geoespaciais
- Funções lambda
- Funções da janela
- Identificadores
- Nomes
- Cláusula IDENTIFIER
- Semântica NULL
- Expressões
- Marcadores de parâmetro
- Variáveis
- Resolução de nomes
- Expressões do caminho JSON
- Partições
- Conformidade com ANSI no Databricks Runtime
- Compatibilidade com o Apache Hive
- Principals
- Privilégios e objetos protegíveis no Catálogo Unity
- Privilégios e objetos protegíveis no metastore do Hive
- Atualizar metadados no Catálogo do Unity
- Locais externos
- Tabelas externas
- Credenciais de armazenamento
- Volumes
- Compartilhamento Delta
- Consultas federadas (Federação de Lakehouse)
- Esquema de informações
- Palavras reservadas
Instruções DDL
Você usa instruções de definição de dados para criar ou modificar a estrutura de objetos de banco de dados em um banco de dados:
- ALTERAR CATÁLOGO
- ALTER CONNECTION
- ALTER CREDENTIAL
- ALTER DATABASE
- ALTERAR LOCAL
- ALTER PROVIDER
- ALTER RECIPIENT
- ALTER STREAMING TABLE
- ALTER TABLE
- ALTER SCHEMA
- ALTER SHARE
- ALTER VIEW
- ALTER VOLUME
- COMMENT ON
- CREATE BLOOMFILTER INDEX
- CRIAR CATÁLOGO
- CREATE CONNECTION
- CREATE DATABASE
- CREATE FUNCTION (SQL)
- CREATE FUNCTION (Externa)
- CRIAR LOCAL
- CRIAR A EXIBIÇÃO MATERIALIZADA
- CRIAR DESTINATÁRIO
- CREATE SCHEMA
- CREATE SERVER
- CREATE SHARE
- CREATE STREAMING TABLE
- CREATE TABLE
- CREATE VIEW
- CREATE VOLUME
- VARIÁVEL DECLARE
- DROP BLOOMFILTER INDEX
- CATÁLOGO DE DESTINO
- DROP CONNECTION
- DROP DATABASE
- DROP CREDENTIAL
- DROP FUNCTION
- LOCAL DE DESTINO
- DROP PROVIDER
- RECIPIENTE DE DESTINO
- DROP SCHEMA
- DROP SHARE
- DROP TABLE
- VARIÁVEL DROP
- DROP VIEW
- DROP VOLUME
- MSCK REPAIR TABLE
- REFRESH FOREIGN (CATALOG, SCHEMA ou TABLE)
- REFRESH (MATERIALIZED VIEW ou STREAMING TABLE)
- SINCRONIZAR
- TRUNCATE TABLE
- TABELA NÃO REMOVIDA
Instruções DML
Você usa instruções de manipulação de dados para adicionar, alterar ou excluir dados da tabela do Delta Lake:
- COPY INTO
- DELETE FROM
- INSERT INTO
- INSERT OVERWRITE DIRECTORY
- INSERT OVERWRITE DIRECTORY com formato do Hive
- LOAD DATA
- MERGE INTO
- UPDATE
Instruções de recuperação de dados
Use uma consulta para recuperar linhas de uma ou mais tabelas de acordo com as cláusulas especificadas. A sintaxe completa e uma breve descrição das cláusulas com suporte são explicadas no artigo Consulta.
As instruções SQL SELECT e VALUES relacionadas também estão incluídas nesta seção.
O SQL do Databricks também oferece a capacidade de gerar o plano lógico e físico para uma consulta usando a instrução EXPLAIN.
Instruções do Delta Lake
Você usa instruções SQL do Delta Lake para gerenciar tabelas armazenadas no formato Delta Lake:
- CACHE SELECT
- CONVERT TO DELTA
- DESCRIBE HISTORY
- FSCK REPAIR TABLE
- GENERATE
- OPTIMIZE
- REORG TABLE
- RESTORE
- VACUUM
Para obter detalhes sobre como usar instruções do Delta Lake, confira O que é Delta Lake?.
Instruções auxiliares
Você usa instruções auxiliares para coletar estatísticas, gerenciar o cache, explorar metadados, definir configurações e gerenciar recursos:
- Instrução de análise
- Instruções de cache do Apache Spark
- Instruções de descrição
- Instruções de exibição
- Configuração, gerenciamento de variáveis e instruções diversas
- Gerenciamento de recursos
Instrução de análise
Instruções de cache do Apache Spark
Aplica-se a: 
Databricks Runtime
Instruções de descrição
- DESCRIÇÃO DO CATÁLOGO
- DESCRIBE CONNECTION
- DESCRIÇÃO DA CREDENCIAL
- DESCRIBE DATABASE
- DESCRIBE FUNCTION
- DESCRIÇÃO DA LOCALIZAÇÃO
- DESCRIBE PROVIDER
- DESCRIBE QUERY
- DESCRIÇÃO DO RECIPIENTE
- DESCRIÇÃO DO ESQUEMA
- DESCRIBE SHARE
- DESCRIBE TABLE
- DESCRIBE VOLUME
Instruções de exibição
- LISTA
- SHOW ALL IN SHARE
- MOSTRAR CATÁLOGOS
- SHOW COLUMNS
- SHOW CONNECTIONS
- SHOW CREATE TABLE
- MOSTRAR CREDENCIAIS
- SHOW DATABASES
- SHOW FUNCTIONS
- SHOW GROUPS
- MOSTRAR LOCALIZAÇÕES
- SHOW PARTITIONS
- SHOW PROVIDERS
- MOSTRAR DESTINATÁRIOS
- MOSTRAR ESQUEMAS
- SHOW SHARES
- MOSTRAR COMPARTILHAMENTOS NO PROVEDOR
- SHOW TABLE
- SHOW TABLES
- MOSTRAR AS TABELAS REMOVIDAS
- SHOW TBLPROPERTIES
- SHOW USERS
- SHOW VIEWS
- SHOW VOLUMES
Configuração, gerenciamento de variáveis e instruções diversas
- EXECUTAR IMEDIATAMENTE
- REDEFINIR
- SET
- SET TIMEZONE
- DEFINIR VARIÁVEL
- USAR CATÁLOGO
- USE DATABASE
- USAR ESQUEMA
Gerenciamento de recursos
Aplica-se a: Databricks Runtime
Instruções de segurança
Você usa as instruções SQL de segurança para gerenciar o acesso aos dados:
- ALTER GROUP
- CREATE GROUP
- DENY
- DROP GROUP
- GRANT
- CONCESSÃO DE COMPARTILHAR
- PRIVILÉGIOS DE REPARO
- REVOKE
- REVOGAR COMPARTILHAMENTO
- SHOW GRANTS
- SHOW GRANTS ON SHARE
- SHOW GRANTS TO RECIPIENT
Para obter detalhes sobre como usar essas instruções, consulte Privilégios de metastore do Hive e objetos protegíveis (herdados).