Informazioni di riferimento sul linguaggio SQL

Informazioni di riferimento sul comando SQL per Databricks SQL e Databricks Runtime.

Per informazioni su come comprendere e usare la notazione e i simboli della sintassi in questo riferimento, vedere Come usare il riferimento SQL.

Per informazioni sull'uso di SQL con le pipeline dichiarative di Lakeflow Spark, vedere il riferimento del linguaggio SQL per le pipeline.

Note

Databricks SQL Serverless non è disponibile in Azure Cina. Databricks SQL non è disponibile nelle aree Azure per enti pubblici.

Informazioni di riferimento generali

Questo riferimento generale descrive tipi di dati, funzioni, identificatori, valori letterali e semantica.

Nozioni fondamentali sul linguaggio

Reference	Descrzione
Aggiunta di commenti alle istruzioni SQL	Aggiunta di commenti al codice SQL
Parole riservate e schemi	Parole chiave riservate dal parser SQL
Identifiers	Regole per la denominazione di oggetti di database
Names	Convenzioni di denominazione degli oggetti
IDENTIFIER clausola	Risoluzione identificatore dinamico
Espressione SQL	Sintassi e valutazione delle espressioni SQL
Semantica NULL	Modalità di gestione dei valori NULL
Marcatori di parametro	Segnaposto query con parametri
Variables	Variabili temporanee e di sessione
Risoluzione dei nomi	Come vengono risolti i nomi degli oggetti
Espressione di percorso JSON	Esplorazione delle strutture di dati JSON
Collation	Confronto di stringhe e regole di ordinamento
Partitions	Concetti relativi al partizionamento delle tabelle

Tipi di dati

Reference	Descrzione
Tipo di dati	Panoramica di tutti i tipi di dati supportati
Regole del tipo di dati SQL	Regole di coercizione e conversione dei tipi
Modelli di data e ora	Modelli di formato per date e ore

Parametri di configurazione

Reference	Descrzione
Parametri di configurazione	Panoramica della configurazione di SQL
ANSI_MODE	Modalità di conformità SQL ANSI
LEGACY_TIME_PARSER_POLICY	Comportamento di analisi dell'ora
MAX_FILE_PARTITION_BYTES	Limite delle dimensioni delle partizioni file
READ_ONLY_EXTERNAL_METASTORE	Modalità di accesso al metastore esterno
STATEMENT_TIMEOUT	Impostazione del timeout della query
TIMEZONE	Fuso orario sessione
USE_CACHED_RESULT	Memorizzazione nella cache dei risultati della query

Funzioni

Reference	Descrzione
Functions	Panoramica delle funzioni SQL
Funzioni predefinite	Tutte le funzioni predefinite
elenco alfabetico delle funzioni predefinite	Informazioni di riferimento sulla funzione A-Z complete
funzioni di finestra	Funzioni analitiche e di classificazione
Funzioni lambda	Espressioni di funzione anonime
Funzioni geospaziali H3	Indice spaziale gerarchico esagonale
Funzioni geospaziali ST	Funzioni geospaziali standard
Funzioni di aggregazione definite dall'utente (UDAFs)	Funzioni di aggregazione personalizzate
Funzioni scalari definite dall'utente esterne	Funzioni scalari personalizzate
Integrazione con UDF, UDAF e UDTF di Hive	Compatibilità delle funzioni Hive
Chiamata di funzione	Come chiamare le funzioni

Concetti relativi al catalogo Unity

Reference	Descrzione
Server principale	Utenti, gruppi ed entità servizio
privilegi e oggetti proteggibili in Unity Catalog	Controllo di accesso nel catalogo unity
** Privilegi e oggetti securabili nel metastore Hive	Controllo di accesso al metastore legacy
Percorsi esterni	Percorsi di archiviazione cloud
tabelle esterne	Tabelle supportate da dati esterni
Credentials	Credenziali di accesso alle risorse di archiviazione
Volumes	Archiviazione file gestita ed esterna

Argomenti speciali

Reference	Descrzione
Conformità ANSI in Databricks Runtime	Compatibilità standard ANSI SQL
Compatibilità di Apache Hive	Compatibilità di Hive SQL
Script SQL	Logica SQL procedurale
Condivisione differenziale	Condivisione dei dati tra organizzazioni
Query federate (Federazione Lakehouse)	Esecuzione di query su database esterni
Schema delle informazioni	Tabelle di sistema dei metadati

Istruzioni DDL

Le istruzioni di definizione dei dati creano o modificano la struttura degli oggetti di database.

Istruzioni ALTER

Statement	Descrzione
ALTER CATALOG	Modificare le proprietà del catalogo
ALTER CONNECTION	Modificare le impostazioni di connessione
ALTER CREDENTIAL	Modificare le proprietà delle credenziali
ALTER DATABASE	Modificare le proprietà del database
ALTER EXTERNAL LOCATION	Modificare il percorso esterno
ALTER MATERIALIZED VIEW	Modificare la vista materializzata
ALTER PROVIDER	Modificare il provider di dati
ALTER RECIPIENT	Modificare il destinatario della condivisione
ALTER SCHEMA	Modificare le proprietà dello schema
ALTER SHARE	Modificare la configurazione della condivisione
ALTER STREAMING TABLE	Modificare la tabella di streaming
ALTER TABLE	Modificare la struttura della tabella
ALTER VIEW	Modificare la definizione della vista
ALTER VOLUME	Modificare le proprietà del volume

Istruzioni CREATE

Statement	Descrzione
CREATE BLOOM FILTER INDEX	Creare un indice di filtro bloom
CREATE CATALOG	Creare un nuovo catalogo
CREATE CONNECTION	Creare una connessione esterna
CREATE DATABASE	Creare un nuovo database
CREATE FUNCTION (SQL e Python)	Creare una funzione SQL
CREATE FUNCTION (esterno)	Creare una funzione esterna
CREATE EXTERNAL LOCATION	Creare un percorso esterno
CREATE MATERIALIZED VIEW	Creare una vista materializzata
CREATE PROCEDURE	Creare una stored procedure
CREATE RECIPIENT	Creare un destinatario di condivisione
CREATE SCHEMA	Creare un nuovo schema
CREATE SERVER	Creare un server esterno
CREATE SHARE	Creare una condivisione dati
CREATE STREAMING TABLE	Creare una tabella di streaming
CREATE TABLE	Creare una nuova tabella
CREATE VIEW	Crea una visualizzazione
CREATE VOLUME	Creare un volume

Analizzare le istruzioni

Altre istruzioni DDL

Statement	Descrzione
COMMENT ON	Aggiungere commenti agli oggetti
DECLARE VARIABLE	Dichiarare la variabile di sessione
REPAIR TABLE	Ripristinare le partizioni di tabella
REFRESH FOREIGN (CATALOG, SCHEMAe TABLE)	Aggiornare i metadati stranieri
REFRESH (MATERIALIZED VIEW o STREAMING TABLE)	Aggiornare i dati materializzati
SET CARTELLINO	Aggiungere tag agli oggetti
`SYNC`	Sincronizzare i metadati
TRUNCATE TABLE	Rimuovere tutti i dati della tabella
UNDROP	Ripristinare la tabella eliminata
UNSET TAG	Rimuovere tag dagli oggetti

Istruzioni DML

Le istruzioni di manipolazione dei dati aggiungono, modificano o eliminano i dati nelle tabelle Delta Lake.

Statement	Descrzione
`COPY INTO`	Caricare dati da file in una tabella
DELETE FROM	Eliminare righe da una tabella
INSERT	Inserire righe in una tabella
INSERT OVERWRITE DIRECTORY	Scrivere i risultati delle query nella directory
INSERT OVERWRITE DIRECTORY con formato Hive	Scrivere risultati in formato Hive
LOAD DATA	Caricare dati da file
MERGE INTO	Upsert dei dati in una tabella
UPDATE	Aggiornare le righe in una tabella

Istruzioni di recupero dei dati

Recuperare le righe dalle tabelle in base alle clausole specificate. Azure Databricks supporta sia la sintassi standard SELECT che la sintassi della pipeline SQL.

Istruzioni di query

Statement	Descrzione
Query	Informazioni di riferimento sulla sintassi della query completa
SELECT (selezione secondaria)	Selezionare i dati dalle tabelle
VALUES clausola	Creare una tabella inline
sintassi della pipeline SQL	Composizione di query basata su pipe
EXPLAIN	Visualizzare il piano di esecuzione delle query

Clausole di query

Clausola	Descrzione
SELECT clausola	Selezione colonna
* (stella) clausola	Selezionare tutte le colonne
riferimento alla tabella	Origini tabella e sottoquery
JOIN	Combinare righe da tabelle
WHERE clausola	Filtra righe
GROUP BY clausola	Raggruppare le righe per effettuare aggregazioni
HAVING clausola	Filtrare le righe raggruppate
QUALIFY clausola	Risultati della funzione della finestra di filtro
ORDER BY clausola	Ordinare le righe dei risultati
SORT BY clausola	Ordinare all'interno delle partizioni
clausola CLUSTER BY (SELECT)	Distribuire e ordinare i dati
DISTRIBUTE BY clausola	Distribuire i dati tra partizioni
LIMIT clausola	Limitare le righe dei risultati
OFFSET clausola	Ignorare le righe dei risultati
PIVOT clausola	Ruotare le righe in colonne
UNPIVOT clausola	Ruotare le colonne in righe
LATERAL VIEW clausola	Applicare la funzione di generazione di tabelle
TABLESAMPLE clausola	Righe di tabella di esempio
chiamata di funzione con valori di tabella (TVF)	Funzioni che restituiscono tabelle
CTE (Common Table Expression)	Sottoquery denominate
Impostare operatori	UNION, INTERSECT, EXCEPT
WINDOW clausola	Definizioni di finestra denominate
Suggerimenti	Hint di Query Optimizer

Istruzioni Delta Lake

Gestire le tabelle archiviate in formato Delta Lake. Per informazioni dettagliate, vedere Che cos'è Delta Lake in Azure Databricks?.

Statement	Descrzione
CACHE SELECT	Memorizzare nella cache i risultati delle query
CONVERT TO DELTA	Convertire Parquet in Delta
DESCRIBE HISTORY	Mostra cronologia tabelle
FSCK REPAIR TABLE	Ripristinare i metadati della tabella
GENERATE	Generare il manifesto della tabella
OPTIMIZE	File di tabella compattati
REORG TABLE	Riorganizzare i dati della tabella
RESTORE	Ripristinare la tabella alla versione precedente
VACUUM	Rimuovere i file di tabella precedenti

Istruzioni di scripting SQL

Eseguire la logica procedurale in SQL. Per una panoramica, vedere Script sql .

Statement	Descrzione
istruzione composta BEGIN END	Raggruppare le istruzioni in un blocco
Istruzione CASE	Diramazione condizionale
Istruzione FOR	Eseguire un ciclo su un intervallo o un cursore
GET dichiarazione DIAGNOSTICS	Recuperare le informazioni sull'esecuzione
l'istruzione IF THEN ELSE	Esecuzione condizionale
Istruzione ITERATE	Continuare con l'iterazione del ciclo successivo
Istruzione LEAVE	Uscire da un ciclo o un blocco
Istruzione LOOP	Ciclo incondizionato
Istruzione REPEAT	Ciclo fino a quando la condizione non è true
Istruzione RESIGNAL	Generare nuovamente un'eccezione
Istruzione SIGNAL	Generare un'eccezione
Istruzione WHILE	Ciclo mentre la condizione è true

Istruzioni ausiliarie

Raccogliere statistiche, gestire la memorizzazione nella cache, esplorare i metadati, impostare le configurazioni e gestire le risorse.

Istruzioni ANALYZE

Statement	Descrzione
ANALYZE TABLE ... STATISTICHE DI CALCOLO	Calcolare le statistiche delle colonne della tabella
ANALYZE TABLE ... METRICHE DI ARCHIVIAZIONE DI CALCOLO	Metriche di archiviazione tabelle di calcolo

Istruzioni cache

Si applica a: Databricks Runtime

Statement	Descrzione
CACHE TABLE	Tabella cache in memoria
CLEAR CACHE	Rimuovere tutti i dati memorizzati nella cache
REFRESH CACHE	Aggiornare i dati memorizzati nella cache
REFRESH FUNCTION	Aggiornare i metadati della funzione
REFRESH TABLE	Aggiornare i metadati della tabella
UNCACHE TABLE	Rimuovere la tabella dalla cache

Istruzioni DESCRIBE

Statement	Descrzione
DESCRIBE CATALOG	Mostra i dettagli del catalogo
DESCRIBE CONNECTION	Mostra i dettagli della connessione
DESCRIBE CREDENTIAL	Visualizzare i dettagli delle credenziali
DESCRIBE DATABASE	Visualizzare i dettagli del database
DESCRIBE FUNCTION	Visualizzare i dettagli della funzione
DESCRIBE EXTERNAL LOCATION	Mostra i dettagli della posizione
DESCRIVI PROCEDURA	Visualizzare i dettagli della procedura
DESCRIBE PROVIDER	Mostra i dettagli del provider
DESCRIBE QUERY	Visualizzare lo schema di output della query
DESCRIBE RECIPIENT	Mostra i dettagli del destinatario
DESCRIBE SCHEMA	Mostra i dettagli dello schema
DESCRIBE SHARE	Mostra dettagli condivisione
DESCRIBE TABLE	Mostra dettagli tabella
DESCRIBE VOLUME	Visualizzare i dettagli del volume

Istruzioni SHOW

Statement	Descrzione
LIST	Elencare i file in un percorso
SHOW ALL IN SHARE	Mostra tutti gli oggetti in condivisione
SHOW CATALOGS	Elencare i cataloghi
SHOW COLUMNS	Elencare le colonne della tabella
SHOW CONNECTIONS	Elencare le connessioni
SHOW CREATE TABLE	Mostra DDL tabella
SHOW CREDENTIALS	Elencare le credenziali
SHOW DATABASES	Elencare i database
SHOW FUNCTIONS	Funzioni di elenco
SHOW GROUPS	Elencare i gruppi
SHOW EXTERNAL LOCATIONS	Elencare i percorsi esterni
SHOW PARTITIONS	Elencare le partizioni di tabella
MOSTRA PROCEDURE	Procedure di elenco
SHOW PROVIDERS	Elencare i provider
SHOW RECIPIENTS	Elencare i destinatari
SHOW SCHEMAS	Elencare gli schemi
SHOW SHARES	Elencare le condivisioni
SHOW SHARES IN PROVIDER	Elencare le condivisioni dal provider
SHOW TABLE EXTENDED	Mostra informazioni sulla tabella
SHOW TABLES	Elenco delle tabelle
SHOW TABLES DROPPED	Elencare le tabelle eliminate
SHOW TBLPROPERTIES	Visualizzare le proprietà della tabella
SHOW USERS	Elencare gli utenti
SHOW VIEWS	Visualizzazioni elenco
SHOW VOLUMES	Elencare i volumi

Configurazione e gestione delle variabili

Statement	Descrzione
CALL	Chiamare una stored procedure
EXECUTE IMMEDIATE	Eseguire SQL dinamico
RESET	Reimpostare la configurazione predefinita
SET	Impostare il parametro di configurazione
SET RECIPIENT	Impostare il contesto del destinatario di condivisione
SET TIME ZONE	Impostare il fuso orario della sessione
SET variabile	Impostare il valore della variabile
USE CATALOG	Impostare il catalogo corrente
USE DATABASE	Impostare il database corrente
USE SCHEMA	Impostare lo schema corrente

Gestione delle risorse