Modifie les profils de paramètres.
Syntaxe :
ALTER SETTINGS PROFILE [IF EXISTS] name1 [RENAME TO new_name |, name2 [,...]]
[ON CLUSTER cluster_name]
[SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [CONST|READONLY|WRITABLE|CHANGEABLE_IN_READONLY] | INHERIT 'profile_name'] [,...]
[ADD|MODIFY SETTINGS variable [= value] [MIN [=] min_value] [MAX [=] max_value] [CONST|READONLY|WRITABLE|CHANGEABLE_IN_READONLY] [,...]
[DROP SETTINGS variable [,...] ]
[ADD PROFILES 'profile_name' [,...] ]
[DROP PROFILES 'profile_name' [,...] ]
[DROP ALL SETTINGS]
[DROP ALL PROFILES]
[TO {{role1 | user1 [, role2 | user2 ...]} | NONE | ALL | ALL EXCEPT {role1 | user1 [, role2 | user2 ...]}}]
ON CLUSTER permet de modifier les profils de paramètres d’un cluster, voir DDL distribué.
Remplacer ou modifier des paramètres
ALTER SETTINGS PROFILE prend en charge deux manières distinctes de modifier les paramètres et les profils parents (hérités) d’un profil. Leur comportement diffère fortement, il est donc important de choisir la bonne.
Une clause SETTINGS seule (sans ADD, MODIFY ni DROP) remplace l’intégralité de la liste des paramètres ainsi que tous les profils parents du profil par exactement les éléments que vous indiquez. Tout ce qui était présent auparavant mais ne figure pas dans la liste est supprimé sans avertissement.
CREATE SETTINGS PROFILE OR REPLACE p
SETTINGS max_execution_time = 10, enable_lazy_columns_replication = 1;
ALTER SETTINGS PROFILE p SETTINGS max_memory_usage = 16106127360;
SHOW CREATE SETTINGS PROFILE p;
-- → CREATE SETTINGS PROFILE p SETTINGS max_memory_usage = 16106127360
-- max_execution_time and enable_lazy_columns_replication are gone.
Comme la forme SETTINGS seule effectue un remplacement complet, l’utiliser pour « redéfinir un seul paramètre » sur un profil de base déjà renseigné supprimera tous les autres paramètres (ainsi que tous les profils parents) de ce profil. Si vous voulez seulement modifier un seul paramètre tout en conservant le reste, utilisez la forme incrémentielle MODIFY/ADD/DROP décrite ci-dessous.
SETTINGS dans CREATE SETTINGS PROFILE : la clause définit la liste complète des paramètres.
Les mots-clés ADD, MODIFY et DROP modifient des entrées individuelles tout en laissant le reste du profil intact :
ADD SETTINGS variable = value [constraints] — ajoute un paramètre qui n’est pas encore présent.MODIFY SETTINGS variable = value [constraints] — remplace l’entrée d’un seul paramètre. L’entrée entière (valeur et contraintes) est remplacée ; indiquez donc à nouveau MIN/MAX/READONLY/etc. si vous souhaitez les conserver.DROP SETTINGS variable [,...] — supprime les paramètres indiqués.ADD PROFILES 'profile_name' [,...] / DROP PROFILES 'profile_name' [,...] — ajoute ou supprime des profils parents (hérités).DROP ALL SETTINGS / DROP ALL PROFILES — supprime tous les paramètres ou tous les profils parents.
Plusieurs de ces clauses peuvent être combinées dans une seule instruction, par exemple DROP SETTINGS a ADD SETTINGS b = 1.
Surchargez un seul paramètre tout en conservant le reste d’un profil existant :
ALTER SETTINGS PROFILE p MODIFY SETTINGS max_memory_usage = 16106127360;
ALTER SETTINGS PROFILE my_profile
DROP SETTINGS readonly
ADD SETTINGS max_threads = 8 MIN 4 MAX 16 WRITABLE;
ALTER SETTINGS PROFILE my_profile ADD PROFILES p1;
ALTER SETTINGS PROFILE my_profile DROP PROFILES p1;
SHOW CREATE SETTINGS PROFILE :
SHOW CREATE SETTINGS PROFILE my_profile;
Incrémental vs remplacement complet
Une clause SETTINGS utilisée seule supprime tous les paramètres existants ainsi que tous les profils hérités (parents) du profil avant d’appliquer les nouveaux.
ADD SETTINGS ou MODIFY SETTINGS (voir les exemples ci-dessous).
ADD SETTINGS et MODIFY SETTINGS conservent tous deux les autres paramètres du profil, mais ils traitent différemment une entrée existante pour le même paramètre :
ADD SETTINGS variable = value ... supprime d’abord toute entrée existante pour variable, puis insère la nouvelle. Il remplace donc la valeur ainsi que toutes les contraintes de ce paramètre. Tout MIN, MAX ou attribut de modification (READONLY/WRITABLE/CONST/CHANGEABLE_IN_READONLY) précédemment défini pour variable et que vous ne répétez pas est supprimé.MODIFY SETTINGS variable = value ... fusionne champ par champ : il remplace uniquement les champs que vous spécifiez effectivement (la valeur, ou MIN, ou MAX, ou l’attribut de modification) et conserve les autres champs de ce paramètre en l’état.
En bref, utilisez MODIFY SETTINGS lorsque vous voulez seulement ajuster un aspect d’un paramètre (par exemple, uniquement la valeur, tout en conservant un MAX existant) ; utilisez ADD SETTINGS lorsque vous voulez redéfinir un paramètre à partir de zéro.
CREATE SETTINGS PROFILE OR REPLACE p SETTINGS max_execution_time = 60;
ALTER SETTINGS PROFILE p MODIFY SETTINGS max_memory_usage = 20000000000;
SHOW CREATE SETTINGS PROFILE p;
-- CREATE SETTINGS PROFILE p SETTINGS
-- max_execution_time = 60,
-- max_memory_usage = 20000000000
MODIFY fusionne les champs un par un, le fait de ne modifier que la valeur d’un paramètre conserve les contraintes existantes :
ALTER SETTINGS PROFILE p MODIFY SETTINGS max_memory_usage = 20000000000 MAX 30000000000;
ALTER SETTINGS PROFILE p MODIFY SETTINGS max_memory_usage = 25000000000;
SHOW CREATE SETTINGS PROFILE p;
-- ... max_memory_usage = 25000000000 MAX 30000000000 -- the MAX constraint is preserved
ALTER SETTINGS PROFILE p ADD SETTINGS max_threads = 8 MAX 16 READONLY;
MODIFY, le fait de réexécuter ADD en ne fournissant qu’une valeur supprime les contraintes précédemment définies pour ce paramètre :
ALTER SETTINGS PROFILE p ADD SETTINGS max_threads = 4;
SHOW CREATE SETTINGS PROFILE p;
-- ... max_threads = 4 -- the MAX and READONLY constraints are gone
ALTER SETTINGS PROFILE p DROP SETTINGS max_threads;
ALTER SETTINGS PROFILE p DROP ALL SETTINGS;
Travailler avec des profils hérités
ALTER SETTINGS PROFILE p ADD PROFILES base_profile;
ALTER SETTINGS PROFILE p DROP PROFILES base_profile;
ALTER SETTINGS PROFILE p DROP ALL PROFILES;
