Workflows

Dory での分析の保存と再利用

有用なクエリは一時タブに留まるべきではありません。 Dory Saved Queries を使用すると、SQL、ビジネス コンテキスト、および前提条件を保存できるため、自分またはチームが作業を再利用できます。

分析を保存する場合

  • クエリは繰り返し実行されます。
  • 安定したビジネス上の質問に答えます。
  • デバッグまたは最適化されています。
  • グラフ、レポート、または運用ワークフローを強化します。
  • 他のチームメンバーもそれを必要とします。

1.SQL をクリーンアップする

保存する前に:

  • 一時的な実験を削除します。
  • 有益なコメントを残しておきます。
  • 時間範囲またはパラメータポイントを明確にします。
  • 読み取り可能な列の別名を使用します。
  • クエリに共有ロジックのみが含まれていることを確認します。

2. ビジネス向けの名前を使用する

弱い名前もっと良い名前
orders query 過去 30 日間の毎日の注文
user sqlアクティブユーザーが多い都市
debug支払い注文の調査に失敗しました
clickhouse testClickHouse の遅いクエリ トップ 50

3. 文書の前提条件

ビジネス上の質問、メトリックの定義、時間範囲、フィルター、重複排除ロジック、接続、グラフの使用例を含めます。

Counts daily paid orders for the last 30 days. Used for the operations trend chart. Aggregates by created_at date and does not deduplicate users.

4. フォルダーで整理する

便利なフォルダー パターン:

  • ドメイン: 注文、ユーザー、支払い、イベント。
  • 使用例: ダッシュボード、デバッグ、週次レポート。
  • 環境: 実稼働読み取り専用、ステージング、デモ。
  • データベース: ClickHouse、PostgreSQL、MySQL。

5. レビューとアーカイブ

古いクエリを定期的にアーカイブし、スキーマ変更後に SQL を更新し、重複をマージし、重要なクエリを明確にマークします。

FAQ

保存してはいけないものは何ですか?

未検証の実験、機密性の高い値、書き込み操作、または個人のローカル環境に依存するクエリを保存しないでください。

保存されたクエリはドキュメントに代わるものですか?

いいえ。保存されたクエリは実行可能ファイル SQL を保持します。複雑なメトリック定義は依然としてドキュメントに含まれています。

チームは保存された分析をより簡単に再利用するにはどうすればよいですか?

わかりやすい名前を使用し、説明を書き、クエリをフォルダーに整理し、古い SQL を定期的にアーカイブします。

次のステップ

このガイドは役に立ちましたか?