Passer au contenu principal

dictionnaires dans ClickHouse

Les dictionnaires créés dans ClickHouse Cloud peuvent présenter des incohérences durant la phase de création initiale. Cela signifie qu’il se peut que vous ne voyiez aucune donnée dans le dictionnaire juste après sa création. Toutefois, après plusieurs tentatives, la requête de création peut aboutir sur différentes répliques, et les données deviennent alors visibles. Cela se produit parfois parce que le dictionnaire a été créé avant que la part n’atteigne le serveur. Par exemple :
Comme vous pouvez le constater, la part n’est arrivée qu’après la création du dictionnaire. Cela peut devenir plus problématique si vous utilisez LIFETIME(MIN 0 MAX 0), car cela signifie que le dictionnaire ne sera jamais actualisé automatiquement. Par conséquent, le dictionnaire restera vide tant que la commande RELOAD DICTIONARIES n’aura pas été exécutée. Pour résoudre ce problème, utilisez une requête SELECT au lieu de spécifier une table source lors de la création du dictionnaire, et activez le paramètre select_sequential_consistency=1. Au lieu de spécifier une table source :
Utilisez une requête SELECT avec select_sequential_consistency=1 :

Pourquoi ce problème se produit-il ?

Lorsque vous insérez des données puis créez ou rechargez un dictionnaire, l’instruction DDL peut parvenir à une réplique avant les données (ou les nouvelles données). Cela entraîne une incohérence entre les dictionnaires des différentes répliques. Ensuite, selon la réplique qui reçoit la requête, vous pouvez obtenir des résultats différents. Notez que la même chose se produit lorsque vous insérez des données puis lisez immédiatement une table. Si vous lisez depuis une réplique qui n’a pas encore répliqué les données, vous ne verrez pas les données nouvellement insérées. Si vous avez besoin d’une cohérence séquentielle, au détriment des performances (raison pour laquelle son utilisation n’est généralement pas recommandée), vous pouvez activer select_sequential_consistency. Le cas des dictionnaires est un peu plus délicat, car les dictionnaires n’utilisent pas les paramètres de la requête, mais ceux du serveur. Par conséquent, lors du chargement des données dans le dictionnaire, même si vous SET select_sequential_consistency=1, les données peuvent être chargées de façon incohérente entre les répliques. Le fait de spécifier select_sequential_consistency=1 dans la requête de la source du dictionnaire permet au dictionnaire de respecter ce paramètre, même s’il n’est pas activé globalement en tant que paramètre du serveur.
Dernière modification le 29 juin 2026