tinybird

Tinybird のベストプラクティス

Tinybird のファイル形式、SQL のルール、最適化パターン、データモデリングに関するガイダンスです。Tinybird のデータファイルを作成または編集する際に、このスキルを使用してください。

適用する場面

• Tinybird のリソース（.datasource、.pipe、.connection）を作成または更新する
• SQL クエリを記述または最適化する
• エンドポイントのスキーマとデータモデルを設計する
• プロジェクトの構成とデータレイヤーを整理する
• マテリアライズドビューまたはコピーパイプを扱う
• 重複排除パターンを実装する
• Tinybird プロジェクトファイルをレビューまたはリファクタリングする

ルールファイル

• rules/project-files.md
• rules/build-deploy.md
• rules/datasource-files.md
• rules/pipe-files.md
• rules/endpoint-files.md
• rules/materialized-files.md
• rules/materialized-join-prefilter.md
• rules/sink-files.md
• rules/copy-files.md
• rules/connection-files.md
• rules/sql.md
• rules/endpoint-optimization.md
• rules/tests.md
• rules/deduplication-patterns.md

クイックリファレンス

• プロジェクトのローカルファイルが信頼できる情報源です。
• ビルド対象は tinybird.config.json の dev_mode（local または branch）で決まります。
• tb deploy は Tinybird Cloud の本番環境を対象にします。
• tb sql や tb logs などのコマンドは、--cloud または --branch=<branch-name> が設定されていない限り、デフォルトでローカルを対象にします。
• SQL は SELECT のみで、Tinybird のテンプレートルールと厳格なパラメーター処理に従います。
• デフォルトでは MergeTree を使用し、マテリアライズドターゲットには AggregatingMergeTree を使用します。
• 早い段階でフィルタリングし、必要な列だけを選択し、複雑な処理はパイプラインの後段に回します。