DocumentatieExperience PlatformGids voor Segmentation Service

Profile Query Language (PQL) - overzicht

Last update: Mon Nov 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • User

Profile Query Language (PQL) is een Experience Data Model (XDM) volgzame vraagtaal die wordt ontworpen om de definitie en de uitvoering van segmenteringsvragen voor te steunen Real-Time Customer Profile gegevens.

Deze handleiding biedt een algemeen overzicht van PQL, met opmaakrichtlijnen en voorbeelden van PQL-expressies.

PQL-queryopmaak

PQL-query's hebben de volgende handtekening:

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

De invoerparameter kan een eenvoudige primitieve parameter zijn, zoals een booleaanse tekenreeks of een complexer type, zoals een object, array of kaart.

Er zijn drie verschillende manieren om naar inputparameters binnen het lichaam van een uitdrukking te verwijzen PQL:

Impliciete verwijzing naar de eerste parameter

In het onderstaande voorbeeld, omdat de eerste parameter altijd in context staat, verwijst een eigenschapverwijzing (homeAddress) rechtstreeks naar het programma kunnen worden uitgevoerd.

homeAddress.stateProvince = workAddress.stateProvince

Expliciete verwijzing naar de eerste parameter

In het onderstaande voorbeeld: $1 verwijst naar de eerste parameter. Dientengevolge, $2 verwijst naar de tweede parameter, enz.

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

Gebruik van benoemde variabelen met de lambda-notatie

In het onderstaande voorbeeld: Profile is een veranderlijke naam, die door de vraagauteur kan worden gekozen.

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

PQL-literalen

PQL biedt ondersteuning voor de volgende letterlijke typen:

Letterlijk
Definitie
Voorbeeld
Tekenreeks
Een gegevenstype dat bestaat uit tekens die worden omringd door dubbele aanhalingstekens.
"pizza", "jobs", "antidisestablishmentarianism"
Boolean
Een gegevenstype dat waar of onwaar is.
true, false
Geheel
Een gegevenstype dat een geheel getal vertegenwoordigt. Het kan positief, negatief, of nul zijn.
-201, 0, 412
Dubbel
A data type representing any real number. Het kan positief, negatief, of nul zijn.
-51.24, 3.14, 0.6942058
Datum
Een gegevenstype dat kan worden gebruikt om datums te maken op basis van het jaar, de maand en de dag als parameters van gehele getallen. Het is opgemaakt als date(year, month, day)
date(2020, 3, 14)
Array
Een gegevenstype dat is samengesteld als een groep andere letterlijke waarden. Er worden vierkante haakjes gebruikt om te groeperen en komma's om te scheiden tussen verschillende waarden.
Opmerking: U hebt niet rechtstreeks toegang tot eigenschappen van items binnen een array. Als u dus toegang moet krijgen tot een eigenschap binnen een array, wordt de ondersteunde methode select X from array where X.item = ....
PQL behoudt het woord xEvent om te verwijzen naar een array van ervaringsgebeurtenissen die aan een profiel zijn gekoppeld.
[1, 4, 7], ["US", "CA"]
Relatieve tijdverwijzingen

Gereserveerde woorden die kunnen worden gebruikt om tijdstempel en tijdinterval verwijzingen te vormen.

  • nu, vandaag, gisteren, morgen
  • dit, laatste, volgende
  • voor, na, van
  • millisecond(en), seconde(n), minuut(n), uur, dag(en), week(en), maand(en), jaar(en), decennium(en), eeuw/eeuwen, millennium/millennium
X.timestamp occurs before today, X.timestamp occurs last month, X.timestamp occurs <= 3 days before now

PQL-functies

In de volgende tabel worden de verschillende categorieën ondersteunde PQL-functies beschreven, waaronder koppelingen naar verdere documentatie voor meer informatie.

Categorie
Definitie
Boolean
Wordt gebruikt om booleaanse algebra te implementeren in PQL. Meer informatie over deze functies vindt u in het gedeelte Booleaanse functies, document.
Vergelijking
Wordt gebruikt om verschillende PQL-elementen te vergelijken. Meer informatie over deze functies vindt u in het gedeelte document met vergelijkingsfuncties.
Array, list en set
Wordt gebruikt voor interactie met arrays, lijsten en sets. Meer informatie over deze functies vindt u in het gedeelte array-, list- en set-functies, document.
Kaart
Wordt gebruikt voor interactie met kaarten. Meer informatie over deze functies vindt u in het gedeelte map-functies, document.
Tekenreeks
Wordt gebruikt voor interactie met tekenreeksen. Meer informatie over deze functies vindt u in het gedeelte document met tekenreeksfuncties.
Object
Wordt gebruikt voor interactie met objecten. Meer informatie over deze functies vindt u in het gedeelte document met objectfuncties.
Rekenkundig
Wordt gebruikt voor het uitvoeren van rekenkundige basisbewerkingen op PQL-elementen. Meer informatie over deze functies vindt u in het gedeelte rekenkundige functies, document
Samenvoeging
Wordt gebruikt om resultaten van een array te combineren in een enkel resultaat. Meer informatie over aggregatiefuncties vindt u in de document voor samenvoegingsfuncties.
Datum en tijd
Wordt gebruikt in combinatie met datum-, tijd- en datetime-objecten. Meer informatie over deze functies vindt u in het gedeelte datum-/tijdfunctiedocument.
Filter
Wordt gebruikt om gegevens binnen arrays te filteren. Meer informatie over deze functies vindt u in het gedeelte filterfuncties, document.
Logische kwantoren
Wordt gebruikt om voorwaarden binnen een array te bevestigen. Meer informatie vindt u in de document voor logische kwantoren.
Overige
Functies die niet in een van de bovenstaande categorieën passen, kunt u vinden in het gedeelte document met diverse functies.

Volgende stappen

Nu hebt u geleerd hoe te gebruiken Profile Query Language, kunt u PQL gebruiken wanneer het creëren van en het wijzigen van segmentdefinities. Lees voor meer informatie over segmentatie de segmentatieoverzicht.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871