クエリの例 query-examples
この節では、データレイクのジャーニーステップイベントに関するクエリを実行する際によく使用される例をいくつか示します。
クエリで使用するフィールドに、対応するスキーマに関連する値があることを確認します。
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 |
|---|
|
特定の時間枠に特定のジャーニーから破棄されたイベントの数
このクエリは、ジャーニーから破棄されたイベントの合計数をカウントします。 セグメントの書き出しジョブエラー、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
日別のアクティブなジャーニーの数
このクエリは、アクティビティがあった一意のジャーニーバージョンの 1 日あたりの数を返し、ジャーニーの実行パターンの推移を理解するのに役立ちます。
データレイクのクエリ
| 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、タイムアウト、capped）、および各エンドポイントの 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