Referência da linguagem SQL

Esta é uma referência de comandos SQL para o Databricks SQL e o Databricks Runtime.

Para obter informações sobre como entender e usar a notação de sintaxe e símbolos nessa referência, consulte Como usar a referência do SQL.

Para obter informações sobre como usar o SQL com o Lakeflow Spark Declarative Pipelines, consulte a referência de linguagem SQL do Pipeline.

Note

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 para Governos.

Referência geral

Essa referência geral descreve tipos de dados, funções, identificadores, literais e semântica.

Conceitos básicos da linguagem

Referência	DESCRIÇÃO
Adicionando comentários a instruções SQL	Adicionando comentários ao código SQL
Palavras reservadas e esquemas	Palavras-chave reservadas pelo analisador do SQL
Identifiers	Regras para nomear objetos de banco de dados
Names	Convenções de nomenclatura de objeto
Cláusula IDENTIFIER	Resolução do identificador dinâmico
Expressão SQL	Sintaxe e avaliação da expressão SQL
Semântica NULL	Como os valores NULL são tratados
Marcadores de parâmetro	Espaços reservados de consulta parametrizados
Variables	Variáveis temporárias e de sessão
Resolução de nomes	Como os nomes de objeto são resolvidos
Expressão de caminho JSON	Navegando em estruturas de dados JSON
Collation	Regras de comparação e classificação de cadeia de caracteres
Partitions	Conceitos de particionamento de tabela

Tipos de dados

Referência	DESCRIÇÃO
Tipos de dados	Visão geral de todos os tipos de dados com suporte
Regras de tipo de dados SQL	Regras de coerção e conversão de tipo
Padrões de datetime	Formatar padrões para datas e horas

Parâmetros de configuração

Referência	DESCRIÇÃO
Parâmetros de configuração	Visão geral da configuração do SQL
ANSI_MODE	Modo de conformidade do SQL ANSI
LEGACY_TIME_PARSER_POLICY	Comportamento de análise de tempo
MAX_FILE_PARTITION_BYTES	Limite de tamanho da partição de arquivo
READ_ONLY_EXTERNAL_METASTORE	Modo de acesso de metastore externo
STATEMENT_TIMEOUT	Configuração de tempo limite de consulta
TIMEZONE	Fuso horário da sessão
USE_CACHED_RESULT	Cache de resultados de consulta

Functions

Referência	DESCRIÇÃO
Functions	Visão geral das funções SQL
Funções internas	Todas as funções internas
Lista alfabética de funções internas	Referência de função A-Z completa
Funções da janela	Funções analíticas e de classificação
Funções lambda	Expressões de função anônimas
Funções H3 geoespaciais	Índice espacial hierárquico hexagonal
Funções geoespaciais ST	Funções geoespaciais padrão
UDAFs (Funções de agregação definidas pelo usuário)	Funções de agregação personalizadas
Funções escalares definidas pelo usuário externo (UDFs)	Funções escalares personalizadas
Integração com as UDFs, as UDAFs e as UDTFs do Hive	Compatibilidade de função do Hive
Invocação de função	Como chamar funções

Conceitos do Catálogo do Unity

Referência	DESCRIÇÃO
Entidade de segurança	Usuários, grupos e entidades de serviço
Privilégios e objetos protegíveis no Catálogo Unity	Controle de acesso no Catálogo do Unity
Privilégios e objetos protegíveis no metastore do Hive	Controle de acesso do metastore herdado
Locais externos	Locais de armazenamento em nuvem
tabelas externas	Tabelas apoiadas por dados externos
Credentials	Credenciais de acesso ao armazenamento
Volumes	Armazenamento de arquivos gerenciado e externo

Tópicos especiais

Referência	DESCRIÇÃO
Conformidade com ANSI no Databricks Runtime	Compatibilidade padrão do ANSI SQL
Compatibilidade com o Apache Hive	Compatibilidade do SQL do Hive
Scripts SQL	Lógica do SQL de procedimento
Compartilhamento Delta	Compartilhamento de dados entre organizações
Consultas federadas (Federação de Lakehouse)	Consultando bancos de dados externos
Esquema de informações	Tabelas do sistema de metadados

Instruções DDL

As instruções de definição de dados criam ou modificam a estrutura de objetos de banco de dados.

Instruções ALTER

Statement	DESCRIÇÃO
ALTER CATALOG	Modificar propriedades do catálogo
ALTER CONNECTION	Modificar configurações de conexão
ALTER CREDENTIAL	Modificar propriedades de credencial
ALTER DATABASE	Modificar propriedades do banco de dados
ALTER EXTERNAL LOCATION	Modificar o local externo
ALTER MATERIALIZED VIEW	Modificar exibição materializada
ALTER PROVIDER	Modificar o provedor de dados
ALTER RECIPIENT	Modificar o destinatário do compartilhamento
ALTER SCHEMA	Modificar propriedades de esquema
ALTER SHARE	Modificar a configuração de compartilhamento
ALTER STREAMING TABLE	Modificar tabela de streaming
ALTER TABLE	Modificar estrutura de tabela
ALTER VIEW	Modificar definição de exibição
ALTER VOLUME	Modificar propriedades de volume

Instruções CREATE

Statement	DESCRIÇÃO
CREATE BLOOM FILTER INDEX	Criar índice de filtro de flores
CREATE CATALOG	Criar um novo catálogo
CREATE CONNECTION	Criar conexão externa
CREATE DATABASE	Criar um novo banco de dados
CREATE FUNCTION (SQL e Python)	Criar função SQL
CREATE FUNCTION (Externo)	Criar função externa
CREATE EXTERNAL LOCATION	Criar local externo
CREATE MATERIALIZED VIEW	Criar exibição materializada
CRIAR PROCEDIMENTO	Criar procedimento armazenado
CREATE RECIPIENT	Criar destinatário de compartilhamento
CREATE SCHEMA	Criar um novo esquema
CREATE SERVER	Criar servidor estrangeiro
CREATE SHARE	Criar compartilhamento de dados
CREATE STREAMING TABLE	Criar tabela de streaming
CREATE TABLE	Criar uma nova tabela
CREATE VIEW	Criar uma visualização
CREATE VOLUME	Criar um volume

Analisar instruções

Outras instruções DDL

Statement	DESCRIÇÃO
COMMENT ON	Adicionar comentários a objetos
DECLARE VARIABLE	Declarar variável de sessão
REPAIR TABLE	Recuperar partições de tabela
REFRESH FOREIGN (CATALOG, SCHEMAe TABLE)	Atualizar metadados estrangeiros
REFRESH (MATERIALIZED VIEW ou STREAMING TABLE)	Atualizar dados materializados
SET ETIQUETA	Adicionar marcas a objetos
`SYNC`	Sincronizar metadados
TRUNCATE TABLE	Remover todos os dados da tabela
UNDROP	Restaurar tabela descartada
MARCA UNSET	Remover marcas de objetos

Instruções DML

As instruções de manipulação de dados adicionam, alteram ou excluem dados em tabelas delta lake.

Statement	DESCRIÇÃO
`COPY INTO`	Carregar dados de arquivos em uma tabela
DELETE FROM	Excluir linhas de uma tabela
INSERT	Inserir linhas em uma tabela
INSERT OVERWRITE DIRECTORY	Gravar resultados da consulta no diretório
INSERT OVERWRITE DIRECTORY com o formato Hive	Gravar resultados no formato Hive
LOAD DATA	Carregar dados de arquivos
MERGE INTO	Upsert data into a table
UPDATE	Atualizar linhas em uma tabela

Instruções de recuperação de dados

Recupere linhas de tabelas de acordo com cláusulas especificadas. O Azure Databricks dá suporte à sintaxe padrão SELECT e à sintaxe do SQL Pipeline.

Instruções de consulta

Statement	DESCRIÇÃO
Query	Referência de sintaxe de consulta completa
SELECT (subseleção)	Selecionar dados de tabelas
Cláusula VALUES	Construir tabela embutida
Sintaxe do Pipeline do SQL	Composição de consulta baseada em pipe
EXPLAIN	Mostrar plano de execução de consulta

Cláusulas de consulta

Cláusula	DESCRIÇÃO
Cláusula SELECT	Seleção de coluna
* (estrela) cláusula	Selecionar todas as colunas
referência de tabela	Fontes de tabela e subconsulta
JOIN	Combinar linhas de tabelas
Cláusula WHERE	Filtrar linhas
Cláusula GROUP BY	Agrupar linhas para agregação
Cláusula HAVING	Filtrar linhas agrupadas
Cláusula QUALIFY	Filtrar resultados da função de janela
Cláusula ORDER BY	Classificar linhas de resultado
Cláusula SORT BY	Classificar dentro de partições
cláusula CLUSTER BY (SELECT)	Distribuir e classificar dados
Cláusula DISTRIBUTE BY	Distribuir dados entre partições
Cláusula LIMIT	Limitar linhas de resultado
Cláusula OFFSET	Ignorar linhas de resultados
Cláusula PIVOT	Girar linhas em colunas
Cláusula UNPIVOT	Girar colunas em linhas
Cláusula LATERAL VIEW	Aplicar função de geração de tabela
Cláusula TABLESAMPLE	Linhas de tabela de exemplo
Invocação de TVF (função com valor de tabela)	Funções retornando tabelas
Expressão de tabela comum (CTE)	Subconsultas nomeadas
Definir operadores	UNION, INTERSECT, EXCEPT
Cláusula WINDOW	Definições de janela nomeadas
Dicas	Dicas do otimizador de consulta

Instruções delta lake

Gerenciar tabelas armazenadas no formato Delta Lake. Para obter detalhes, consulte o que é o Delta Lake no Azure Databricks?.

Statement	DESCRIÇÃO
CACHE SELECT	Resultados da consulta de cache
CONVERT TO DELTA	Converter Parquet em Delta
DESCRIBE HISTORY	Mostrar histórico de tabelas
FSCK REPAIR TABLE	Reparar metadados da tabela
GENERATE	Gerar manifesto da tabela
OPTIMIZE	Arquivos de tabela compacta
REORG TABLE	Reorganizar dados da tabela
RESTORE	Restaurar tabela para a versão anterior
VACUUM	Remover arquivos de tabela antigos

Instruções de script SQL

Execute a lógica de procedimento no SQL. Confira o script SQL para obter uma visão geral.

Statement	DESCRIÇÃO
Instrução composta BEGIN END	Agrupar instruções em um bloco
Instrução CASE	Ramificação condicional
Instrução FOR	Loop sobre um intervalo ou cursor
GET Instrução DIAGNOSTICS	Recuperar informações de execução
Instrução IF THEN ELSE	Execução condicional
Instrução ITERATE	Continuar para a próxima iteração de loop
Instrução LEAVE	Sair de um loop ou bloco
Instrução LOOP	Loop incondicional
Instrução REPEAT	Loop até que a condição seja verdadeira
Instrução RESIGNAL	Gerar novamente uma exceção
Instrução SIGNAL	Gerar uma exceção
Instrução WHILE	Loop enquanto a condição é verdadeira

Declarações auxiliares

Colete estatísticas, gerencie o cache, explore metadados, defina configurações e gerencie recursos.

Instruções ANALYZE

Statement	DESCRIÇÃO
ANALYZE TABLE … ESTATÍSTICAS DE COMPUTAÇÃO	Estatísticas da coluna da tabela de computação
ANALYZE TABLE … MÉTRICAS DE ARMAZENAMENTO DE COMPUTAÇÃO	Métricas de armazenamento de tabela de computação

Instruções de cache

Aplica-se a: Databricks Runtime

Statement	DESCRIÇÃO
CACHE TABLE	Tabela de cache na memória
CLEAR CACHE	Remover todos os dados armazenados em cache
REFRESH CACHE	Atualizar dados armazenados em cache
REFRESH FUNCTION	Atualizar metadados de função
REFRESH TABLE	Atualizar metadados da tabela
UNCACHE TABLE	Remover tabela do cache

Instruções DESCRIBE

Statement	DESCRIÇÃO
DESCRIBE CATALOG	Mostrar detalhes do catálogo
DESCRIBE CONNECTION	Mostrar detalhes da conexão
DESCRIBE CREDENTIAL	Mostrar detalhes da credencial
DESCRIBE DATABASE	Mostrar detalhes do banco de dados
DESCRIBE FUNCTION	Mostrar detalhes da função
DESCRIBE EXTERNAL LOCATION	Mostrar detalhes do local
DESCREVER PROCEDIMENTO	Mostrar detalhes do procedimento
DESCRIBE PROVIDER	Mostrar detalhes do provedor
DESCRIBE QUERY	Mostrar esquema de saída de consulta
DESCRIBE RECIPIENT	Mostrar detalhes do destinatário
DESCRIBE SCHEMA	Mostrar detalhes do esquema
DESCRIBE SHARE	Mostrar detalhes do compartilhamento
DESCRIBE TABLE	Mostrar detalhes da tabela
DESCRIBE VOLUME	Mostrar detalhes do volume

Instruções SHOW

Statement	DESCRIÇÃO
LIST	Listar arquivos em um caminho
SHOW ALL IN SHARE	Mostrar todos os objetos em compartilhamento
SHOW CATALOGS	Listar catálogos
SHOW COLUMNS	Listar colunas de tabela
SHOW CONNECTIONS	Listar conexões
SHOW CREATE TABLE	Mostrar DDL da tabela
SHOW CREDENTIALS	Listar credenciais
SHOW DATABASES	Listar bancos de dados
SHOW FUNCTIONS	Listar funções
SHOW GROUPS	Listar grupos
SHOW EXTERNAL LOCATIONS	Listar locais externos
SHOW PARTITIONS	Listar partições de tabela
MOSTRAR PROCEDIMENTOS	Listar procedimentos
SHOW PROVIDERS	Listar provedores
SHOW RECIPIENTS	Listar destinatários
SHOW SCHEMAS	Listar esquemas
SHOW SHARES	Listar shares
SHOW SHARES IN PROVIDER	Listar compartilhamentos do provedor
SHOW TABLE EXTENDED	Mostrar informações da tabela
SHOW TABLES	Listar tabelas
SHOW TABLES DROPPED	Listar tabelas descartadas
SHOW TBLPROPERTIES	Mostrar propriedades da tabela
SHOW USERS	Listar usuários
SHOW VIEWS	Modos de exibição de lista
SHOW VOLUMES	Listar volumes

Configuração e gerenciamento de variáveis

Statement	DESCRIÇÃO
CALL	Chamar um procedimento armazenado
EXECUTE IMMEDIATE	Executar SQL dinâmico
RESET	Redefinir a configuração como padrão
SET	Definir parâmetro de configuração
SET RECIPIENT	Definir o contexto do destinatário do compartilhamento
SET TIME ZONE	Definir fuso horário de sessão
SET variável	Definir valor de variável
USE CATALOG	Definir catálogo atual
USE DATABASE	Definir banco de dados atual
USE SCHEMA	Definir esquema atual

Gestão de recursos