クエリの例 query-examples
この節では、データレイクのジャーニーステップイベントに関するクエリを実行する際によく使用される例をいくつか示します。
クエリで使用するフィールドに、対応するスキーマに関連する値があることを確認します。
- ID:すべてのステップイベントエントリに対して一意です。2 つの異なるステップイベントに同じ ID を割り当てることはできません。
- instanceID:instanceID は、ジャーニー実行内のプロファイルに関連付けられるすべてのステップイベントで同一です。プロファイルがジャーニーに再度入ると、別の instanceID が使用されます。この新しい instanceID は、再入力されたインスタンスのすべてのステップイベント(開始から終了まで)で同じになります。
- profileID:ジャーニー名前空間に対応したプロファイルの ID です。
note note |
---|
NOTE |
トラブルシューティングの目的では、ジャーニーのクエリ時に journeyVersionName ではなく journeyVersionID を使用することをお勧めします。ジャーニーのプロパティ属性について詳しくは、この節を参照してください。 |
基本的なユースケース/一般的なクエリ common-queries
accordion | ||
---|---|---|
特定の時間枠にジャーニーにエントリしたプロファイルの数 | ||
このクエリでは、指定された時間枠に指定されたジャーニーにエントリした個別のプロファイル数が表示されます。 データレイクのクエリ
|
例
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
データレイクのクエリ
このクエリは、指定された時間内の指定されたプロファイルとジャーニーのすべてのステップイベントとサービスイベントを時系列で返します。
code language-sql |
---|
|
これらのクエリは、例えば、待機アクティビティに費やされる時間の見積もりに使用できます。これにより、待機アクティビティを確実に正しく設定できます。
データレイクのクエリ
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
ジャーニーステップイベントデータセットには、すべての 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 |
---|
|
このクエリは、すべてのメッセージのリストと、選択したプロファイルに対してそれらのメッセージが呼び出された回数を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
このクエリは、すべてのメッセージのリストと、選択したプロファイルに対してそれらのメッセージが呼び出された回数を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
このクエリは、すべてのジャーニー名のリストと、クエリされたプロファイルがジャーニーにエントリした回数を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
このクエリは、指定した期間に 1 日ごとにジャーニーにエントリしたプロファイルの数を返します。プロファイルが別の ID を使用してエントリした場合は、2 回カウントされます。再エントリを有効にすると、別の日にジャーニーに再エントリした場合、プロファイル数が複数日にわたって重複する場合があります。
「オーディエンスを読み取り」に関連するクエリ read-segment-queries
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
クエリは、オーディエンス書き出しジョブがキューに追加された時刻と最終的に終了した時刻との時間差を分単位で返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
クエリは、重複していたことが原因でジャーニーによって破棄された、すべてのプロファイル ID を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
クエリは、プロファイル ID に無効な名前空間が存在する、もしくはその名前空間の ID がないという理由でジャーニーによって破棄された、すべてのプロファイル ID を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
クエリは、ID マップが見つからないという理由でジャーニーによって破棄された、すべてのプロファイル ID を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
クエリは、テストモードでエクスポートジョブが実行されたが、プロファイルの testProfile 属性が true に設定されていなかったという理由により、ジャーニーによって破棄されたすべてのプロファイル ID を返します。
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
クエリは、一部の内部エラーが理由でジャーニーによって破棄されたすべてのプロファイル ID を返します。
データレイクのクエリ
code language-sql |
---|
|
指定されたジャーニーバージョンに関連するすべてのサービスイベントを返します。次の一連の操作に従うこともできます。
- トピック作成
- エクスポートジョブの作成
- エクスポートジョブの終了(エクスポートされたプロファイルの指標を含む)
- セカンダリ処理の終了
また、次のような問題も検出できます。
- トピックまたは書き出しジョブ作成時のエラー(オーディエンスの書き出し 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 |
---|
|
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
一般的なジャーニーベースのクエリ journey-based-queries
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
このクエリは、指定した期間に 1 日にトリガーされた一意のジャーニーの数を返します。1 つのジャーニーが複数日でトリガーされる場合は、1 日につき 1 回とカウントされます。
ジャーニーインスタンスに対するクエリ journey-instances-queries
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|
データレイクのクエリ
code language-sql |
---|
|
例
code language-sql |
---|
|