Référence sur le langage SQL

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

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 déclaratifs Spark Lakeflow, consultez la référence du langage PIPELINE SQL.

Note

Databricks SQL Serverless n’est pas disponible dans Azure Chine. 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 à des instructions SQL	Ajout de commentaires à votre code SQL
Mots réservés et schémas	Mots clés réservés par l’analyseur SQL
Identifiers	Règles pour nommer des objets de base de données
Names	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
Collation	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
Modèles 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
Functions	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 définies par l’utilisateur d’agrégation (UDAF)	Fonctions d’agrégation personnalisées
Fonctions scalaires externes définies par l'utilisateur (UDF)	Fonctions scalaires personnalisées
Intégration avec les fonctions UDF, UDAF et UDTF Hive	Compatibilité des fonctions Hive
Invocation de la fonction	Comment appeler des fonctions

Concepts du catalogue Unity

Reference	Descriptif
Directeur	Utilisateurs, groupes et principaux de service
Privilèges et objets sécurisables dans Unity Catalog	Contrôle d’accès dans le catalogue Unity
Privilèges et objets sécurisables dans le metastore Hive	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
Credentials	Informations d’identification d’accès au stockage
Volumes	Stockage de fichiers managé et externe

Rubriques spéciales

Reference	Descriptif
Conformité ANSI dans Databricks Runtime	Compatibilité standard ANSI SQL
Compatibilité d’Apache Hive	Compatibilité Hive SQL
Script SQL	Logique SQL procédurale
Partage delta	Partage de données inter-organisations
Requêtes fédérées (Fédération Lakehouse)	Interrogation de bases de données externes
Schéma d’informations	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	Créer un index de filtre de floraison
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 et Python)	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 UNE 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 VIEW	Créer une vue
CREATE VOLUME	Créer 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, et SCHEMATABLE)	Actualiser les métadonnées étrangères
REFRESH (MATERIALIZED VIEW ou STREAMING TABLE)	Actualiser les données matérialisées
SET ÉTIQUETTE	Ajouter des balises à des objets
`SYNC`	Synchroniser les métadonnées
TRUNCATE TABLE	Supprimer toutes les données de table
UNDROP	Restaurer la table supprimée
BALISE UNSET	Supprimer des balises d’objets

Instructions 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 au 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 la syntaxe de pipeline SQL.

Instructions de requête

Déclaration	Descriptif
Query	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 de 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
clause CLUSTER BY (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
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
Appel de fonction table (TVF)	Fonctions retournant des tables
Expression de table commune (CTE)	Sous-requêtes nommées
Définir des opérateurs	UNION, INTERSECT, EXCEPT
Clause WINDOW	Définitions de fenêtre nommées
Indicateurs	Indicateurs d’optimiseur de requête

Instructions 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
BEGIN END, instruction composée	Regrouper des instructions dans un bloc
CASE	Branchement conditionnel
FOR	Boucle sur une plage ou un curseur
GET DIAGNOSTICS, instruction	Récupérer les informations d’exécution
IF THEN ELSE, instruction	Exécution conditionnelle
ITERATE, instruction	Passer à l’itération de boucle suivante
Instruction LEAVE	Quitter une boucle ou un bloc
Instruction LOOP	Boucle inconditionnelle
INSTRUCTION REPEAT	Boucle jusqu’à ce que la condition soit vraie
INSTRUCTION RESIGNAL	Réactiver une exception
INSTRUCTION SIGNAL	Déclencher une exception
Boucle 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 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 LA 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

Instructions SHOW

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

Configuration et gestion des variables

Déclaration	Descriptif
CALL	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 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