altinity-expert-clickhouse-ingestion

Diagnose ClickHouse INSERT performance bottlenecks with SQL checks.

16|2|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/Altinity/Skills --skill altinity-expert-clickhouse-ingestion-altinity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: altinity-expert-clickhouse-ingestion
Source: https://github.com/Altinity/Skills/tree/main/altinity-expert-clickhouse/skills/altinity-expert-clickhouse-ingestion
Command: npx skills add https://github.com/Altinity/Skills --skill altinity-expert-clickhouse-ingestion-altinity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose ClickHouse INSERT performance, batch sizing, part creation patterns, and ingestion bottlenecks to accelerate data pipelines and reduce ingestion delays.

Core Features & Use Cases

  • Analyze insert latency, batch sizes, and MV overhead when materialized views are involved to identify bottlenecks.
  • Inspect ingestion pipelines (e.g., Kafka-backed ingestion) for throughput gaps, backpressure, or skew.
  • Provide actionable remediation guidance and SQL queries to validate fixes and monitor progress.

Quick Start

Run the ingestion checks against your cluster to reveal slow inserts and batch inefficiencies and outline concrete optimization steps.

Frequently Asked Questions about altinity-expert-clickhouse-ingestion

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

FAQPage Schema
Why is my ClickHouse INSERT ingestion slow and how do I diagnose the bottleneck?

ClickHouse INSERT ingestion slows down due to inefficient batch sizing, excessive part creation, or materialized view overhead. Run SQL checks to identify slow inserts, inspect batch patterns, and reveal backpressure in pipelines like Kafka-backed ingestion.

How do I optimize batch sizing for ClickHouse inserts to improve throughput?

Optimize ClickHouse insert batch sizing by analyzing current insert latency and part creation patterns. Apply targeted SQL checks to detect small batches causing too many parts, then adjust insertion parameters to reduce overhead and accelerate data pipeline throughput.

Does this diagnose Kafka-backed ingestion throughput gaps and materialized view overhead in ClickHouse?

Yes, it diagnoses Kafka-backed ingestion throughput gaps by inspecting pipelines for backpressure or skew. It also analyzes materialized view overhead to identify ingestion bottlenecks, providing actionable remediation guidance and SQL queries to validate fixes.

What is the best way to reduce part creation overhead during ClickHouse data ingestion?

Reduce ClickHouse part creation overhead by diagnosing insertion patterns with SQL checks. Identify frequent small inserts causing part merges, then implement durable fixes by adjusting batch sizes to optimize ingestion pipeline performance.

How do I check if materialized views are causing ClickHouse ingestion bottlenecks?

Check ClickHouse materialized view ingestion bottlenecks by analyzing insert latency and MV overhead. Run provided SQL checks to evaluate view processing impact on insertion speed, then apply contextual guidance to interpret results and implement optimizations.

What SQL checks are needed to validate ClickHouse insert performance fixes?

Validate ClickHouse insert performance fixes by running SQL checks from the checks.sql collection. These queries monitor insert latency, batch sizes, and part creation patterns, enabling you to interpret results and confirm ingestion optimizations are effective.