イベント契約
クエリが期待するフィールド
| フィールド | 種類 | なぜ存在するのか |
|---|---|---|
| timestamp_utc | Timestamp | イベントが発生したとき。 |
| team_id | Utf8 | 安定したアカウントまたはワークスペースの識別子。 |
| event_name | Utf8 | 製品イベント名。 |
| feature_name | Utf8 | feature_used イベントの安定した機能の識別子。 |
DataFusion SQL
クエリをコピーする
sql
WITH upgrades AS (
SELECT
team_id,
MIN(timestamp_utc) AS upgraded_at
FROM product_events
WHERE event_name = 'plan_upgraded'
GROUP BY team_id
),
pre_upgrade_features AS (
SELECT DISTINCT
e.team_id,
e.feature_name
FROM product_events e
JOIN upgrades u ON e.team_id = u.team_id
WHERE e.event_name = 'feature_used'
AND e.timestamp_utc < u.upgraded_at
AND e.timestamp_utc >= u.upgraded_at - INTERVAL '30 days'
)
SELECT
feature_name,
COUNT(DISTINCT team_id) AS upgraded_teams_using_feature
FROM pre_upgrade_features
GROUP BY feature_name
ORDER BY upgraded_teams_using_feature DESC;この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。
クエリ結果
アップグレードされたチーム間での機能の導入
この合成例では、共有ダッシュボードが最も一般的なアップグレード前の動作です。
shared_dashboard
184
alert_created
151
scheduled_export
112
ai_query
97
| feature_name | upgraded_teams_using_feature |
|---|---|
| shared_dashboard | 184 |
| alert_created | 151 |
| scheduled_export | 112 |
| ai_query | 97 |
合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。
例を再現する
パブリックフィクスチャをダウンロードする
JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。
SQL の仕組み
- 1アップグレード CTE は、チームごとの最初のアップグレード時間を見つけます。
- 2結合により、機能のアクティビティがアップグレードの 30 日前に制限され、アップグレード後の導入によって結果が汚染されるのを防ぎます。
- 3DISTINCT チームと機能のペアにより、ヘビーユーザーがランキングを独占しないようにします。
決定すべきエッジケース
- 共通の機能を予測として扱う前に、アップグレードされていないチームと比較してください。
- アカウントのサイズ、プランの適格性、および保有期間を制御します。これらの変数は導入とアップグレードの両方に影響します。
- すべてのアカウントで機能が利用できない場合は、露出イベントを使用します。
推奨されるダッシュボード
- 棒グラフ: upgraded_teams_using_feature
- 比較表: アップグレードされたチームとアップグレードされていない対象チーム間の導入状況
- 折れ線グラフ: 最初の機能の使用からアップグレードまでの時間
レシピを活用する
関連する機器とガイド
分析を続ける
実際のイベントで実行する
テーブルを作成し、フィールドを調整して、結果を保存します
無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。