Instruction SET

Documentation de l’instruction SET

SET param = value

Attribue value au paramètre param de la session en cours. Vous ne pouvez pas modifier les paramètres du serveur de cette manière.

Vous pouvez également définir, en une seule requête, toutes les valeurs du profil de paramètres spécifié.

SET profile = 'profile-name-from-the-settings-file'

Pour les paramètres booléens définis sur true, vous pouvez utiliser une syntaxe abrégée en omettant l’assignation de valeur. Lorsque seul le nom du paramètre est indiqué, il est automatiquement défini sur 1 (true).

-- These are equivalent:
SET force_index_by_date = 1
SET force_index_by_date

​

SET TIME ZONE

SET TIME ZONE [=] 'timezone'

Définit le fuseau horaire de la session. Il s’agit d’un alias de SET session_timezone = 'timezone', fourni pour assurer la compatibilité avec PostgreSQL et d’autres bases de données SQL.

De nombreux clients SQL, ORM et pilotes JDBC exécutent automatiquement SET TIME ZONE lors de la connexion. Cette syntaxe permet à ces outils de fonctionner avec ClickHouse sans recourir à des solutions de contournement personnalisées.

SET TIME ZONE 'UTC';
SET TIME ZONE 'Europe/Amsterdam';
SET TIME ZONE 'America/New_York';

-- Verify the current session time zone
SELECT getSetting('session_timezone');

La valeur de timezone doit être un nom valide issu de la base de données des fuseaux horaires de l’IANA. Un nom de timezone invalide entraînera une erreur.

Pour plus d’informations sur le paramètre session_timezone, consultez session_timezone.

​

Définition des paramètres de requête

L’instruction SET peut également être utilisée pour définir des paramètres de requête en préfixant le nom du paramètre par param_. Les paramètres de requête vous permettent d’écrire des requêtes génériques avec des espaces réservés remplacés par des valeurs réelles au moment de l’exécution.

SET param_name = value

Pour utiliser un paramètre de requête dans votre requête, faites-y référence avec la syntaxe {name: datatype} :

SET param_id = 42;
SET param_name = 'John';

SELECT * FROM users
WHERE id = {id: UInt32}
AND name = {name: String};

Les paramètres de requête sont particulièrement utiles lorsque la même requête doit être exécutée plusieurs fois avec des valeurs différentes.

Pour en savoir plus sur les paramètres de requête, notamment leur utilisation avec le type Identifier, consultez Définition et utilisation des paramètres de requête.

Pour plus d’informations, consultez Paramètres.