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
- Ordenação
- 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
- 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:
- ALTER CATALOG
- ALTER CONNECTION
- ALTER CREDENTIAL
- ALTER DATABASE
- ALTERAR LOCAL
- 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 (External)
- CRIAR LOCAL
- 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
- LOCAL DE DESTINO
- DROP PROVIDER
- DROP RECIPIENT
- DROP SCHEMA
- DROP SHARE
- DROP TABLE
- DROP VARIABLE
- DROP VIEW
- DROP VOLUME
- MSCK REPAIR TABLE
- REFRESH FOREIGN (CATALOG, SCHEMA, or TABLE)
- REFRESH (MATERIALIZED VIEW or STREAMING TABLE)
- SYNC
- TRUNCATE TABLE
- UNDROP TABLE
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 o formato 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.
Além das consultas SQL padrão no estilo de SELECT FROM WHERE, o Azure Databricks também dá suporte a Sintaxe de Pipeline do SQL que compõe o SQL em forma de uma série de operações encadeadas, como FROM |> WHERE |> SELECT.
O Databricks SQL também fornece a capacidade de inspecionar o plano lógico e físico gerado 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
- DESCRIBE CATALOG
- DESCRIBE CONNECTION
- DESCRIBE CREDENTIAL
- DESCRIBE DATABASE
- DESCRIBE FUNCTION
- DESCRIÇÃO DA LOCALIZAÇÃO
- DESCRIBE PROVIDER
- DESCRIBE QUERY
- DESCRIBE RECIPIENT
- DESCRIBE SCHEMA
- DESCRIBE SHARE
- DESCRIBE TABLE
- DESCRIBE VOLUME
Instruções de exibição
- LIST
- SHOW ALL IN SHARE
- SHOW CATALOGS
- SHOW COLUMNS
- SHOW CONNECTIONS
- SHOW CREATE TABLE
- SHOW CREDENTIALS
- SHOW DATABASES
- SHOW FUNCTIONS
- SHOW GROUPS
- MOSTRAR LOCALIZAÇÕES
- SHOW PARTITIONS
- SHOW PROVIDERS
- SHOW RECIPIENTS
- SHOW SCHEMAS
- SHOW SHARES
- SHOW SHARES IN PROVIDER
- SHOW TABLE
- SHOW TABLES
- SHOW TABLES DROPPED
- SHOW TBLPROPERTIES
- SHOW USERS
- SHOW VIEWS
- SHOW VOLUMES
Configuração, gerenciamento de variáveis e instruções diversas
- EXECUTE IMMEDIATE
- RESET
- SET
- SET RECIPIENT
- SET TIMEZONE
- SET VARIABLE
- USE CATALOG
- USE DATABASE
- USE SCHEMA
Gerenciamento de recursos
Aplica-se a: Databricks Runtime
Aplica-se a: Conector SQL do Databricks
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
- GRANT COMPARTILHAR
- PRIVILÉGIOS DE REPARO
- REVOKE
- REVOKE COMPARTILHAR
- 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).