クエリの例 query-examples
この節では、データレイクのジャーニーステップイベントに関するクエリを実行する際によく使用される例を示します。 具体的なユースケースに立ち入る前に、ジャーニーイベントデータで使用される主要識別子を理解しておくことが重要です。
クエリで使用するフィールドに、対応するスキーマに関連する値があることを確認します。
キー識別子について key-identifiers
ID、instanceID、profileID の違いは何ですか。
- ID：すべてのステップイベントエントリに対して一意です。2 つの異なるステップイベントに同じ ID を割り当てることはできません。
- instanceID:instanceID は、ジャーニー実行内のプロファイルに関連付けられるすべてのステップイベントで同じです。 プロファイルがジャーニーに再度入ると、別の instanceID が使用されます。 この新しい instanceID は、再入力されたインスタンスのすべてのステップイベント（開始から終了まで）で同じになります。
- profileID：ジャーニー名前空間に対応したプロファイルの ID です。
| note note |
|---|
| NOTE |
| トラブルシューティングの目的では、ジャーニーのクエリ時に journeyVersionName ではなく journeyVersionID を使用することをお勧めします。ジャーニーのプロパティ属性について詳しくは、この節を参照してください。 |
基本的なユースケース／一般的なクエリ common-queries
特定の時間枠にジャーニーにエントリしたプロファイルの数
このクエリでは、指定された時間枠に指定されたジャーニーにエントリした個別のプロファイル数が表示されます。
データレイクのクエリ
| code language-sql |
|---|
|
詳しくは、journey_step_events で破棄されたイベントタイプのトラブルシューティングを参照してください。
プロファイルが特定のジャーニーにエントリしなかった原因となったルール
このクエリは、キャップルールまたは実施要件ルールにより、プロファイルがジャーニーにエントリできない場合に、却下されたルールセットとルール情報を返します。
例
| code language-sql |
|---|
|
プロファイルがジャーニーアクションを受信しない原因となったルール
このクエリは、ジャーニー中に破棄され、ジャーニーアクションを受信しなかったプロファイルのステップイベントの詳細を返します。 これは、非表示時間の制約などのビジネスルールが原因でプロファイルが破棄された理由を特定するのに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリ結果には、プロファイル破棄の理由を特定するのに役立つ次のキーフィールドが表示されます。
-
actionExecutionError -
businessRuleProfileDiscardedに設定すると、ビジネスルールが原因でプロファイルが破棄されたことを示します。 「eventType」フィールドには、破棄の原因となった特定のビジネス・ルールに関する追加の詳細が表示されます。 -
eventType – 破棄の原因となったビジネス・ルールのタイプを指定します。
quietHours：処理が停止している時間設定が原因で、プロファイルが破棄されましたforcedDiscardDueToQuietHours：処理の少ない時間帯に保持されたプロファイルのガードレール制限に達したので、プロファイルが強制的に破棄されました
特定のジャーニーの各ノードで一定時間に発生したエラー数
このクエリは、ジャーニーの各ノードでエラーが発生した個別のプロファイルを、ノード名ごとにグループ化してカウントします。これには、すべてのタイプのアクション実行エラーと取得エラーが含まれます。
データレイクのクエリ
| code language-sql |
|---|
|
特定の時間枠に特定のジャーニーから破棄されたイベントの数
このクエリは、ジャーニーから破棄されたイベントの合計数をカウントします。セグメントエクスポートジョブエラー、Dispatcher による破棄、状態マシンによる破棄など、様々な破棄イベントコードに対してフィルタリングします。
データレイクのクエリ
| code language-sql |
|---|
|
特定の時間枠での特定ジャーニーにおける特定プロファイルへの影響
このクエリは、指定された時間内の指定されたプロファイルとジャーニーのすべてのステップイベントとサービスイベントを時系列で返します。
データレイクのクエリ
| code language-sql |
|---|
|
2 つのノード間の経過時間
これらのクエリは、例えば、待機アクティビティに費やされる時間の見積もりに使用できます。これにより、待機アクティビティを確実に正しく設定できます。
データレイクのクエリ
| code language-sql |
|---|
|
データレイクのクエリ
| code language-sql |
|---|
|
serviceEvent の詳細を確認する方法
ジャーニーステップイベントデータセットには、すべての stepEvents と serviceEvents が含まれています。stepEvents は、ジャーニー内のプロファイルのアクティビティ（イベントやアクションなど）に関連するので、レポーティングに使用されます。serviceEvents は同じデータセットに保存され、デバッグ目的（エクスペリエンスイベント破棄の理由など）での追加情報を示します。
serviceEvent の詳細を確認するクエリの例を次に示します。
データレイクのクエリ
| code language-sql |
|---|
|
メッセージ／アクションエラー message-action-errors
| accordion | ||||
|---|---|---|---|---|
| ジャーニーで発生した各エラーのリスト | ||||
|
このクエリを使用すると、メッセージ／アクションの実行中にジャーニーで発生した各エラーをリストできます。 データレイクのクエリ
例
このクエリは、ジャーニーでのアクションの実行中に発生した様々なエラーとその発生回数を返します。 |
プロファイルベースのクエリ profile-based-queries
プロファイルが特定のジャーニーにエントリしたかどうかの確認
このクエリは、特定のプロファイルとジャーニーの組み合わせに関連付けられたイベントをカウントすることで、特定のプロファイルがジャーニーにエントリしたかどうかを確認します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
結果は 0 より大きい値になります。このクエリは、プロファイルがジャーニーにエントリした正確な回数を返します。
プロファイルが特定のメッセージを送信されたかどうかの確認
方法 1：メッセージの名前がジャーニー内で一意でない場合（複数の場所で使用される場合）。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
結果は 0 より大きい値になります。このクエリは、メッセージアクションがジャーニー側で正常に実行されたかどうかのみを示します。
方法 2：メッセージの名前がジャーニー内で一意の場合。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、すべてのメッセージのリストと、選択したプロファイルに対してそれらのメッセージが呼び出された回数を返します。
過去 30 日間にプロファイルが受け取ったすべてのメッセージの検索
このクエリは、過去 30 日以内に特定のプロファイルに対して正常に実行されたすべてのメッセージアクションを、メッセージ名ごとにグループ化して取得します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、すべてのメッセージのリストと、選択したプロファイルに対してそれらのメッセージが呼び出された回数を返します。
過去 30 日間にプロファイルがエントリしたすべてのジャーニーの検索
このクエリは、特定のプロファイルが過去 30 日以内ににエントリしたすべてのジャーニーと、各ジャーニーのエントリ数を返します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、すべてのジャーニー名のリストと、クエリされたプロファイルがジャーニーにエントリした回数を返します。
1 日あたりのジャーニーの対象となったプロファイルの数
このクエリは、指定された期間にジャーニーにエントリした個別のプロファイルの数の日別の分類を提供します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、指定した期間に 1 日ごとにジャーニーにエントリしたプロファイルの数を返します。プロファイルが別の ID を使用してエントリした場合は、2 回カウントされます。再エントリを有効にすると、別の日にジャーニーに再エントリした場合、プロファイル数が複数日にわたって重複する場合があります。
詳しくは、journey_step_events で破棄されたイベントタイプのトラブルシューティングを参照してください。
「オーディエンスを読み取り」に関連するクエリ read-segment-queries
オーディエンスの書き出しジョブの終了に要した時間
このクエリは、ジョブがキューに追加されたタイミングとジョブが完了したタイミングの間の時間差を検出して、オーディエンスエクスポートジョブの期間を計算します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリは、オーディエンスエクスポートジョブがキューに追加された時刻と最終的に終了した時刻との時間差を分単位で返します。
重複が原因でジャーニーによって破棄されたプロファイルの数
このクエリは、オーディエンスを読み取りアクティビティ中にインスタンス重複エラーにより破棄された個別のプロファイルの数をカウントします。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリは、重複していたことが原因でジャーニーによって破棄された、すべてのプロファイル ID を返します。
無効な名前空間が原因でジャーニーによって破棄されたプロファイルの数
このクエリは、無効な名前空間があったか、必要な名前空間の ID が欠落していたという理由により破棄されたプロファイルの数を返します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリは、プロファイル ID に無効な名前空間が存在する、もしくはその名前空間の ID がないという理由でジャーニーによって破棄された、すべてのプロファイル ID を返します。
ID マップがないという理由でジャーニーによって破棄されたプロファイルの数
このクエリは、ジャーニーの実行に必要な ID マップが欠落していたという理由により破棄されたプロファイルをカウントします。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリは、ID マップが見つからないという理由でジャーニーによって破棄された、すべてのプロファイル ID を返します。
ジャーニーがテストノードにあり、プロファイルがテストプロファイルでなかったという理由で、ジャーニーによって破棄されたプロファイルの数
このクエリは、ジャーニーがテストモードで実行されていたが、プロファイルの testProfile 属性が true に設定されていなかったという理由により破棄されたプロファイルを特定します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリは、テストモードで書き出しジョブが実行されたが、プロファイルの testProfile 属性が true に設定されていなかったという理由により、ジャーニーによって破棄されたすべてのプロファイル ID を返します。
内部エラーが理由でジャーニーによって破棄されたプロファイルの数
このクエリは、ジャーニーの実行中に内部システムエラーにより破棄されたプロファイルの数を返します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
クエリは、一部の内部エラーが理由でジャーニーによって破棄されたすべてのプロファイル ID を返します。
特定のジャーニーバージョンでの「オーディエンスを読み取り」の概要
このクエリは、オーディエンスエクスポートプロセスのすべてのステージに対するセグメントエクスポートジョブの詳細、イベントコード、ステータス、プロファイル数など、オーディエンスを読み取りアクティビティの包括的な概要を提供します。
データレイクのクエリ
| code language-sql |
|---|
|
指定されたジャーニーバージョンに関連するすべてのサービスイベントを返します。次の一連の操作に従うこともできます。
- トピック作成
- エクスポートジョブの作成
- エクスポートジョブの終了（エクスポートされたプロファイルの指標を含む）
- セカンダリ処理の終了
また、次のような問題も検出できます。
- トピックまたはエクスポートジョブ作成時のエラー（オーディエンスのエクスポート API 呼び出しのタイムアウトを含む）
- 停止する可能性があるエクスポートジョブ（特定のジャーニーバージョンで、エクスポートジョブの終了に関するイベントがない場合）
- セカンダリの問題（エクスポートジョブ終了イベントを受け取ったが、セカンダリ処理終了イベントを受け取っていない場合）
重要事項：このクエリでイベントが返されない場合、次のいずれかの理由が原因である可能性があります。
- ジャーニーのバージョンがスケジュールに到達していない
- ジャーニーバージョンでオーケストレーターを呼び出して書き出しジョブをトリガーすると想定されている場合、アップストリームフローで問題（ジャーニーのデプロイメントの問題、ビジネスイベントの問題、スケジューラーに関する問題）が発生します。
特定のジャーニーバージョンでの「オーディエンスを読み取り」エラーの取得
このクエリは、トピック作成エラー、API 呼び出しエラー、タイムアウト、失敗したエクスポートジョブなど、オーディエンスを読み取りエラーにに関連する特定のエラーイベントコードをフィルタリングします。
データレイクのクエリ
| code language-sql |
|---|
|
エクスポートジョブの処理ステータスを取得
このクエリは、オーディエンスエクスポートジョブの処理ステータスを取得し、プロファイルエクスポート指標と共にジョブが成功したか失敗したかを示します。
データレイクのクエリ
| code language-sql |
|---|
|
レコードが返されない場合は、次のいずれかを意味します。
- トピックまたはエクスポートジョブの作成中にエラーが発生しました
- エクスポートジョブがまだ実行中です
エクスポートされたプロファイルに関する指標の取得（各エクスポートジョブの破棄およびエクスポートしジョブ指標を含む）
このクエリは、破棄されたプロファイル数と書き出しジョブ指標を組み合わせて、個々のエクスポートジョブのオーディエンス書き出しパフォーマンスの完全なビューを提供します。
データレイクのクエリ
| code language-sql |
|---|
|
すべてのエクスポートジョブに関する集計指標の取得（オーディエンスの書き出しジョブと破棄）
このクエリは、特定のジャーニーバージョンのすべての書き出しジョブをまたいだ全体的な指標を集計します。これは、繰り返しジャーニーや、トピックの再利用を含むビジネスイベントによってトリガーされるジャーニーに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
このクエリは前のクエリとは異なります。
実行可能なジョブに関係なく（繰り返しジャーニーの場合、トピックの再利用をトリガーしたビジネスイベントなど）、特定のジャーニーバージョンの全体的な指標を返します。
オーディエンスの選定に関連するクエリ segment-qualification-queries
設定されたオーディエンスとは異なるオーディエンス適合が原因で破棄されたプロファイル
このクエリは、オーディエンス適合ステータスがジャーニーのオーディエンスの選定の設定と一致しなかった理由により破棄されたプロファイルを特定します（例: 「エントリ」に設定されているが、プロファイルは「退出済み」）。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、間違ったオーディエンス適合が原因でジャーニーバージョンによって破棄されたすべてのプロファイル ID を返します。
特定のプロファイルについて他の理由で破棄されたオーディエンスの選定イベント
このクエリは、内部サービスエラーにより、特定のプロファイルに対して破棄されたすべてのオーディエンスの選定イベントまたは外部イベントを取得します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、あるプロファイルについてその他の理由で破棄されたすべてのイベント（外部イベント／オーディエンスの選定イベント）を返します。
イベントベースのクエリ event-based-queries
ジャーニーがビジネスイベントを受け取ったかどうかを確認する
このクエリは、指定された時間枠内に、日付別にグループ化されたビジネスイベントがジャーニーで受信された回数をカウントします。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
関連するジャーニーが見つからなかったことが理由でプロファイルの外部イベントが破棄されたかどうかの確認
このクエリは、特定のプロファイルの外部イベントを受信するように設定されたアクティブなジャーニーまたは一致するジャーニーがなかったという理由により、そのイベントが破棄されたタイミングを特定します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
詳しくは、journey_step_events で破棄されたイベントタイプのトラブルシューティングを参照してください。
その他の理由でプロファイルの外部イベントが破棄されたかどうかの確認
このクエリは、イベント ID とエラーコードと共に、内部サービスエラーにより、特定のプロファイルに対して破棄された外部イベントを取得します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
詳しくは、journey_step_events で破棄されたイベントタイプのトラブルシューティングを参照してください。
errorCode で stateMachine によって破棄されたすべてのイベント数の確認
このクエリは、ジャーニーの状態マシンにより破棄されたすべてのイベントをエラーコード別に集計し、破棄の最も一般的な理由を特定するのに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
詳しくは、journey_step_events で破棄されたイベントタイプのトラブルシューティングを参照してください。
再エントリが許可されなかったことが理由で破棄されたすべてのイベントの確認
このクエリは、ジャーニー設定で再エントリが許可されていない際に、プロファイルがジャーニーに再エントリしようとしたという理由により破棄されたすべてのイベントを特定します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
詳しくは、journey_step_events で破棄されたイベントタイプのトラブルシューティングを参照してください。
一般的なジャーニーベースのクエリ journey-based-queries
日別のアクティブなジャーニーの数
このクエリは、アクティビティがあった一意のジャーニーバージョンの日別の数を返すので、ジャーニー実行パターンの推移を理解するのに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
このクエリは、指定した期間に 1 日にトリガーされた一意のジャーニーの数を返します。1 つのジャーニーが複数日でトリガーされる場合は、1 日につき 1 回とカウントされます。
ジャーニーインスタンスに対するクエリ journey-instances-queries
特定の時間に特定の状態となっているプロファイルの数
このクエリは、共通テーブル式（CTE）を使用して、ノードを通過したがまだ次のノードに進んでいないプロファイルを見つけることで、ジャーニーの特定のノードで現在待機しているプロファイルを特定します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間にジャーニーから離脱したプロファイルの数
このクエリは、完了、エラー、タイムアウト、キャップエラーによる終了を含む、指定された期間中に退出したジャーニーインスタンスをカウントします。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間にジャーニーから離脱したプロファイルの数（ノード／ステータスも指定）
このクエリは、ジャーニーの退出の詳細な分類を提供し、退出したインスタンスごとにノード名と退出ステータスを表示して、プロファイルがジャーニーを退出した場所と理由を特定するのに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
カスタムアクションのパフォーマンス指標に関連するクエリ query-custom-action
特定の期間での各エンドポイントの 1 秒あたりの成功した呼び出し、エラー、リクエストの合計数
このクエリは、カスタム HTTP アクションのパフォーマンス指標を提供します。これには、合計呼び出し数、成功した呼び出し数、タイプ別のエラー数（4xx、5xx、タイムアウト、キャッピング）、各エンドポイントの 1 秒あたりのリクエストのスループットが含まれます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間での各エンドポイントの成功した呼び出し、エラー、スループットの時系列
このクエリは、前のクエリと同じパフォーマンス指標を提供しますが、時系列として整理され、エンドポイントのパフォーマンスが分単位の精度で時間の経過と共にどのように変化するかを示します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間での各エンドポイントの 50 パーセンタイル、95 パーセンタイル、99 パーセンタイル、99.9 パーセンタイルでの応答待ち時間
このクエリは、カスタムアクションエンドポイントの応答時間のパーセンタイルを計算し、待ち時間の配分を理解し、様々なパーセンタイルしきい値でのパフォーマンスの異常値を特定するのに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間での各エンドポイントの応答待ち時間パーセンタイルの時系列
このクエリは、時系列として整理された待ち時間パーセンタイルを提供するので、エンドポイントの応答時間が様々なパーセンタイルレベルで時間の経過と共にどのように変化するかを追跡できます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間でのスロットルされたエンドポイントの 50 パーセンタイルおよび 95 パーセンタイルでのキュー内の待ち時間
このクエリは、スロットルされたエンドポイントのキューの待ち時間を分析し、50 パーセンタイルと 95 パーセンタイルの待ち時間を表示して、スロットルがカスタムアクションに与える影響を理解するのに役立ちます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
スロットルされた各エンドポイントのキュー待ち時間パーセンタイルの時系列
このクエリは、キューの待ち時間パーセンタイルを時系列で提供し、スロットルが各エンドポイントの待ち時間に時間の経過と共にどのように影響するかを監視できます。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
特定の期間での特定のエンドポイントのタイプおよびコード別のエラー数
このクエリは、再試行に関する情報を含む、エラータイプとエラーコード別にグループ化された、特定のエンドポイントのエラーの詳細な分類を提供します。
データレイクのクエリ
| code language-sql |
|---|
|
例
| code language-sql |
|---|
|
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76