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 de janela
- Identificadores
- Nomes
- IDENTIFIER cláusula
- 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ções
- 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:
- ALTER CATALOG
- ALTER CONNECTION
- ALTER CREDENTIAL
- ALTER DATABASE
- LOCALIZAÇÃO DE ALTER
- 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 (Externo)
- CRIAR LOCALIZAÇÃO
- 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 ENTREGA
- DROP PROVIDER
- DROP RECIPIENT
- DROP SCHEMA
- DROP SHARE
- DROP TABLE
- DROP VARIABLE
- DROP VIEW
- DROP VOLUME
- MSCK REPAIR TABLE
- REFRESH FOREIGN (CATALOG, SCHEMAou TABLE)
- REFRESH (MATERIALIZED VIEW ou STREAMING TABLE)
- SYNC
- TRUNCATE TABLE
- UNDROP TABLE
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
- INSERT PARA
- INSERT OVERWRITE DIRECTORY
- 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.
Além das consultas SQL padrão no estilo de SELECT FROM WHERE, o Azure Databricks também oferece suporte à sintaxe de pipeline SQL , que estrutura o SQL como 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.
Declarações do Delta Lake
Você usa instruções Delta Lake SQL 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 as instruções Delta Lake, consulte O que é Delta Lake?.
Instruções auxiliares
Você usa instruções auxiliares para coletar estatísticas, gerenciar cache, explorar metadados, definir configurações e gerenciar 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
- DESCRIBE CATALOG
- DESCRIBE CONNECTION
- DESCRIBE CREDENTIAL
- DESCRIBE DATABASE
- DESCRIBE FUNCTION
- DESCREVER LOCALIZAÇÃO
- DESCRIBE PROVIDER
- DESCRIBE QUERY
- DESCRIBE RECIPIENT
- DESCRIBE SCHEMA
- DESCRIBE SHARE
- DESCRIBE TABLE
- DESCRIBE VOLUME
Instruções para mostrar
- 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
- MOSTRAR TABLE
- SHOW TABLES
- SHOW TABLES DROPPED
- SHOW TBLPROPERTIES
- SHOW USERS
- SHOW VIEWS
- SHOW VOLUMES
Configuração, gerenciamento de variáveis e instruções misc
- EXECUTE IMMEDIATE
- RESET
- SET
- SET RECIPIENT
- SET TIMEZONE
- SET VARIABLE
- USE CATALOG
- USE DATABASE
- USE SCHEMA
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:
- ALTER GROUP
- CREATE GROUP
- DENY
- DROP GROUP
- GRANT
- GRANT PARTILHAR
- PRIVILÉGIOS DE REPARAÇÃO
- REVOKE
- REVOKE PARTILHAR
- 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 (legado).