Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
Databricks SQL
Un paramètre de configuration est un paramètre qui affecte le comportement de Databricks SQL en dehors de la syntaxe SQL spécifiée.
La valeur effective d’un paramètre de configuration est dérivée des différents niveaux où il est défini.
Étendues des paramètres de configuration
Système
La valeur système est la valeur par défaut utilisée par Databricks SQL s’il n’y a pas de remplacement.
Global
Un administrateur peut remplacer la valeur système par défaut d’un paramètre en utilisant Configurer les paramètres SQL ou l’API Entrepôt SQL. Cette valeur est alors la valeur initiale vue par toute session nouvellement établie à venir.
Session
Un utilisateur peut écrirer un paramètre de configuration pendant toute la session avec l’énoncéSET. Certains paramètres possèdent une instruction dédiée, comme SET PATH ou SET TIME ZONE. Le réglage reste en vigueur jusqu’à ce que l’utilisateur le remette en charge ou utilise RESET.
Paramètres de configuration pris en charge
Vous trouverez ci-dessous une liste des paramètres de configuration que vous pouvez définir dans Databricks SQL, leur valeur système par défaut et les niveaux auxquels ils peuvent être définis. Databricks SQL ne prend pas en charge la définition des configurations Spark qui ne sont pas répertoriées.
| Nom du paramètre | Descriptif | Valeur système par défaut | Définissable globalement | Définissable au niveau de la session |
|---|---|---|---|---|
| ANSI_MODE | Vous permet de désactiver un comportement ANSI SQL strict pour certaines fonctions et règles de cast. | true | Oui | Oui |
| LEGACY_TIME_PARSER_POLICY | Contrôle la façon dont les dates et les horodatages sont analysés et mis en forme. | Exception | Oui | Oui |
| MAX_FILE_PARTITION_BYTES | Le nombre maximal d’octets à empaqueter dans une même partition lors de la lecture de sources basées sur des fichiers. | 128 m | Non | Oui |
| PATH | Définit le chemin de recherche de schéma utilisé pour résoudre les noms non qualifiés. | system.session, system.builtin, system.ai, CURRENT_SCHEMA |
Oui | Oui |
| READ_ONLY_EXTERNAL_METASTORE | Contrôle si un metastore externe est traité comme étant en lecture seule. | false | Oui | Non |
| STATEMENT_TIMEOUT | Définit un délai d’expiration en secondes pour l’instruction SQL | 172800 secondes | Oui | Oui |
| TIMEZONE | Définit le fuseau horaire local. | UTC | Oui | Oui |
| USE_CACHED_RESULT | Contrôle si Databricks SQL met en cache et réutilise les résultats chaque fois que c’est possible. | true | Non | Oui |
La valeur système par défaut ANSI_MODE est FALSE pour les comptes ajoutés avant Databricks SQL 2022.35.