Referência da linguagem SQL
Esta é uma referência de comando SQL para Databricks SQL e Databricks Runtime.
Para obter informações sobre como usar o SQL com o Delta Live Tables, consulte Referência da linguagem SQL do Delta Live Tables.
Nota
Databricks SQL Serverless não está disponível no Azure China. O Databricks SQL não está disponível nas regiões do Azure Government.
Referência geral
Esta referência geral descreve tipos de dados, funções, identificadores, literais e semânticas:
- 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 data/hora
- Funções geoespaciais H3
- Funções do Lambda
- Funções do Windows
- Identificadores
- Nomes
- Cláusula IDENTIFICADOR
- Semântica NULL
- Expressões
- Marcadores de parâmetros
- Variáveis
- Resolução de nomes
- Expressões de caminho JSON
- Colação
- Partições
- Conformidade com ANSI no Databricks Runtime
- Compatibilidade com o Apache Hive
- Princípios
- Privilégios e objetos protegíveis no Unity Catalog
- Privilégios e objetos protegíveis no metastore do Hive
- Atualizar metadados do Catálogo Unity
- Localizações externas
- Tabelas externas
- Credenciais
- Volumes
- Compartilhamento Delta
- Consultas federadas (Lakehouse Federation)
- Esquema de informação
- Palavras reservadas
Declarações DDL
Utiliza instruções de definição dos dados para criar ou modificar a estrutura de objetos de base de dados numa base de dados:
- CATÁLOGO ALTER
- CONEXÃO ALTER
- CREDENCIAL ALTER
- ALTER DATABASE
- LOCALIZAÇÃO DE ALTER
- ALTER VISÃO MATERIALIZADA
- PROVEDOR ALTER
- DESTINATÁRIO ALTER
- ALTERAR TABELA DE STREAMING
- ALTER TABLE
- ESQUEMA ALTER
- ALTER PARTILHAR
- VISTA ALTER
- ALTER VOLUME
- COMENTAR
- CREATE BLOOMFILTER INDEX
- CRIAR CATÁLOGO
- CRIAR CONEXÃO
- CREATE DATABASE
- FUNÇÃO CREATE (SQL)
- CREATE FUNCTION (Externo)
- CRIAR LOCALIZAÇÃO
- CRIAR VISTA MATERIALIZADA
- CRIAR DESTINATÁRIO
- CRIAR ESQUEMA
- CRIAR SERVIDOR
- CRIAR PARTILHA
- CRIAR TABELA DE STREAMING
- CREATE TABLE
- CREATE VIEW
- CRIAR VOLUME
- DECLARAR VARIÁVEL
- DROP BLOOMFILTER INDEX
- CATÁLOGO DE GOTAS
- CONEXÃO DE QUEDA
- DROP DATABASE
- DESCARTAR CREDENCIAL
- DROP FUNCTION
- LOCAL DE ENTREGA
- PROVEDOR DE DROPS
- DESTINATÁRIO DO DROP
- ESQUEMA DE QUEDA
- DROP SHARE
- DROP TABLE
- VARIÁVEL DE QUEDA
- DROP VIEW
- VOLUME DE QUEDA
- MSCK REPAIR TABLE
- ATUALIZAR ESTRANGEIRO (CATÁLOGO, ESQUEMA ou TABELA)
- REFRESH (VISTA MATERIALIZADA ou TABELA DE STREAMING)
- SINCRONIZAÇÃO
- TRUNCATE TABLE
- TABELA DE DESCARTE
Declarações DML
Você usa instruções de manipulação de dados para adicionar, alterar ou excluir dados de uma tabela Delta Lake:
- COPY INTO
- DELETE FROM
- INSERIR EM
- INSERIR DIRETÓRIO DE SUBSTITUIÇÃO
- INSERT OVERWRITE DIRECTORY com formato Hive
- LOAD DATA
- MERGE INTO
- UPDATE
Instruções de obtençã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 a breve descrição das cláusulas suportadas são explicadas no artigo Consulta .
As instruções SELECT
SQL relacionadas e VALUES
também estão incluídas nesta seção.
O Databricks SQL também fornece a capacidade de gerar o plano lógico e físico para uma consulta usando a EXPLAIN
instrução.
Declarações do Delta Lake
Utiliza instruções SQL do Delta Lake SQL para gerir tabelas armazenadas no formato Delta Lake:
- CACHE SELECT
- CONVERT TO DELTA
- DESCRIBE HISTORY
- FSCK REPAIR TABLE
- GERAR
- OPTIMIZE
- TABELA DE REORGANIZAÇÃO
- RESTAURAR
- VACUUM
Para obter detalhes sobre como usar as instruções Delta Lake, consulte O que é Delta Lake?.
Instruções auxiliares
Utiliza instruções auxiliares para recolher estatísticas, gerir a colocação em cache, explorar metadados, definir configurações e gerir recursos:
- Instrução para analisar
- Instruções do Apache Spark Cache
- Instruções para descrever
- Instruções para mostrar
- Configuração, gerenciamento de variáveis e instruções misc
- Gestão de recursos
Instrução para analisar
Instruções do Apache Spark Cache
Aplica-se a: Databricks Runtime
Instruções para descrever
- DESCREVER CATÁLOGO
- DESCREVER CONEXÃO
- DESCREVER CREDENCIAL
- DESCRIBE DATABASE
- DESCRIBE FUNCTION
- DESCREVER LOCALIZAÇÃO
- DESCREVER PROVEDOR
- DESCREVER CONSULTA
- DESCREVER DESTINATÁRIO
- DESCREVER ESQUEMA
- DESCREVER PARTILHAR
- DESCRIBE TABLE
- DESCREVER VOLUME
Instruções para mostrar
- LISTA
- MOSTRAR TUDO EM PARTILHAR
- MOSTRAR CATÁLOGOS
- SHOW COLUMNS
- MOSTRAR CONEXÕES
- SHOW CREATE TABLE
- MOSTRAR CREDENCIAIS
- SHOW DATABASES
- SHOW FUNCTIONS
- MOSTRAR GRUPOS
- MOSTRAR LOCALIZAÇÕES
- SHOW PARTITIONS
- MOSTRAR FORNECEDORES
- MOSTRAR DESTINATÁRIOS
- MOSTRAR ESQUEMAS
- MOSTRAR PARTILHAS
- MOSTRAR AÇÕES NO PROVEDOR
- SHOW TABLE
- SHOW TABLES
- MOSTRAR TABELAS DESCARTADAS
- MOSTRAR TBLPROPERTIES
- MOSTRAR UTILIZADORES
- MOSTRAR VISUALIZAÇÕES
- MOSTRAR VOLUMES
Configuração, gerenciamento de variáveis e instruções misc
- EXECUTAR IMEDIATAMENTE
- RESET
- SET
- DEFINIR DESTINATÁRIO
- DEFINIR FUSO HORÁRIO
- DEFINIR VARIÁVEL
- CATÁLOGO DE UTILIZAÇÃO
- USE DATABASE
- USAR ESQUEMA
Gestão de recursos
Aplica-se a: Databricks Runtime
Aplica-se a: Databricks SQL Connector
Declarações de segurança
Utiliza instruções SQL de segurança para gerir o acesso a dados:
- GRUPO ALTER
- CRIAR GRUPO
- DENY
- GRUPO DE GOTAS
- GRANT
- PARTE DE SUBVENÇÃO
- PRIVILÉGIOS DE REPARAÇÃO
- REVOKE
- REVOGAR PARTILHA
- MOSTRAR SUBSÍDIOS
- MOSTRAR SUBSÍDIOS EM COMPARTILHAMENTO
- MOSTRAR SUBVENÇÕES AO BENEFICIÁRIO
Para obter detalhes sobre como usar essas instruções, consulte Privilégios de metastore do Hive e objetos protegíveis (legado).