Référence sur le langage SQL

Il s’agit d’une référence de commande SQL pour Databricks SQL et Databricks Runtime.

Les pages pour les fonctionnalités prises en charge par Lakehouse//RT incluent Lakehouse//RT dans leur étiquette « S’applique à ». Pour les fonctionnalités prises en charge et les limitations de Lakehouse//RT, voir Lakehouse Real-Time.

Pour plus d’informations sur la compréhension et l’utilisation de la notation de syntaxe et des symboles dans cette référence, consultez Comment utiliser la référence SQL.

Pour plus d’informations sur l’utilisation de SQL avec des pipelines Lakeflow, consultez la référence du langage SQL de pipeline.

Note

Databricks SQL Serverless n’est pas disponible en Chine Azure. Databricks SQL n’est pas disponible dans les régions Azure Government.

Référence générale

Cette référence générale décrit les types de données, les fonctions, les identificateurs, les littéraux et la sémantique.

Notions de base du langage

Reference Descriptif
Ajout de commentaires aux instructions SQL Ajout de commentaires à votre code SQL
Mots et schémas réservés Mots clés réservés par l’analyseur SQL
Identifiants Règles pour nommer des objets de base de données
Noms Conventions d’affectation de noms d’objets
Clause IDENTIFIER Résolution d’identificateur dynamique
Expression SQL Syntaxe et évaluation des expressions SQL
Sémantique NULL Gestion des valeurs NULL
Marqueurs de paramètres Espaces réservés de requête paramétrés
Variables Variables de session et temporaires
Résolution de noms Résolution des noms d’objets
Expression de chemin JSON Navigation dans les structures de données JSON
Classement Règles de comparaison et de tri de chaînes
Partitions Concepts de partitionnement de table

Types de données

Reference Descriptif
Types de données Vue d’ensemble de tous les types de données pris en charge
Règles de type de données SQL Règles de contrainte et de conversion de type
Motifs datetime Mettre en forme des modèles pour les dates et les heures

Paramètres de configuration

Reference Descriptif
Paramètres de configuration Vue d’ensemble de la configuration SQL
ANSI_MODE Mode de conformité ANSI SQL
LEGACY_TIME_PARSER_POLICY Comportement d’analyse du temps
MAX_FILE_PARTITION_BYTES Limite de taille de partition de fichiers
READ_ONLY_EXTERNAL_METASTORE Mode d’accès au metastore externe
STATEMENT_TIMEOUT Paramètre de délai d’expiration de requête
TIMEZONE Fuseau horaire de session
USE_CACHED_RESULT Mise en cache des résultats de requête

Functions

Reference Descriptif
Fonctions Vue d’ensemble des fonctions SQL
Fonctions intégrées Toutes les fonctions intégrées
Liste alphabétique des fonctions intégrées Référence complète de la fonction A-Z
Fonctions de fenêtre Fonctions d’analyse et de classement
Fonctions lambda Expressions de fonction anonyme
Fonctions géospatiales H3 Index spatial hiérarchique hexagonal
Fonctions géospatiales ST Fonctions géospatiales standard
Fonctions IP Fonctions IP
Fonctions agrégées définies par l’utilisateur (UDAF) Fonctions d’agrégation personnalisées
Fonctions scalaires externes définies par l’utilisateur (UDF) Fonctions scalaires personnalisées
Intégration avec les Hive UDF, UDAF et UDTF Compatibilité des fonctions Hive
Invocation de la fonction Comment appeler des fonctions

Concepts du catalogue Unity

Reference Descriptif
Principal Utilisateurs, groupes et principaux de service
Privilèges et objets sécurisés dans le catalogue Unity Contrôle d’accès dans le catalogue Unity
Privilèges et objets sécurisés dans le métastore de la Ruche Contrôle d’accès au metastore hérité
Emplacements externes Emplacements de stockage cloud
Tables externes Tables sauvegardées par des données externes
Identifiants Informations d’identification d’accès au stockage
Volumes Stockage de fichiers managé et externe

Sujets spéciaux

Reference Descriptif
Conformité ANSI dans Databricks Runtime Compatibilité standard ANSI SQL
Compatibilité avec les ruches Apache Compatibilité Hive SQL
Scripting SQL Logique SQL procédurale
Utilisateur autorisé et utilisateur de session Autorisation entre les vues, les fonctions définies par l’utilisateur et les procédures
OpenSharing Partage de données inter-organisations
Requêtes fédérées (Lakehouse Federation) Interrogation de bases de données externes
Schéma d’information Tables système de métadonnées

Commandes DDL

Les instructions de définition de données créent ou modifient la structure des objets de base de données.

Instructions ALTER

Déclaration Descriptif
ALTER CATALOG Modifier les propriétés du catalogue
ALTER CONNECTION Modifier les paramètres de connexion
ALTER CREDENTIAL Modifier les propriétés des informations d’identification
ALTER DATABASE Modifier les propriétés de la base de données
ALTER EXTERNAL LOCATION Modifier l’emplacement externe
ALTER MATERIALIZED VIEW Modifier la vue matérialisée
ALTER PROVIDER Modifier le fournisseur de données
ALTER RECIPIENT Modifier le destinataire du partage
ALTER SCHEMA Modifier les propriétés du schéma
ALTER SHARE Modifier la configuration du partage
ALTER STREAMING TABLE Modifier la table de diffusion en continu
ALTER TABLE Modifier la structure de table
ALTER VIEW Modifier la définition de la vue
ALTER VOLUME Modifier les propriétés du volume

Instructions CREATE

Déclaration Descriptif
CREATE BLOOM FILTER INDEX (déprécié) Créer un index de filtre de floraison (déconseillé)
CREATE CATALOG Créer un catalogue
CREATE CONNECTION Créer une connexion externe
CREATE DATABASE Créer une base de données
CREATE FUNCTION(SQL, Python, Scala et Java) Créer une fonction SQL
CREATE FUNCTION (Externe) Créer une fonction externe
CREATE EXTERNAL LOCATION Créer un emplacement externe
CREATE MATERIALIZED VIEW Créer une vue matérialisée
CRÉER POLITIQUE Créer un filtre de ligne ou une stratégie de masque de colonne
CRÉER PROCÉDURE Créer une procédure stockée
CREATE RECIPIENT Créer un destinataire de partage
CREATE SCHEMA Créer un schéma
CREATE SERVER Créer un serveur étranger
CREATE SHARE Créer un partage de données
CREATE STREAMING TABLE Créer une table de diffusion en continu
CREATE TABLE Créer une nouvelle table
CREATE TABLE ... FLUX Créer une table gérée écrite par un flux
CREATE VIEW Créer une vue
CREATE VOLUME Créer un volume

Instructions DROP

Déclaration Descriptif
DROP BLOOM FILTER INDEX Supprimer l’index de filtre de floraison (déconseillé)
DROP CATALOG Supprimer un catalogue
DROP CONNECTION Supprimer la connexion externe
DROP CREDENTIAL Supprimer les informations d’identification de stockage
DROP DATABASE Supprimer une base de données
DROP FUNCTION Supprimer une fonction
DROP EXTERNAL LOCATION Supprimer l’emplacement externe
POLITIQUE DE DÉPÔT Supprimer un filtre de ligne ou une stratégie de masque de colonne
PROCÉDURE DE LARGAGE Supprimer une procédure stockée
DROP PROVIDER Supprimer le fournisseur de partage
DROP RECIPIENT Supprimer le destinataire du partage
DROP SCHEMA Supprimer un schéma
DROP SHARE Supprimer le partage de données
DROP TABLE Supprimer une table
DROP VARIABLE Supprimer la variable de session
DROP VIEW Supprimer une vue
DROP VOLUME Supprimer un volume

Instructions d’analyse

Autres instructions DDL

Déclaration Descriptif
COMMENT ON Ajouter des commentaires à des objets
DECLARE VARIABLE Déclarer une variable de session
REPAIR TABLE Récupérer des partitions de table
REFRESH FOREIGN (CATALOG, SCHEMA, et TABLE) Actualiser les métadonnées étrangères
REFRESH (MATERIALIZED VIEW ou STREAMING TABLE) Actualiser les données matérialisées
SET TAG Ajouter des balises à des objets
SYNC Synchroniser les métadonnées
TRUNCATE TABLE Supprimer toutes les données de table
DÉCROCHER Restaurer la table supprimée
UNDROP VOLUME Restaurer le volume perdu
ÉTIQUETTE NON DÉFINIE Supprimer des balises d’objets

Énoncés DML

Les instructions de manipulation des données ajoutent, modifient ou suppriment des données dans des tables Delta Lake.

Déclaration Descriptif
COPY INTO Charger des données à partir de fichiers dans une table
DELETE FROM Supprimer des lignes d’une table
INSERT Insérer des lignes dans une table
INSERT OVERWRITE DIRECTORY Écrire des résultats de requête dans le répertoire
INSERT OVERWRITE DIRECTORY avec format Hive Écrire des résultats au format Hive
LOAD DATA Charger des données à partir de fichiers
MERGE INTO Données Upsert dans une table
UPDATE Mettre à jour des lignes dans une table

Déclarations d’extraction de données

Récupérez les lignes des tables en fonction des clauses spécifiées. Azure Databricks prend en charge la syntaxe standard SELECT et SQL Pipeline Syntax.

Instructions de requête

Déclaration Descriptif
Requête Informations de référence sur la syntaxe de requête complète
SELECT (sous-sélection) Sélectionner des données dans des tables
Clause VALUES Construire une table inline
Syntaxe du pipeline SQL Composition de requête basée sur le canal
EXPLAIN Afficher le plan d’exécution de requête

Clauses de requête

Clause Descriptif
Clause SELECT Sélection de colonnes
clause * (étoile) Sélectionner toutes les colonnes
Référence de table Sources de table et de sous-requête
JOIN Combiner des lignes à partir de tables
Clause WHERE Filtrer des lignes
Clause GROUP BY Regrouper des lignes pour l’agrégation
Clause HAVING Filtrer les lignes groupées
Clause QUALIFY Filtrer les résultats de la fonction de fenêtre
Clause ORDER BY Trier les lignes de résultat
Clause SORT BY Trier dans des partitions
CLUSTER BY clause (SELECT) Distribuer et trier des données
Clause DISTRIBUTE BY Distribuer des données entre des partitions
Clause LIMIT Limiter les lignes de résultat
Clause OFFSET Ignorer les lignes de résultat
MATCH_RECOGNIZE clause Rechercher et filtrer des modèles de lignes
Clause PIVOT Faire pivoter des lignes vers des colonnes
Clause UNPIVOT Faire pivoter des colonnes vers des lignes
Clause LATERAL VIEW Appliquer la fonction de génération de table
Clause TABLESAMPLE Exemples de lignes de tableau
Invocation de fonction à valeurs de table (TVF) Fonctions retournant des tables
Expression commune de table (CTE) Sous-requêtes nommées
Opérateurs d’ensemble UNION, INTERSECTE, SAUF
Clause WINDOW Définitions de fenêtre nommées
Indices Indicateurs d’optimiseur de requête

Déclarations de Delta Lake

Gérer les tables stockées au format Delta Lake. Pour plus d’informations, consultez Qu’est-ce que Delta Lake dans Azure Databricks ?.

Déclaration Descriptif
CACHE SELECT Mettre en cache les résultats de la requête
CONVERT TO DELTA Convertir Parquet en delta
DESCRIBE HISTORY Afficher l’historique des tables
FSCK REPAIR TABLE Réparer les métadonnées de table
GENERATE Générer un manifeste de table
OPTIMIZE Fichiers de table compacts
REORG TABLE Réorganiser les données de table
RESTORE Restaurer la table vers la version précédente
VACUUM Supprimer les anciens fichiers de table

Instructions de script SQL

Exécutez une logique procédurale dans SQL. Consultez la création de scripts SQL pour obtenir une vue d’ensemble.

Déclaration Descriptif
Instruction composée BEGIN END Regrouper des instructions dans un bloc
Énoncé CASE Branchement conditionnel
Instruction FOR Boucle sur une plage ou un curseur
GET instruction DIAGNOSTICS Récupérer les informations d’exécution
INSTRUCTION IF THEN ELSE Exécution conditionnelle
Instruction ITERATE Passer à l’itération de boucle suivante
Déclaration LEAVE Quitter une boucle ou un bloc
Instruction LOOP Boucle inconditionnelle
instruction REPEAT Boucle jusqu’à ce que la condition soit vraie
Déclaration RESIGNAL Réactiver une exception
Instruction SIGNAL Déclencher une exception
Instruction WHILE Boucle alors que la condition est true

Instructions auxiliaires

Collectez des statistiques, gérez la mise en cache, explorez les métadonnées, définissez des configurations et gérez les ressources.

Instructions ANALYZE

Déclaration Descriptif
ANALYZE TABLE … STATISTIQUES DE CALCUL Statistiques des colonnes de table de calcul
ANALYZE TABLE … MÉTRIQUES DE STOCKAGE DE CALCUL Métriques de stockage de table de calcul

Instructions de cache

S’applique à : Databricks Runtime

Déclaration Descriptif
CACHE TABLE Mettre en cache la table en mémoire
CLEAR CACHE Supprimer toutes les données mises en cache
REFRESH CACHE Actualiser les données mises en cache
REFRESH FUNCTION Actualiser les métadonnées de la fonction
REFRESH TABLE Actualiser les métadonnées de table
UNCACHE TABLE Supprimer la table du cache

Instructions DESCRIBE

Déclaration Descriptif
DESCRIBE CATALOG Afficher les détails du catalogue
DESCRIBE CONNECTION Afficher les détails de la connexion
DESCRIBE CREDENTIAL Afficher les détails des informations d’identification
DESCRIBE DATABASE Afficher les détails de la base de données
DESCRIBE FUNCTION Afficher les détails de la fonction
DESCRIBE EXTERNAL LOCATION Afficher les détails de l’emplacement
DÉCRIRE POLITIQUE Afficher les détails de la stratégie
DÉCRIRE PROCÉDURE Afficher les détails de la procédure
DESCRIBE PROVIDER Afficher les détails du fournisseur
DESCRIBE QUERY Afficher le schéma de sortie de requête
DESCRIBE RECIPIENT Afficher les détails du destinataire
DESCRIBE SCHEMA Afficher les détails du schéma
DESCRIBE SHARE Afficher les détails du partage
DESCRIBE TABLE Afficher les détails du tableau
DESCRIBE VOLUME Afficher les détails du volume

SHOW déclarations

Déclaration Descriptif
LIST Répertorier les fichiers dans un chemin d’accès
SHOW ALL IN SHARE Afficher tous les objets dans le partage
SHOW CATALOGS Répertorier les catalogues
SHOW COLUMNS Répertorier les colonnes de la table
SHOW CONNECTIONS Liste des connexions
SHOW CREATE TABLE Afficher la table DDL
SHOW CREDENTIALS Répertorier les informations d’identification
SHOW DATABASES Répertorier les bases de données
SHOW FUNCTIONS Fonctions de liste
SHOW GROUPS Répertorier les groupes
SHOW EXTERNAL LOCATIONS Répertorier les emplacements externes
SHOW PARTITIONS Répertorier les partitions de table
AFFICHER POLITIQUES Répertorier les stratégies sur un élément sécurisable
MONTRER LES PROCÉDURES Procédures de liste
SHOW PROVIDERS Répertorier les fournisseurs
SHOW RECIPIENTS Répertorier les destinataires
SHOW SCHEMAS Lister les schémas
SHOW SHARES Répertorier les partages
SHOW SHARES IN PROVIDER Répertorier les partages à partir d’un fournisseur
SHOW TABLE EXTENDED Afficher les informations de table
SHOW TABLES Répertorier des tableaux
SHOW TABLES DROPPED Répertorier les tables supprimées
SHOW TBLPROPERTIES Afficher les propriétés de la table
SHOW USERS Répertorier les utilisateurs
SHOW VIEWS Vues de liste
SHOW VOLUMES Répertorier les volumes
SHOW VOLUMES ABANDONNÉ Liste des volumes abandonnés

Configuration et gestion des variables

Déclaration Descriptif
APPEL Appeler une procédure stockée
EXECUTE IMMEDIATE Exécuter sql dynamique
RESET Réinitialiser la configuration par défaut
SET Définir le paramètre de configuration
SET CHEMIN Définir le chemin de recherche du schéma de session
SET RECIPIENT Définir le contexte du destinataire du partage
SET TIME ZONE Définir le fuseau horaire de session
SET Variable Définir la valeur de la variable
USE CATALOG Définir le catalogue actuel
USE DATABASE Définir la base de données active
USE SCHEMA Définir le schéma actuel

Gestion des ressources

S’applique à : Databricks Runtime

Déclaration Descriptif
ADD ARCHIVE Ajouter une archive à la session
ADD FILE Ajouter un fichier à la session
ADD JAR Ajouter un fichier JAR à la session
LIST ARCHIVE Répertorier les archives de session
LIST FILE Répertorier les fichiers de session
LIST JAR Répertorier les jars de session

S’applique à : Databricks SQL Connector

Déclaration Descriptif
GET Télécharger le fichier à partir du volume
PUT INTO Charger le fichier dans le volume
REMOVE Supprimer le fichier du volume

Déclarations de sécurité

Gérer l’accès aux données. Pour plus d’informations, consultez les privilèges du metastore Hive et les objets sécurisables (hérités).

Déclaration Descriptif
ALTER GROUP Modifier l’appartenance au groupe
CREATE GROUP Créer un groupe
DENY Refuser des privilèges
DROP GROUP Supprimer un groupe
GRANT Accorder des privilèges
GRANT ON SHARE Accorder l’accès au partage
MSCK REPAIR PRIVILEGES Réparer les métadonnées de privilège
REVOKE Révoquer des privilèges
REVOKE ON SHARE Révoquer l’accès au partage
SHOW GRANTS Afficher les privilèges accordés
SHOW GRANTS ON SHARE Afficher les privilèges de partage
SHOW GRANTS TO RECIPIENT Afficher les privilèges des destinataires