Beispiele für Abfragen query-examples
In diesem Abschnitt werden einige häufig verwendete Beispiele für die Abfrage von Journey-Schrittereignissen im Data Lake aufgeführt.
Stellen Sie sicher, dass die in Ihren Abfragen verwendeten Felder im entsprechenden Schema über zugeordnete Werte verfügen.
- ID: eindeutig für alle Schrittereignis-Einträge. Zwei verschiedene Schrittereignisse können nicht dieselbe ID aufweisen.
- instanceID: instanceID ist für alle Schrittereignisse identisch, die einem Profil innerhalb einer Journey-Ausführung zugeordnet sind. Wenn ein Profil die Journey erneut aufruft, wird eine andere instanceID verwendet. Diese neue instanceID ist für alle Schrittereignisse der wieder aufgerufenen Instanz gleich (von Anfang bis Ende).
- profileID: die Identität des Profils, die dem Namespace der Journey entspricht.
| note note |
|---|
| NOTE |
| Zur Fehlerbehebung empfehlen wir bei der Abfrage von Journeys die Verwendung von journeyVersionID anstelle von journeyVersionName. Weitere Informationen über die Attribute von Journey-Eigenschaften finden Sie in diesem Abschnitt. |
Grundlegende Anwendungsfälle/allgemeine Abfragen common-queries
Diese Abfrage gibt die Anzahl eindeutigen Profile an, die im angegebenen Zeitraum in die Journey eingetreten sind.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Erfahren Sie, wie Sie Fehler bei verworfenen Ereignistypen in journey_step_events beheben.
Diese Abfrage gibt die Informationen zum zurückgewiesenen Regelsatz und zur Regel zurück, wenn ein Profil aufgrund von Begrenzungs- oder Eignungsregeln nicht auf eine Journey zugreifen kann.
Beispiel
| code language-sql |
|---|
|
Diese Abfrage zählt die unterschiedlichen Profile, bei denen Fehler an jedem Knoten einer Journey aufgetreten sind, gruppiert nach Knotennamen. Es enthält alle Arten von Aktionsausführungsfehlern und Abruffehlern.
Data Lake-Abfrage
| code language-sql |
|---|
|
Diese Abfrage zählt die Gesamtzahl der Ereignisse, die von einer Journey verworfen wurden. Er filtert nach verschiedenen Verwerfen-Ereignis-Codes, einschließlich Segmentexportvorgangsfehlern, Dispatcher-Verwerfen und Status-Computer-Verwerfen.
Data Lake-Abfrage
| code language-sql |
|---|
|
Diese Abfrage gibt alle Schrittereignisse und Service-Ereignisse für das angegebene Profil und die Journey für die angegebene Uhrzeit in chronologischer Reihenfolge zurück.
Data Lake-Abfrage
| code language-sql |
|---|
|
Diese Abfragen können beispielsweise verwendet werden, um die mit einer Warteaktivität verbrachte Zeit zu schätzen. Dadurch können Sie sicherstellen, dass die Warteaktivität korrekt konfiguriert ist.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Data-Lake-Abfrage
| code language-sql |
|---|
|
Der Journey-Schritt-Ereignis-Datensatz enthält alle stepEvents und serviceEvents. stepEvents werden in Berichten verwendet, denn sie beziehen sich auf Aktivitäten (Ereignisse, Aktionen usw.) von Profilen in einer Journey. serviceEvents werden im selben Datensatz gespeichert und geben zusätzliche Informationen zu Debugging-Zwecken an, z. B. den Grund für die Verwerfung eines Erlebnisereignisses.
Im Folgenden finden Sie ein Beispiel für eine Abfrage, um die Details eines serviceEvents zu überprüfen:
Data-Lake-Abfrage
| code language-sql |
|---|
|
Nachrichten-/Aktionsfehler message-action-errors
| accordion | ||||
|---|---|---|---|---|
| Liste aller in Journeys aufgetretenen Fehler | ||||
|
Mithilfe dieser Abfrage können Sie jeden in Journeys aufgetretenen Fehler beim Ausführen einer Nachricht/Aktion auflisten. Data-Lake-Abfrage
Beispiel
Diese Abfrage gibt alle Fehler zurück, die beim Ausführen einer Aktion in einer Journey aufgetreten sind, zusammen mit der Anzahl der aufgetretenen Fehler. |
Profilbasierte Abfragen profile-based-queries
Diese Abfrage prüft, ob ein bestimmtes Profil in eine Journey eingetreten ist, indem die mit dieser Journey- und Profilkombination verknüpften Ereignisse gezählt werden.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Das Ergebnis sollte größer als 0 sein. Diese Abfrage gibt die genaue Anzahl der Eintritte eines Profils in eine Journey zurück.
Methode 1: Wenn der Name Ihrer Nachricht in der Journey nicht eindeutig ist (er wird an mehreren Stellen verwendet).
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Das Ergebnis sollte größer als 0 sein. Diese Abfrage zeigt nur an, ob die Nachrichtenaktion auf der Journey-Seite erfolgreich ausgeführt wurde.
Methode 2: Wenn der Name Ihrer Nachricht in der Journey eindeutig ist.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt die Liste aller Nachrichten zusammen mit der Anzahl der für das ausgewählte Profil aufgerufenen Nachrichten zurück.
Diese Abfrage ruft alle innerhalb der letzten 30 Tage erfolgreich ausgeführten Nachrichtenaktionen für ein bestimmtes Profil ab, gruppiert nach Nachrichtenname.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt die Liste aller Nachrichten zusammen mit der Anzahl der für das ausgewählte Profil aufgerufenen Nachrichten zurück.
Diese Abfrage gibt alle Journey zurück, in die ein bestimmtes Profil in den letzten 30 Tagen eingetreten ist, sowie die Anzahl der Einträge für jede Journey.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt die Liste aller Journey-Namen sowie die Anzahl der Eintritte des abgefragten Profils in die Journey zurück.
Diese Abfrage liefert eine tägliche Aufschlüsselung der Anzahl der unterschiedlichen Profile, die in einem bestimmten Zeitraum auf eine Journey zugegriffen haben.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt für den definierten Zeitraum die Anzahl der Profile zurück, die täglich in die Journey eingetreten sind. Wenn ein Profil über mehrere Identitäten eingetreten ist, wird es zweimal gezählt. Wenn der erneute Eintritt aktiviert ist, kann die Anzahl der Profile über unterschiedliche Tage hinweg mehrfach gezählt werden, wenn ein Profil an einem anderen Tag erneut in die Journey eingetreten ist.
Erfahren Sie, wie Sie Fehler bei verworfenen Ereignistypen in journey_step_events beheben.
Abfragen im Zusammenhang mit „Zielgruppe lesen“ read-segment-queries
Diese Abfrage berechnet die Dauer eines Zielgruppenexportvorgangs, indem sie die Zeitdifferenz zwischen dem Zeitpunkt ermittelt, zu dem der Auftrag in die Warteschlange gestellt wurde, und dem Zeitpunkt, zu dem er abgeschlossen wurde.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt die Zeitdifferenz in Minuten zurück, die zwischen dem Zeitpunkt liegt, zu dem der Zielgruppenexportauftrag in die Warteschlange gestellt wurde, und dem Zeitpunkt, zu dem er beendet wurde.
Diese Abfrage zählt die Anzahl der unterschiedlichen Profile, die aufgrund von Fehlern bei der Instanzduplizierung während der Aktivität „Zielgruppe lesen“ verworfen wurden.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt alle Profil-IDs zurück, die von der Journey verworfen wurden, da es sich um Duplikate handelte.
Diese Abfrage gibt die Anzahl der Profile zurück, die verworfen wurden, weil sie einen ungültigen Namespace hatten oder eine fehlende Identität für den erforderlichen Namespace hatten.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt alle Profil-IDs zurück, die von der Journey verworfen wurden, da sie einen ungültigen Namespace oder keine Kennung für diesen Namespace hatten.
Diese Abfrage zählt die Profile, die verworfen wurden, weil ihnen eine für die Journey-Ausführung erforderliche Identitätszuordnung fehlte.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt alle Profil-IDs zurück, die von der Journey verworfen wurden, da die Identitätszuordnung fehlte.
Diese Abfrage identifiziert Profile, die verworfen wurden, als die Journey im Testmodus ausgeführt wurde, für das Profil jedoch nicht das Attribut testProfile auf „true“ festgelegt war.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt alle Profil-IDs zurück, die von der Journey verworfen wurden, da der Exportvorgang im Testmodus ausgeführt wurde, das Attribut testProfile des Profils jedoch nicht auf „true“ gesetzt war.
Diese Abfrage gibt die Anzahl der Profile zurück, die aufgrund interner Systemfehler während der Journey-Ausführung verworfen wurden.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt alle Profil-IDs zurück, die von der Journey aufgrund eines internen Fehlers verworfen wurden.
Diese Abfrage bietet einen umfassenden Überblick über die Aktivität „Zielgruppe lesen“, einschließlich Details zum Segmentexportvorgang, Ereignis-Codes, Status und Profilanzahl für alle Phasen des Zielgruppenexportvorgangs.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Es werden alle Service-Ereignisse im Zusammenhang mit der angegebenen Journey-Version zurückgegeben. Dabei kann auch die Abfolge der Vorgänge nachvollzogen werden:
- Erstellung des Themas
- Erstellung von Exportaufträgen
- Beendigung der Exportaufträge (mit Metriken zu exportierten Profilen)
- Abbruch der Worker-Verarbeitung
Zusätzlich können Probleme identifiziert werden wie z. B.:
- Fehler bei der Erstellung des Themas oder Exportauftrags (einschließlich Zeitüberschreitungen bei API-Aufrufen zum Zielgruppenexport)
- Blockierte Exportaufträge (wenn für eine bestimmte Journey-Version kein Ereignis zur Beendigung des Exportauftrags vorhanden ist)
- Worker-Probleme, wenn ein Beendigungsereignis zum Exportauftrag, aber kein Beendigungsereignis zur Worker-Verarbeitung empfangen wurde.
WICHTIG: Wenn von dieser Abfrage kein Ereignis zurückgegeben wird, kann dies einen der folgenden Gründe haben:
- Die Journey-Version hat die Planung nicht erreicht.
- Wenn für die Journey-Version der Trigger des Exportvorgangs durch Aufruf des Orchestrierers angenommen wird, ist im Upstream-Fluss ein Fehler aufgetreten: Problem bei der Journey-Bereitstellung, Geschäftsereignis oder Problem mit der Planung.
Diese Abfrage filtert nach bestimmten Fehler-Ereigniscodes im Zusammenhang mit Fehlern beim Lesen von Zielgruppen, z. B. Fehler bei der Themenerstellung, API-Aufruffehler, Zeitüberschreitungen und fehlgeschlagene Exportvorgänge.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Diese Abfrage ruft den Verarbeitungsstatus von Zielgruppenexportvorgängen ab und zeigt an, ob sie erfolgreich waren oder fehlgeschlagen sind, zusammen mit Profilexportmetriken.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Wenn kein Eintrag zurückgegeben wird, bedeutet dies, dass
- Bei der Erstellung des Themas oder des Exportvorgangs ist ein Fehler aufgetreten
- der Exportauftrag noch ausgeführt wird
Diese Abfrage kombiniert die Anzahl verworfener Profile mit den Metriken des Exportvorgangs, um eine vollständige Ansicht der Leistung des Zielgruppenexports für jeden einzelnen Exportvorgang zu bieten.
Data Lake-Abfrage
| code language-sql |
|---|
|
Diese Abfrage aggregiert allgemeine Metriken für alle Exportvorgänge für eine bestimmte Journey-Version. Dies ist nützlich für wiederkehrende Journey oder Journey, die durch Geschäftsereignisse ausgelöst werden, mit Themenwiederverwendung.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Diese Abfrage unterscheidet sich von der vorherigen.
Es werden die Gesamtmetriken für eine bestimmte Journey-Version zurückgegeben, unabhängig von den Aufträgen, die dafür ausgeführt wurden (bei wiederkehrenden Journeys lösten Geschäftsereignisse diejenigen aus, die eine erneute Verwendung von Themen nutzten).
Abfragen im Zusammenhang mit der Zielgruppen-Qualifizierung segment-qualification-queries
Diese Abfrage identifiziert Profile, die verworfen wurden, weil ihr Zielgruppen-Realisierungsstatus nicht mit der Zielgruppen-Qualifizierungskonfiguration der Journey übereinstimmte (z. B. für „Eintritte“ konfiguriert, aber Profil „beendet„).
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage gibt alle Profil-IDs zurück, die von der Journey-Version aufgrund einer falschen Zielgruppenrealisierung verworfen wurden.
Diese Abfrage ruft alle Zielgruppen-Qualifizierungs- oder externen Ereignisse ab, die für ein bestimmtes Profil aufgrund von internen Service-Fehlern verworfen wurden.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage gibt alle Ereignisse (externe Ereignisse/Zielgruppen-Qualifizierungsereignisse) zurück, die aus einem anderen Grund für ein Profil verworfen wurden.
Ereignisbasierte Abfragen event-based-queries
Diese Abfrage zählt, wie oft ein Geschäftsereignis von einer Journey innerhalb eines bestimmten Zeitraums nach Datum gruppiert empfangen wurde.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage identifiziert, wann ein externes Ereignis für ein bestimmtes Profil verworfen wurde, da keine aktive oder übereinstimmende Journey für den Empfang dieses Ereignisses konfiguriert war.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Erfahren Sie, wie Sie Fehler bei verworfenen Ereignistypen in journey_step_events beheben.
Diese Abfrage ruft externe Ereignisse ab, die für ein bestimmtes Profil aufgrund von internen Service-Fehlern verworfen wurden, sowie die Ereignis-ID und den Fehler-Code.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Erfahren Sie, wie Sie Fehler bei verworfenen Ereignistypen in journey_step_events beheben.
Diese Abfrage aggregiert alle Ereignisse, die vom Journey-Statuscomputer verworfen wurden, gruppiert nach Fehlercode, um die häufigsten Gründe für Verwerfen zu ermitteln.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Erfahren Sie, wie Sie Fehler bei verworfenen Ereignistypen in journey_step_events beheben.
Diese Abfrage identifiziert alle Ereignisse, die verworfen wurden, da ein Profil versucht hat, erneut auf eine Journey zuzugreifen, obwohl der erneute Eintritt in die Journey-Konfiguration nicht zulässig war.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Erfahren Sie, wie Sie Fehler bei verworfenen Ereignistypen in journey_step_events beheben.
Häufige Journey-basierte Abfragen journey-based-queries
Diese Abfrage gibt eine tägliche Anzahl der eindeutigen Journey-Versionen mit Aktivität zurück, sodass Sie die Ausführungsmuster von Journey im Laufe der Zeit besser verstehen können.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Die Abfrage gibt für den definierten Zeitraum die Anzahl der eindeutigen Journeys zurück, die jeden Tag ausgelöst wurden. Eine einzelne Journey, die an mehreren Tagen ausgelöst wird, wird einmal pro Tag gezählt.
Abfragen auf Journey-Instanzen journey-instances-queries
Diese Abfrage verwendet Common Table Expressions (CTEs), um Profile zu identifizieren, die derzeit auf einem bestimmten Knoten in einer Journey warten, indem Profile gefunden werden, die den Knoten passiert haben, aber noch nicht zu den nächsten Knoten gewechselt haben.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage zählt die Journey-Instanzen, die während eines bestimmten Zeitraums beendet wurden, einschließlich der Beendigungen aufgrund von Abschlüssen, Fehlern, Zeitüberschreitungen oder Begrenzungsfehlern.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage bietet eine detaillierte Aufschlüsselung der Journey-Austritte, wobei der Knotenname und der Beendigungsstatus für jede beendete Instanz angezeigt werden, um zu ermitteln, wo und warum Profile die Journey verlassen haben.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Abfragen im Zusammenhang mit Leistungsmetriken für benutzerdefinierte Aktionen query-custom-action
Diese Abfrage liefert Leistungsmetriken für benutzerdefinierte HTTP-Aktionen, einschließlich der Gesamtzahl der Aufrufe, erfolgreicher Aufrufe, Fehlerzählungen nach Typ (4xx, 5xx, Zeitüberschreitungen, begrenzt) und des Durchsatzes in Anfragen pro Sekunde für jeden Endpunkt.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage liefert dieselben Leistungsmetriken wie die vorherige Abfrage, ist jedoch als Zeitreihe organisiert. Sie zeigt auf, wie sich die Endpunktleistung im Zeitverlauf mit der Granularität pro Minute verändert.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage berechnet die Antwortzeit-Perzentile für benutzerdefinierte Aktionsendpunkte, sodass Sie die Latenzverteilung verstehen und Leistungsausreißer mit unterschiedlichen Perzentil-Schwellenwerten identifizieren können.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage liefert Latenzperzentile, die als Zeitreihe organisiert sind. So können Sie verfolgen, wie sich die Endpunkt-Antwortzeiten im Laufe der Zeit auf verschiedenen Perzentilebenen ändern.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage analysiert die Warteschlangenwartezeiten für gedrosselte Endpunkte und zeigt die Wartezeiten im 50. und 95. Perzentil an, damit Sie die Auswirkungen der Drosselung auf Ihre benutzerdefinierten Aktionen besser verstehen können.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage liefert die Wartezeit-Perzentile der Warteschlangen als Zeitreihe, mit der Sie überwachen können, wie sich eine Drosselung im Zeitverlauf auf die Wartezeiten für jeden Endpunkt auswirkt.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|
Diese Abfrage bietet eine detaillierte Aufschlüsselung der Fehler für einen bestimmten Endpunkt, gruppiert nach Fehlertyp und Fehler-Code, einschließlich Informationen zu Wiederholungsversuchen.
Data-Lake-Abfrage
| code language-sql |
|---|
|
Beispiel
| code language-sql |
|---|
|