Referência da linguagem SQL

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

Para informações sobre como compreender e usar a notação sintática e os símbolos desta referência, veja Como usar a referência SQL.

Para obter informações sobre como usar SQL com Lakeflow Spark Declarative Pipelines, consulte Referência da linguagem Pipeline SQL.

Note

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.

Fundamentos da língua

Reference	Description
Adicionar comentários a instruções SQL	Adicionar comentários ao seu código SQL
Palavras e esquemas reservados	Palavras-chave reservadas pelo parser SQL
Identifiers	Regras para nomear objetos de base de dados
Names	Convenções de nomeação de objetos
IDENTIFIER cláusula	Resolução dinâmica de identificadores
Expressão SQL	Sintaxe e avaliação de expressões SQL
Semântica NULL	Como os valores NULL são tratados
Marcadores de parâmetros	Espaços reservados para consultas parametrizadas
Variables	Variáveis de sessão e temporárias
Resolução de nomes	Como os nomes dos objetos são resolvidos
Expressão de caminho JSON	Navegação por estruturas de dados JSON
Collation	Regras de comparação e ordenação de cadeias
Partitions	Conceitos de particionamento de tabelas

Tipos de dados

Reference	Description
Tipos de dados	Visão geral de todos os tipos de dados suportados
Regras de tipo de dados SQL	Coerção de tipo e regras de conversão
Padrões de data e hora	Padrões de formato para datas e horas

Parâmetros de configuração

Reference	Description
Parâmetros de configuração	Visão geral da configuração SQL
ANSI_MODE	Modo de conformidade ANSI SQL
LEGACY_TIME_PARSER_POLICY	Comportamento de análise temporal
MAX_FILE_PARTITION_BYTES	Limite de tamanho de partição de ficheiros
READ_ONLY_EXTERNAL_METASTORE	Modo de acesso externo a metastore
STATEMENT_TIMEOUT	Definir o tempo de espera da consulta
TIMEZONE	Fuso horário da sessão
USE_CACHED_RESULT	Cache de resultados de consulta

Funções

Reference	Description
Functions	Visão geral das funções SQL
Funções incorporadas	Todas as funções integradas
Lista alfabética de funções incorporadas	Referência completa da função A-Z
Funções do Windows	Funções analíticas e de classificação
Funções do Lambda	Expressões de funções anónimas
Funções geoespaciais H3	Índice espacial hierárquico hexagonal
Funções geoespaciais ST	Funções geoespaciais padrão
Funções agregadas definidas pelo usuário (UDAFs)	Funções de agregação personalizadas
Funções escalares definidas pelo usuário externo (UDFs)	Funções escalares personalizadas
Integração com funcionalidades UDFs, UDAFs e UDTFs do Hive	Compatibilidade com funções colmeia
Invocação de função	Como chamar funções

Conceitos do Catálogo Unity

Reference	Description
Diretor	Utilizadores, grupos e principais de serviço
Privilégios e objetos protegíveis no Unity Catalog	Controle de acesso no Catálogo Unity
Privilégios e objetos protegíveis no metastore do Hive	Controlo de acesso legado a metastore
Localizações externas	Localizações de armazenamento na nuvem
Tabelas externas	Tabelas suportadas por dados externos
Credentials	Credenciais de acesso ao armazenamento
Volumes	Armazenamento de ficheiros gerido e externo

Tópicos especiais

Reference	Description
Conformidade com ANSI no Databricks Runtime	Compatibilidade com o padrão ANSI SQL
Compatibilidade com o Apache Hive	Compatibilidade Hive SQL
Scripting SQL	Lógica procedural SQL
Compartilhamento Delta	Partilha de dados entre organizações
Consultas federadas (Federação Lakehouse)	Consulta a bases de dados externas
Esquema de informação	Tabelas do sistema de metadados

Declarações DDL

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

Declarações ALTER

Declaração	Description
ALTER CATALOG	Modificar propriedades do catálogo
ALTER CONNECTION	Modificar definições de ligação
ALTER CREDENTIAL	Modificar propriedades de credencial
ALTER DATABASE	Modificar propriedades da base de dados
ALTER EXTERNAL LOCATION	Modificar localização externa
ALTER MATERIALIZED VIEW	Modificar a visualização materializada
ALTER PROVIDER	Modificar fornecedor de dados
ALTER RECIPIENT	Modificar o destinatário da quota
ALTER SCHEMA	Modificar propriedades do esquema
ALTER SHARE	Modificar a configuração da partilha
ALTER STREAMING TABLE	Modificar tabela de streaming
ALTER TABLE	Modificar a estrutura da tabela
ALTER VIEW	Modificar definição de vista
ALTER VOLUME	Modificar propriedades de volume

Instruções CREATE

Declaração	Description
CREATE BLOOM FILTER INDEX	Criar um índice de filtro de bloom
CREATE CATALOG	Criar um novo catálogo
CREATE CONNECTION	Criar ligação externa
CREATE DATABASE	Criar uma nova base de dados
CREATE FUNCTION (SQL e Python)	Criar função SQL
CREATE FUNCTION (Externo)	Criar função externa
CREATE EXTERNAL LOCATION	Criar localização externa
CREATE MATERIALIZED VIEW	Criar vista materializada
CRIAR PROCEDIMENTO	Criar procedimento armazenado
CREATE RECIPIENT	Criar destinatário de partilha
CREATE SCHEMA	Criar um novo esquema
CREATE SERVER	Criar servidor estrangeiro
CREATE SHARE	Criar partilha 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 as afirmações

Outras declarações DDL

Declaração	Description
COMMENT ON	Adicionar comentários aos objetos
DECLARE VARIABLE	Declarar variável de sessão
REPAIR TABLE	Recuperar partições de tabela
REFRESH FOREIGN (CATALOG, SCHEMA, e TABLE)	Atualizar metadados estrangeiros
REFRESH (MATERIALIZED VIEW ou STREAMING TABLE)	Atualizar dados materializados
SET ETIQUETA	Adicionar etiquetas a objetos
`SYNC`	Sincronizar metadados
TRUNCATE TABLE	Remover todos os dados da tabela
DESCARTE	Restaurar tabela descartada
TAG NÃO DEFINIDA	Remover etiquetas de objetos

Instruções DML

As instruções de manipulação de dados adicionam, alteram ou eliminam dados em tabelas Delta Lake.

Declaração	Description
`COPY INTO`	Carregar dados dos ficheiros numa tabela
DELETE FROM	Eliminar linhas de uma tabela
INSERT	Inserir linhas numa tabela
INSERT OVERWRITE DIRECTORY	Escrever resultados de consulta no diretório
INSERT OVERWRITE DIRECTORY com formato Hive	Escrever resultados em formato Colmeia
LOAD DATA	Carregar dados a partir de ficheiros
MERGE INTO	Dados upsert numa tabela
UPDATE	Atualizar linhas numa tabela

Declarações de recuperação de dados

Recuperar linhas das tabelas de acordo com as cláusulas especificadas. O Azure Databricks suporta tanto a sintaxe padrão SELECT como a sintaxe SQL Pipeline.

Instruções de consulta

Declaração	Description
Query	Referência completa da sintaxe da consulta
SELECT (subselecionar)	Selecionar dados a partir de tabelas
VALUES cláusula	Construir tabela inline
Sintaxe de Pipeline SQL	Composição de consultas baseada em pipes
EXPLAIN	Mostrar plano de execução da consulta

Cláusulas de consulta

Cláusula	Description
SELECT cláusula	Seleção de colunas
Cláusula * (estrela)	Selecionar todas as colunas
referência de tabela	Fontes de tabela e subconsultas
JOIN	Combinar linhas a partir de tabelas
WHERE cláusula	Filtrar linhas
GROUP BY cláusula	Agrupar linhas para agregação
HAVING cláusula	Filtrar linhas agrupadas
QUALIFY cláusula	Resultados da função janela de filtro
ORDER BY cláusula	Ordenar linhas de resultados
SORT BY cláusula	Ordenar dentro das partições
CLUSTER BY cláusula (SELECT)	Distribuir e ordenar dados
DISTRIBUTE BY cláusula	Distribuição de dados entre partições
LIMIT cláusula	Linhas de resultado limite
OFFSET cláusula	Saltar linhas de resultados
PIVOT cláusula	Rodar as linhas para as colunas
UNPIVOT cláusula	Rodar colunas para linhas
LATERAL VIEW cláusula	Aplicar a função geradora de tabela
TABLESAMPLE cláusula	Linhas de tabela de exemplo
Invocação da função com valor de tabela (TVF)	Funções que retornam tabelas
Expressão de tabela comum (CTE)	Subconsultas nomeadas
Definir operadores	UNIÃO, INTERSECTA, EXCETO
WINDOW cláusula	Definições de janelas nomeadas
Dicas	Dicas do otimizador de consultas

Declarações de Delta Lake

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

Declaração	Description
CACHE SELECT	Resultados da consulta à cache
CONVERT TO DELTA	Conversão de Parquet em Delta
DESCRIBE HISTORY	Histórico da tabela de apresentação
FSCK REPAIR TABLE	Metadados da tabela de reparação
GENERATE	Gerar manifesto de tabela
OPTIMIZE	Ficheiros de tabela compacta
REORG TABLE	Reorganizar os dados das tabelas
RESTORE	Restaurar tabela à versão anterior
VACUUM	Remover ficheiros de tabela antigos

Instruções de scripting SQL

Executar lógica procedural em SQL. Veja scripting SQL para uma visão geral.

Declaração	Description
Instrução composta BEGIN END	Agrupar instruções num bloco
Declaração CASE	Ramificação condicional
PARA declaração	Loop sobre um intervalo ou cursor
GET declaração de diagnóstico	Recuperar informação de execução
DECLARAÇÃO IF THEN ELSE	Execução condicional
Declaração ITERATE	Continuar para a próxima iteração do ciclo
Declaração LEAVE	Sai de um circuito ou bloco
Instrução LOOP	Laço incondicional
Instrução REPEAT	Loop até que a condição seja verdadeira
Declaração RESIGNAL	Voltar a levantar uma exceção
Declaração SIGNAL	Levantar uma exceção
Declaração WHILE	Laço enquanto a condição é verdadeira

Instruções auxiliares

Recolha estatísticas, gere o cache, explora metadados, define configurações e gere recursos.

Instruções ANALYZE

Declaração	Description
ANALYZE TABLE ... CALCULAR ESTATÍSTICAS	Cálculo das estatísticas das colunas da tabela
ANALYZE TABLE ... MÉTRICAS DE COMPUTAÇÃO DE ARMAZENAMENTO	Métricas de armazenamento por tabela de cálculo

Instruções de cache

Aplica-se a: Databricks Runtime

Declaração	Description
CACHE TABLE	Tabela de cache na memória
CLEAR CACHE	Remover todos os dados em cache
REFRESH CACHE	Atualizar os dados em cache
REFRESH FUNCTION	Metadados da função de atualização
REFRESH TABLE	Metadados da tabela de atualização
UNCACHE TABLE	Remover tabela do cache

Instruções DESCRIBE

Declaração	Description
DESCRIBE CATALOG	Detalhes do catálogo do espetáculo
DESCRIBE CONNECTION	Detalhes da ligação para mostrar
DESCRIBE CREDENTIAL	Mostrar detalhes da credencial
DESCRIBE DATABASE	Detalhes da base de dados do programa
DESCRIBE FUNCTION	Mostrar detalhes da função
DESCRIBE EXTERNAL LOCATION	Mostrar detalhes da localização
DESCREVER PROCEDIMENTO	Detalhes do procedimento do espetáculo
DESCRIBE PROVIDER	Detalhes do fornecedor do programa
DESCRIBE QUERY	Mostrar esquema de saída de consulta
DESCRIBE RECIPIENT	Mostrar detalhes do destinatário
DESCRIBE SCHEMA	Mostrar detalhes do esquema
DESCRIBE SHARE	Detalhes da partilha do programa
DESCRIBE TABLE	Detalhes da tabela de apresentação
DESCRIBE VOLUME	Detalhes do volume do programa

Declarações do SHOW

Declaração	Description
LIST	Ficheiros de lista num caminho
SHOW ALL IN SHARE	Mostrar todos os objetos em partilha
SHOW CATALOGS	Catálogos de listas
SHOW COLUMNS	Colunas da tabela de listas
SHOW CONNECTIONS	Listar conexões
SHOW CREATE TABLE	Tabela de apresentação DDL
SHOW CREDENTIALS	Credenciais da lista
SHOW DATABASES	Listar bases de dados
SHOW FUNCTIONS	Funções relacionadas a listas
SHOW GROUPS	Listar grupos
SHOW EXTERNAL LOCATIONS	Lista de localizações externas
SHOW PARTITIONS	Partições de tabelas de listas
MOSTRAR PROCEDIMENTOS	Procedimentos de lista
SHOW PROVIDERS	Fornecedores de listas
SHOW RECIPIENTS	Destinatários da lista
SHOW SCHEMAS	Listar esquemas
SHOW SHARES	Ações de cotação
SHOW SHARES IN PROVIDER	Quotas de lista do fornecedor
SHOW TABLE EXTENDED	Informações da tabela de apresentação
SHOW TABLES	Listar tabelas
SHOW TABLES DROPPED	Tabelas de listas descartadas
SHOW TBLPROPERTIES	Mostrar propriedades da tabela
SHOW USERS	Listar utilizadores
SHOW VIEWS	Modos de exibição de lista
SHOW VOLUMES	Volumes de lista

Configuração e gestão de variáveis

Declaração	Description
CALL	Chamar um procedimento armazenado
EXECUTE IMMEDIATE	Executar SQL dinâmico
RESET	Redefinir a configuração para o padrão
SET	Definir parâmetro de configuração
SET RECIPIENT	Definir o contexto do destinatário da partilha
SET TIME ZONE	Definir o fuso horário da sessão
SET variável	Valor da variável definida
USE CATALOG	Catálogo atual do conjunto
USE DATABASE	Definir base de dados atual
USE SCHEMA	Esquema atual definido

Gestão de recursos