Profile Query Language (PQL) - Übersicht

Profile Query Language (PQL) ist eine Experience Data Model (XDM-)konforme Abfrage, die die Definition und Ausführung von Segmentierungs-Abfragen für Real-time Customer Profile Daten unterstützt.

Dieser Leitfaden bietet einen allgemeinen Überblick über PQL, der Formatierungsrichtlinien enthält und PQL-Ausdrücke anzeigt.

PQL-Abfrage formatieren

PQL-Abfragen haben folgende Unterschrift:

({INPUT_PARAMETER_1}, {INPUT_PARAMETER_2}, ...) => {RESULT_TYPE}

Der Eingabeparameter kann ein einfacher Primitiv sein, z. B. ein boolescher oder ein String, oder ein komplexerer Typ, z. B. ein Objekt, ein Array oder eine Map.

Es gibt drei verschiedene Möglichkeiten, auf Eingabeparameter im Hauptteil eines PQL-Ausdrucks zu verweisen:

Impliziter Verweis auf den ersten Parameter

Im unten stehenden Beispiel kann, da der erste Parameter immer im Kontext steht, ein Eigenschaftsverweis (homeAddress) direkt darauf angewendet werden.

homeAddress.stateProvince = workAddress.stateProvince

Explizite Bezugnahme auf den ersten Parameter

Im Beispiel unten bezieht sich $1 auf den ersten Parameter. $2 würde daher auf den zweiten Parameter usw. verweisen.

$1.homeAddress.stateProvince = $1.homeAddress.stateProvince

Verwendung benannter Variablen unter Verwendung der Lambda-Notation

Im folgenden Beispiel ist Profile ein Variablenname, der vom Autor der Abfrage ausgewählt werden kann.

(Profile) => Profile.homeAddress.stateProvince = Profile.workAddress.stateProvince

PQL-Literale

PQL unterstützt die folgenden Literaltypen:

Literal Definition Beispiel
Zeichenfolge Ein Datentyp, der aus Zeichen besteht, die von Dubletten-Anführungszeichen umgeben sind. "pizza", "jobs", "antidisestablishmentarianism"
Boolesch Ein Datentyp, der entweder "true"oder "false"ist. true, false
Ganzzahl Ein Datentyp, der eine ganze Zahl darstellt. Es kann positiv, negativ oder null sein. -201, 0, 412
Double Ein Datentyp, der eine beliebige reale Zahl darstellt. Es kann positiv, negativ oder null sein. -51.24, 3.14, 0.6942058
Datum Ein Datentyp, der zum Erstellen von Daten basierend auf den Parametern Jahr, Monat und Tag als Ganzzahl verwendet werden kann. Das Format lautet date(year, month, day) date(2020, 3, 14)
Array Ein Datentyp, der als Gruppe anderer Literalwerte zusammengesetzt ist. Es verwendet eckige Klammern zur Gruppierung und Kommas zur Trennung zwischen verschiedenen Werten.
Hinweis: Sie können nicht direkt auf Eigenschaften von Elementen in einem Array zugreifen. Wenn Sie also auf eine Eigenschaft in einem Array zugreifen müssen, wird select X from array where X.item = ... unterstützt.
PQL behält sich das Wort xEvent zum Verweisen auf eine Reihe von Erlebnis-Ereignissen vor, die mit einem Profil verknüpft sind.
[1, 4, 7], ["US", "CA"]
Relative Zeitreferenzen Reservierte Wörter, die zum Erstellen von Zeitstempeln und Zeitintervallverweisen verwendet werden können.
  • jetzt, heute, gestern, morgen
  • this, last, next
  • before, after, from
  • Millisekunde(n), Sekunde(n), Minute(n), Stunde(n), Tag(e), Woche(n), Monat(n), Jahr(e), Jahrzehnt(e), Jahrhundert/Jahrhunderte, Jahrtausend/Jahrtausend
X.timestamp occurs before today, X.timestamp occurs last month, X.timestamp occurs <= 3 days before now

PQL-Funktionen

In der folgenden Tabelle sind die verschiedenen Kategorien unterstützter PQL-Funktionen aufgeführt, einschließlich Links zu weiteren Dokumentationen.

Kategorie Definition
Boolesch Wird verwendet, um boolesche Algebra in PQL zu implementieren. Weitere Informationen zu diesen Funktionen finden Sie im Dokument boolesche Funktionen.
Vergleich Dient zum Vergleich zwischen verschiedenen PQL-Elementen. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Vergleichsfunktionen.
Array, Liste und Satz Wird für die Interaktion mit Arrays, Listen und Sets verwendet. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Array-, Liste- und Set-Funktionen.
Zuordnung Wird verwendet, um mit Karten zu interagieren. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Kartenfunktionen.
Zeichenfolge Wird verwendet, um mit Zeichenfolgen zu interagieren. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Zeichenfolgen-Funktionen.
Objekt Wird zur Interaktion mit Objekten verwendet. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Objektfunktionen.
Arithmetisch Dient zum Durchführen einer einfachen Arithmetik für PQL-Elemente. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Arithmetik-Funktionen
Aggregation Wird verwendet, um Ergebnisse eines Arrays zu einem einzelnen Ergebnis zu kombinieren. Weitere Informationen zu Aggregationsfunktionen finden Sie im Dokument Aggregationsfunktionen.
Datum und Uhrzeit Wird in Verbindung mit Datums-, Uhrzeit- und Datenzeitobjekten verwendet. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Datums-/Uhrzeitfunktionen.
Filter Dient zum Filtern von Daten in Arrays. Weitere Informationen zu diesen Funktionen finden Sie im Dokument Filterfunktionen.
Logische Quantoren Wird verwendet, um Bedingungen in einem Array zu übernehmen. Weitere Informationen finden Sie im Dokument logische Quantifizierer.
Sonstiges Funktionen, die nicht in eine der oben genannten Kategorien passen, finden Sie im Dokument verschiedene Funktionen.

Nächste Schritte

Nachdem Sie nun gelernt haben, wie Profile Query Language verwendet werden kann, können Sie PQL beim Erstellen und Ändern von Segmenten verwenden. Weitere Informationen zur Segmentierung finden Sie in der Segmentierungsübersicht.

Auf dieser Seite