mcpField
W
writing-clickhouse-queries

writing-clickhouse-queries

github.com/posthogデータ・データベース40.5k138 回インストール今日更新
リポジトリ

writing-clickhouse-queries について

PostHog 開発者向けに、新しい ClickHouse クエリや製品テーブルの作成・レビューを支援するスキルです。基準となるクエリガイドと関連資料を案内し、新規作成、最適化、マイグレーションの作業を区別します。

主な機能

  1. 01新規 ClickHouse クエリのガイド
  2. 02QueryRunner サブクラスのレビュー
  3. 03テーブルと ALTER の設計
  4. 04行 ID 形式の選択
  5. 05マテリアライズド列とインデックスの管理

活用シーン

  1. 01PostHog 製品のクエリ追加
  2. 02ClickHouse テーブルの新規設計
  3. 03テーブルの行 ID の選択
  4. 04スキップインデックスや Projection の追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/posthog/posthog --skill writing-clickhouse-queries

インストール後、Claude Code で/writing-clickhouse-queriesを入力して読み込まれたか確認します。

詳細

新規プロダクト向けの ClickHouse クエリの書き方

新規のクエリを書くのではなく、既存のクエリを最適化する場合、これは適切なスキルではありません。代わりに /optimizing-clickhouse-and-hogql-queries を使用してください。このスキルでは、レイヤーのトリアージ、スメルスキャン(FROM ... FINAL、プロパティに対する JSONExtract、スキップインデックスの欠落、自己結合、CTE の膨張)、Test Cluster での計測、適切なレイヤーでの修正の適用について扱っています。

新しいクエリを書くための正式なガイドについては、docs/published/handbook/engineering/databases/clickhouse-queries-new-products.md をお読みください。

次に、タスクに関連するドキュメントを必要に応じて参照してください。

使用する場面

  • posthog/hogql_queries/ または products/*/backend/ で QueryRunner のサブクラスを作成またはレビューするとき
  • プロダクト向けに新しい ClickHouse テーブルや ALTER を追加するとき(posthog/clickhouse/migrations/)
  • 新しいテーブルの行 ID 形式を選択するとき
  • マテリアライズドカラム、スキップインデックス、プロジェクションを追加または削除するとき

既存の低速なクエリを調査する場合、system.query_log の行をデバッグする場合、またはパフォーマンスのための HogQL プリンターの変更案をレビューする場合は、/optimizing-clickhouse-and-hogql-queries を使用してください。

適切でないスキル: Max / posthog:execute-sql を介した顧客向けのアドホックな HogQL には、query-examples を使用してください。マイグレーションの仕組み(ノードの役割、エンジン、レプリケーション)については、clickhouse-migrations を使用してください。

コメント

Markdown 対応