ClickHouse best practices: 31 rules for schema design, query tuning, ingestion and agent connectivity
La discipline de revue officielle ClickHouse : 31 règles classées par impact avec checklists pour schémas, requêtes, inserts, plus un workflow sûr connecter → découvrir → interroger pour les agents
- Quoi
- La discipline de revue officielle ClickHouse : 31 règles classées par impact avec checklists pour schémas, requêtes, inserts, plus un workflow sûr connecter → découvrir → interroger pour les agents
- Coût
- Gratuit
- Prérequis
- une instance ClickHouse accessible à l'agent (serveur MCP ou CLI avec identifiants — accès à configurer vous-même) ; ClickHouse Cloud a un niveau gratuit et l'auto-hébergement est gratuit
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — la discipline de revue officielle @clickhouse pour les schémas, requêtes et configurations ClickHouse : 31 règles en 4 catégories (schéma, requête, insert, agent), classées par impact, avec des fichiers par règle que les agents DOIVENT lire avant de répondre. Les revues de schéma vérifient la planification du ORDER BY immuable, l'ordre des colonnes par cardinalité, les types natifs, la largeur de bits minimale, LowCardinality pour les colonnes texte, l'évitement de Nullable et les bornes de partition (100–1 000 valeurs) ; les revues de requêtes imposent le choix d'algorithme de JOIN, le filtrage avant jointure, les indices secondaires et l'alignement sur le préfixe ORDER BY ; les revues d'insertion exigent des lots de 10K–100K lignes, les inserts asynchrones pour les petites écritures fréquentes, et ReplacingMergeTree plutôt que ALTER UPDATE. Les agents reçoivent aussi un workflow de connectivité et de sécurité : connexion via MCP ou CLI, découverte de schéma en 7 étapes (bases → tables → colonnes → clés de tri → indices → échantillon → EXPLAIN), puis exécution avec LIMITs et timeouts, filtres resserrés en cas d'erreur de timeout ou mémoire. Format de sortie standard (règles vérifiées → violations → conformes → recommandations) avec citations « Per rule-name... ». Bémols honnêtes : un corpus de règles exhaustif — les revues complètes coûtent cher en tokens sur de grands patrimoines ; le skill suppose que l'agent peut joindre une instance ClickHouse (identifiants MCP/CLI), à configurer vous-même. Licence Apache-2.0. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Installation
Prérequis : une instance ClickHouse accessible à l'agent (serveur MCP ou CLI avec identifiants — accès à configurer vous-même) ; ClickHouse Cloud a un niveau gratuit et l'auto-hébergement est gratuit Installe-moi « Bonnes pratiques ClickHouse : 31 règles de conception de schéma, optimisation de requêtes, ingestion et connectivité d'agents ». Il donne à mon agent la discipline de revue officielle ClickHouse : 31 règles classées par impact (planification de la clé primaire, types de données, partitionnement, optimisation des JOINs, indices secondaires, batch d'inserts, inserts async, évitement des mutations), des checklists procédurales de revue de schéma/requête/insert avec un format de sortie Règles vérifiées → Violations → Recommandations, plus le workflow de connectivité agent (connexion via MCP/CLI, découverte de schéma en 7 étapes, planification avec les clés de tri, exécution avec LIMITs et timeouts, récupération en resserrant les filtres). Les fichiers de règles sont cités « Per rule-name... » dans les réponses. Licence Apache-2.0. Dépôt : https://github.com/clickhouse/agent-skills/blob/main/skills/clickhouse-best-practices/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur, les identifiants uniquement via le coffre sécurisé, les hôtes autorisés déclarés dans le SKILL.md. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « clickhouse-best-practices ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. configurer mon accès ClickHouse MCP ou CLI avec identifiants, puis demander à l'agent de suivre le workflow connecter → découvrir → interroger du skill). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.