clickhouse/clickhouse-architecture-advisor

¿Qué hace clickhouse-architecture-advisor?

DEBE USARSE al diseñar arquitecturas ClickHouse, seleccionar entre patrones de ingesta o modelado, o traducir mejores prácticas en diseños de sistemas específicos para la carga de trabajo. Complementa clickhouse-mejores-prácticas con marcos de decisión y etiquetas explícitas de procedencia.

Propósito

Este skill proporciona orientación detallada para la arquitectura de ClickHouse, incluyendo la selección de patrones de ingesta y modelado basados en las características de la carga de trabajo. Incluye marcos de decisión que consideran factores como:

• Volumen de datos y velocidad de ingesta
• Patrones de consulta y latencia esperada
• Requisitos de consistencia y durabilidad
• Costos de almacenamiento y computación

Cómo usar

Para activar este skill, utiliza frases como:

• "Diseña una arquitectura ClickHouse para [descripción de la carga de trabajo]"
• "Selecciona un patrón de ingesta para [tipo de datos]"
• "Modela datos para ClickHouse con [requisitos]"

El skill responderá con recomendaciones estructuradas, incluyendo:

1. Patrón de ingesta recomendado (ej., tablas MergeTree, buffers, Kafka Engine)
2. Modelo de datos sugerido (ej., esquema en estrella, tabla plana, vistas materializadas)
3. Etiquetas de procedencia que documentan el origen de cada recomendación
4. Marco de decisión que justifica la elección basada en la carga de trabajo

Ejemplo

Pregunta: "Necesito diseñar una arquitectura ClickHouse para analítica de logs en tiempo real con un volumen de 10 TB/día y consultas agregadas cada minuto."

Respuesta del skill:

• Patrón de ingesta: Usa una tabla MergeTree con particionado por hora y un buffer de escritura asíncrono para manejar picos de ingesta.
• Modelo de datos: Crea una tabla de hechos con columnas de métricas pre-agregadas y utiliza vistas materializadas para resúmenes por minuto.
• Procedencia: La recomendación se basa en la documentación oficial de ClickHouse para ingesta de series temporales (fuente: clickhouse.com/docs/en/guides/real-time-logs).
• Marco de decisión: Se consideró el volumen (10 TB/día), la latencia requerida (1 minuto) y la necesidad de agregaciones en tiempo real.

Notas

• Este skill complementa clickhouse-mejores-prácticas, no lo reemplaza.
• Las etiquetas de procedencia permiten verificar la fuente de cada recomendación.
• Para casos complejos, combina este skill con otros de la suite ClickHouse.