Перейти к основному содержимому

Назначение

<ClickHouseFactName> хранит append-only analytics fact для <report/dashboard/export>.

Table

ПолеЗначение
Database<database>
Table<table>
Owner serviceAnalytics
Source events<events>
Transform version<version>
Freshness SLA<sla>

Columns

ColumnTypeNullableSourcePartition/OrderPII
<column><type>да/нет<source><partition/order/none>да/нет

Deduplication

  • Dedup key: <eventId/businessKey>.
  • Replay behavior: <idempotent insert/replacing merge tree>.
  • Late event behavior: <rule>.

Partition И TTL

  • Partition key: <key>.
  • Order key: <key>.
  • TTL/retention: <policy>.

Consumers И Backfill

ProcessНазначениеCheckpoint
<consumer>Ingest facts<offset/watermark>
<backfill>Rebuild range<range checkpoint>

Security

  • Raw PII не хранится без classification.
  • Export permissions проверяются в API layer.
  • ClickHouse не используется как operational source of truth.

Обратные ссылки

Автоссылки: где используется этот документ.