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 usar o SQL com o Lakeflow Declarative Pipelines, consulte a referência de linguagem SQL do Lakeflow Declarative Pipelines.

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
• Functions
• Regras de tipo de dados SQL
• Padrões de datetime
• Funções H3 geoespaciais
• Funções geoespaciais ST
• Funções lambda
• Funções da janela
• Identifiers
• Names
• Cláusula IDENTIFIER
• Semântica NULL
• Expressions
• Marcadores de parâmetro
• Variables
• Resolução de nomes
• Expressões do caminho JSON
• Collation
• Partitions
• 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
• Credentials
• Volumes
• Programação SQL
• 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 LOCALIZAÇÃO
• ALTER MATERIALIZED VIEW
• ALTER PROVIDER
• ALTER RECIPIENT
• ALTER STREAMING TABLE
• ALTER TABLE
• ALTER SCHEMA
• ALTER SHARE
• ALTER VIEW
• ALTER VOLUME
• COMMENT ON
• CRIAR ÍNDICE DO FILTRO BLOOM
• CREATE CATALOG
• CREATE CONNECTION
• CREATE DATABASE
• CREATE FUNCTION (SQL)
• CREATE FUNCTION (Externo)
• CRIAR LOCALIZAÇÃO
• CREATE MATERIALIZED VIEW
• CREATE PROCEDURE
• CREATE RECIPIENT
• CREATE SCHEMA
• CREATE SERVER
• CREATE SHARE
• CREATE STREAMING TABLE
• CREATE TABLE
• CREATE VIEW
• CREATE VOLUME
• DECLARE VARIABLE
• REMOVER ÍNDICE BLOOMFILTER
• DROP CATALOG
• DROP CONNECTION
• DROP DATABASE
• DROP CREDENTIAL
• DROP FUNCTION
• LOCAL DE DESCARGA
• DROP PROCEDURE
• 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)
• SET ETIQUETA
• SYNC
• TRUNCATE TABLE
• UNDROP TABLE
• MARCA UNSET

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 EM
• 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 a 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.

• Query
• SELECT
• VALUES
• Sintaxe do Pipeline do SQL

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.

• EXPLAIN

Declaraçõ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 delta lake, consulte O que é Delta Lake no Azure Databricks?.

Instruções de script SQL

Você usa o script SQL para executar a lógica de procedimento no SQL.

• Instrução CASE
• Instrução composta BEGIN END
• Instrução FOR
• GET Instrução DIAGNOSTICS
• Instrução IF THEN ELSE
• Instrução ITERATE
• Instrução LEAVE
• Instrução LOOP
• Instrução REPEAT
• Instrução RESIGNAL
• Instrução SIGNAL
• Instrução WHILE

Declarações auxiliares

Você usa instruções auxiliares para coletar estatísticas, gerenciar o cache, explorar metadados, definir configurações e gerenciar recursos:

• Analisar declaração
• Instruções de cache do Apache Spark
• Descrever instruções
• Mostrar instruções
• Configuração, gerenciamento de variáveis e instruções diversas
• Gerenciamento de recursos

Analisar declaração

• ANALYZE TABLE

Instruções de cache do Apache Spark

Aplica-se a: Databricks Runtime

• CACHE TABLE
• CLEAR CACHE
• REFRESH FUNCTION
• REFRESH TABLE
• REFRESH CACHE
• UNCACHE TABLE

Descrever declarações

• DESCRIBE CATALOG
• DESCRIBE CONNECTION
• DESCRIBE CREDENTIAL
• DESCRIBE DATABASE
• DESCRIBE FUNCTION
• DESCREVER A LOCALIZAÇÃO
• DESCREVER PROCEDIMENTO
• DESCRIBE PROVIDER
• DESCRIBE QUERY
• DESCRIBE RECIPIENT
• DESCRIBE SCHEMA
• DESCRIBE SHARE
• DESCRIBE TABLE
• DESCRIBE VOLUME

Exibir declarações

• LIST
• SHOW ALL IN SHARE
• SHOW CATALOGS
• SHOW COLUMNS
• SHOW CONNECTIONS
• SHOW CREATE TABLE
• SHOW CREDENTIALS
• SHOW DATABASES
• SHOW FUNCTIONS
• SHOW GROUPS
• MOSTRAR LOCAIS
• SHOW PARTITIONS
• MOSTRAR PROCEDIMENTOS
• SHOW PROVIDERS
• SHOW RECIPIENTS
• SHOW SCHEMAS
• SHOW SHARES
• SHOW SHARES IN PROVIDER
• PROGRAMA TABLE
• SHOW TABLES
• SHOW TABLES DROPPED
• SHOW TBLPROPERTIES
• SHOW USERS
• SHOW VIEWS
• SHOW VOLUMES

Configurações, gerenciamento de variáveis e declarações diversas

• CALL
• 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

• ADD ARCHIVE
• ADD FILE
• ADD JAR
• LIST ARCHIVE
• LIST FILE
• LIST JAR

Aplica-se a: Databricks SQL Connector

• GET
• PUT INTO
• REMOVE

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
• REPARAR PRIVILÉGIOS
• 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).