clickhouse-io

Guide ClickHouse schema design, query optimization, and data ingestion patterns.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/ndhananj/codex-agent-setup --skill clickhouse-io-ndhananj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clickhouse-io
Source: https://github.com/ndhananj/codex-agent-setup/tree/main/docs/zh-CN/skills/clickhouse-io
Command: npx skills add https://github.com/ndhananj/codex-agent-setup --skill clickhouse-io-ndhananj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides best practices for designing ClickHouse schemas, optimizing queries, and managing data pipelines for high-performance analytical workloads.

Core Features & Use Cases

  • Schema Design: Learn to use MergeTree, ReplacingMergeTree, and AggregatingMergeTree engines effectively.
  • Query Optimization: Implement efficient filtering, aggregation, and window functions.
  • Data Ingestion: Master batch and streaming insert patterns.
  • Materialized Views: Create real-time aggregations for faster insights.
  • Performance Monitoring: Understand how to check query performance and table statistics.
  • Use Case: Optimize your ClickHouse database to handle terabytes of time-series data, enabling sub-second query responses for complex analytical dashboards.

Quick Start

Review the provided SQL examples for creating and optimizing ClickHouse tables.

Frequently Asked Questions about clickhouse-io

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I optimize ClickHouse queries for sub-second analytical dashboard responses?

To optimize ClickHouse query performance, implement efficient filtering, aggregation, and window functions alongside proper schema design. This Skill provides guidance on performance diagnostics and SQL best practices to achieve sub-second query responses for complex analytical workloads.

When should I use AggregatingMergeTree vs ReplacingMergeTree for ClickHouse schema design?

Use AggregatingMergeTree for real-time aggregations and ReplacingMergeTree to manage duplicate rows in your ClickHouse schema. This Skill explains how to use these MergeTree engine variants effectively to handle terabytes of time-series data.

What is the best way to insert streaming data into ClickHouse for analytical workloads?

The best way to insert streaming data into ClickHouse is by mastering batch and streaming insert patterns. This Skill covers data ingestion patterns and data pipeline management to ensure high-performance analytical processing.

How do materialized views work in ClickHouse for real-time aggregations?

Materialized views in ClickHouse work by creating real-time aggregations for faster analytical insights. This Skill provides comprehensive guidance on implementing materialized views to accelerate query performance and manage data pipelines.

How can I monitor ClickHouse table statistics and query performance?

You can monitor ClickHouse query performance and table statistics by understanding performance diagnostics. This Skill provides comprehensive guidance on performance monitoring to check table statistics and optimize analytical workloads.

Can ClickHouse handle terabytes of time-series data for high-performance analytics?

Yes, ClickHouse can handle terabytes of time-series data for high-performance analytics. This Skill provides best practices for schema design, query optimization, and data pipeline management to enable sub-second query responses on large datasets.