Paramètres de configuration
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 remplacer temporairement un paramètre de configuration dans l’étendue d’une session en utilisant l’instruction SET. La valeur reste en vigueur pendant la durée de la session, sauf si l’utilisateur la remplace à nouveau avec une instruction SET ou 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 listées.
| Nom du paramètre | Description | 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 |
| ENABLE_PHOTON | Contrôle l’utilisation du moteur de requête vectorisée Photon. | true | Non | 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. | 128m | Non | 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.