自動品質ゲート
レシピ公開前の5つのチェック
レシピ契約を完了する
監査には、質問、イベント スキーマ、SQL、サンプル結果、視覚化、説明、エッジ ケース、ダッシュボード ガイダンス、アラート ガイダンス、および関連する読み取りが必要です。
読み取り専用ステートメントポリシー
クエリは SELECT または WITH で始める必要があります。監査では、DDL と、CREATE、INSERT、UPDATE、DELETE、DROP、ALTER、MERGE などの書き込みキーワードが拒否されます。
型付き DataFusion の実行
Each schema becomes an empty Apache Arrow record batch. The query is planned and executed with Apache DataFusion 45.2.0, catching invalid columns, types, functions, and syntax.
再現可能なブラウザフィクスチャ
30 cross-category recipes also execute their complete synthetic input with DuckDB 1.3.2 and compare every expected result value within displayed precision.
レンダリングされたページの整合性
サイト監査では、すべてのレシピがレンダリングされ、そのステータス、正規 URL、タイトル、説明、H1、構造化データ、内部リンクがチェックされます。
実行チェックが証明するもの
監査では、レシピ ページに表示されるフィールド名と矢印タイプに基づいて、文書化されたすべてのテーブルが構築されます。新しい DataFusion セッションに空のバッチを登録し、公開されたものとまったく同じ SQL を実行します。エンジンが計画または実行を拒否した場合は失敗します。これにより、運用データを必要とせずに、スペルミスのフィールド、互換性のない操作、サポートされていない関数、あいまいな列、不正な形式の間隔、および多くの戻り値の型の間違いが検出されます。
ピン留めされたバージョンは意図的です。 SQL エンジンは進化するため、類似の方言がクエリを受け入れるという理由だけで、クエリに互換性があるというラベルが付けられるわけではありません。アプリケーションが DataFusion をアップグレードすると、文書化されたバージョンが変更される前に完全なコレクションが再実行されます。
コピーしても安全であると想定するのは安全ではありません
クエリでは、アクティブなアカウントの定義、回復された支払い、永続的な Webhook の失敗、または許容可能な遅延を知ることはできません。各レシピにはそれらの選択肢に名前が付けられているため、レビュー担当者はダッシュボードやアラートが正式になる前にそれらを変更できます。
人間によるレビュー
まだ判断が必要なもの
空の型付きテーブルは、クエリが計画され実行されていることを証明します。ビジネス定義が正しいことを証明するものではありません。
表示される行とグラフは、決定的な合成例です。これらは、ベンチマークや顧客の結果ではなく、出力の形状と意図した解釈を示しています。
しきい値、最小量、時間枠、アイデンティティ ルール、通貨、ターミナル ステータスは、それらを所有するイベント コントラクトに適合させる必要があります。
遅延イベント、重複したプロバイダー配信、不完全な最新バケット、およびスキーマ変更により、SQL が有効な場合でも実際の結果が変わる可能性があります。
公共設備契約書
すべてのレシピは、型付きスキーマ、例示的な入力行、正確な SQL、決定論的な予想出力、エンジン バージョン、およびレビュー メモを含む JSON バンドルを公開します。 CSV は同じ表示結果を公開しますが、静的 SVG はサンプル チャートをインデックス化して再利用可能にします。コンパクトな入力は、フィールド名と JSON タイプを示しています。意図的に、集計結果の完全なジェネレーターとしては表されていません。
の 30 再現可能なレシピはさらに進化し、完全な合成行は ブラウザ SQL プレイグラウンド 期待値と照合されます。他のコンパクトな入力はスキーマのデモンストレーションのままであり、小さな教育器具が統計的検証セットと間違われるのを防ぎます。
の 接続済み SQL ラボ は、別のバージョンの合成 SaaS データセットを使用するため、学習者はレッスン データと運用ベンチマークを混同することなく、結合や多段階のビジネス定義を練習できます。
主要エンジンのリファレンス
Apache は、信頼できる SQL の構文、関数、型、アップグレードに関するドキュメントを公開しています。ライブ リファレンスには、Telemetry のピン留めされたテスト ターゲットよりも新しいリリースが記載されている可能性があるため、レシピ ページの互換性に関する主張では、引き続き正確な監査済みバージョンの名前が付けられます。
独自のイベント契約でレシピを検証する
フィールド名とタイプを照合し、成功パスと失敗パスをカバーする小さな合成フィクスチャを送信し、中間 CTE を検査し、合計を既知の入力と比較し、保存されたクエリの横に最終的なビジネス定義を文書化します。