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 SQL com Lakeflow Spark Declarative Pipelines, consulte Referência da linguagem Pipeline SQL.

Referência geral

Esta referência geral descreve tipos de dados, funções, identificadores, literais e semânticas:

• etiqueta "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 data e hora
• Funções geoespaciais H3
• Funções geoespaciais ST
• Funções do Lambda
• Funções do Windows
• Identifiers
• Names
• IDENTIFIER cláusula
• Semântica NULL
• Expressions
• Marcadores de parâmetros
• Variables
• Resolução de nomes
• Expressões de caminho JSON
• Collation
• Partitions
• Conformidade com ANSI no Databricks Runtime
• Compatibilidade com o Apache Hive
• Principals
• 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
• Credentials
• Volumes
• de scripts SQL
• Compartilhamento Delta
• Consultas federadas (Federação Lakehouse)
• 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:

• 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
• CRIE ÍNDICE DE BLOOMFILTER
• CREATE CATALOG
• CREATE CONNECTION
• CREATE DATABASE
• CREATE FUNCTION (SQL)
• CREATE FUNCTION (Externo)
• CRIAR LOCALIZAÇÃO
• CREATE MATERIALIZED VIEW
• CRIAR PROCEDIMENTO
• 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 ENTREGA
• ELIMINAR PROCEDIMENTO
• 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
• TAG NÃO DEFINIDA

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

Declaraçõ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 suportadas são explicadas no artigo Consulta . As instruções SQL relacionadas SELECT 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.

• Query
• SELECT
• VALUES
• Sintaxe de Pipeline 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 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 instruções Delta Lake, consulte O que é Delta Lake no Azure Databricks?.

Instruções de script SQL

Você usa scripts SQL para executar lógica de procedimento em SQL.

• Declaração CASE
• Instrução composta BEGIN END
• PARA declaração
• GET declaração de diagnóstico
• DECLARAÇÃO IF THEN ELSE
• Declaração ITERATE
• Declaração LEAVE
• Instrução LOOP
• Instrução REPEAT
• Declaração RESIGNAL
• Declaração SIGNAL
• Declaração WHILE

Instruções auxiliares

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

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

Analisar declaração

• ANALYZE TABLE

Declarações de Cache do Apache Spark

Aplica-se a: Databricks Runtime

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

Descrever declarações

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

Mostrar 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 LOCALIZAÇÕES
• SHOW PARTITIONS
• MOSTRAR PROCEDIMENTOS
• 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, gestão de variáveis e instruçõ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

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 mais detalhes sobre como usar estas instruções, consulte Privilégios de metastore do Hive e objetos protegíveis (legado).