Geneste gegevensstructuren samenvoegen voor gebruik met BI-gereedschappen van derden

Adobe Experience Platform Query Service ondersteunt de instelling FLATTEN wanneer u verbinding maakt met een database via externe BI-hulpprogramma's. Met deze functie worden geneste gegevensstructuren in BI-tools van derden afgevlakt om de bruikbaarheid ervan te verbeteren en de vereiste werklast voor het ophalen, analyseren, transformeren en rapporteren van gegevens te verminderen.

Veel BI-gereedschappen, zoals Tableau en Power BI , bieden geen native ondersteuning voor geneste gegevensstructuren. Met de instelling FLATTEN hoeft u geen SQL-weergaven boven op uw gegevens te maken om een platte versie te leveren of kunt u via Query Service CTAS - of INSERT INTO -taken uw gegevenssets dupliceren naar platte versies wanneer u ad-hocschema's gebruikt.

Met de instelling FLATTEN wordt de structuur van elk bladveld naar de hoofdmap van de tabel verplaatst en wordt het veld een naam na de oorspronkelijke naamruimte gegeven. Hierdoor kunt u puntnotatie gebruiken om een veld aan te passen aan het XDM-pad (Experience Data Model), terwijl de context van het veld behouden blijft.

Vereisten

Voor het gebruik van de instelling FLATTEN is een goed begrip van de volgende componenten van Adobe Experience Platform vereist:

Verbinding maken met een database met behulp van de FLATTEN-instelling connect-with-flatten

Met de instelling FLATTEN voegt u geneste gegevensstructuren samen tot afzonderlijke kolommen, waarbij de kenmerknaam de kolomnaam wordt die de rijwaarden bevat. Als u werkt met gegevens in BI-gereedschappen die geen ondersteuning bieden voor geneste gegevensstructuren, verbetert deze instelling de bruikbaarheid van ad-hocschema's en vermindert de benodigde werklast.

Wanneer u verbinding maakt met de Query-service met een door u gekozen externe client, voegt u de instelling FLATTEN toe aan de databasenaam. Voor informatie over hoe te om een specifiek hulpmiddel van BI aan te sluiten, te zien gelieve zijn respectieve documentatie in cliënten aan het overzicht van de Dienst van de Vraagverbinden. De verbindingstekenreeks moet het volgende bevatten:

De invoer moet de volgende indeling hebben:

{sandbox_name}:{all/ID/database_name}?FLATTEN

Een voorbeeld van een verbindingstekenreeks kan er als volgt uitzien:

prod:all?FLATTEN

Voorbeeld example

In het voorbeeldschema dat in deze handleiding wordt gebruikt, wordt de standaardveldgroep Commerce Details gebruikt, die de commerce -objectstructuur en de productListItems -array gebruikt. Zie de documentatie XDM voor meer informatie over de Commerce Details gebiedsgroep. In de onderstaande afbeelding ziet u een weergave van de schemastructuur.

Als uw hulpmiddel van BI geen genestelde gegevensstructuren steunt, kan het moeilijk zijn om van genestelde gebieden van verwijzingen te voorzien als zij geserialiseerde waarden (zoals commerce en productListItems in het voorbeeldschema) bevatten. Deze waarden kunnen verschijnen als delen van één gecodeerd commerce tekenreeksveld en zijn realistisch gezien niet onbruikbaar.

De volgende waarden vertegenwoordigen commerce.order.priceTotal (3018.0), commerce.order.purchaseID (c9b5aff9-25de-450b-98f4-4484a2170180) en commerce.purchases.value (1.0) in slecht opgemaakte geneste velden.

("(3018.0,c9b5aff9-25de-450b-98f4-4484a2170180)","(1.0)")

Met de instelling FLATTEN hebt u toegang tot afzonderlijke velden in uw schema of tot hele secties van de geneste gegevensstructuur met behulp van puntnotatie en de oorspronkelijke padnaam. Hieronder ziet u een voorbeeld van deze notatie waarbij de veldgroep commerce wordt gebruikt.

commerce.order.priceTotal
commerce.order.purchaseID
commerce.purchases.value

De instelling FLATTEN heeft bepaalde beperkingen wanneer u werkt met andere gegevensstructuren. De volledige details worden verstrekt in de sectie van beperkingen.

Aanhalingstekens gebruiken voor velden in query's quotation-marks

De samengevoegde hoofdvelden gebruiken nu puntnotatie om hun XDM-paden aan te passen. Wanneer de velden in een query worden gebruikt, moeten deze tussen aanhalingstekens (" ") staan.

In het onderstaande SQL-voorbeeld wordt de oorspronkelijke status van de geneste query weergegeven:

SELECT YEAR(timestamp) AS year,
       SUM(commerce.order.priceTotal) AS revenue
FROM purchase_events_dataset
WHERE commerce.purchases.value > 0
GROUP BY 1;

Wanneer u de samengevoegde gegevensvelden gebruikt, wordt de query geschreven met behulp van puntnotatie en ingesloten door aanhalingstekens, zoals hieronder wordt getoond:

SELECT YEAR(timestamp) AS year,
       SUM("commerce.order.priceTotal") AS revenue
FROM purchase_events_dataset
WHERE "commerce.purchases.value" > 0
GROUP BY 1;

Beperkingen limitations

Met de instelling FLATTEN worden momenteel de volgende gegevensstructuren niet samengevoegd:

Om zowel de Kaart als de beperkingen van de Serie op te lossen moet u de hulpmiddelen gebruiken BBI ruw SQL het uitgeven zoals de Geavanceerde Opties -> SQL Verklaring in Power BI.

BI-gereedschappen, zoals onbewerkte SQL-bewerkingen, zijn nodig om zowel de map- als arraybeperkingen op te lossen. Zie de gids op hoe te gebruik Power BI geavanceerde opties om een douaneSQL vraagin de SQL verklaringssectie in te gaan.

Volgende stappen

In dit document wordt beschreven hoe u geneste gegevensstructuren kunt afvlakken voor gebruik met externe BI-gereedschappen. Als u nog niet uw cliënt hebt verbonden, zie het overzicht van de cliëntverbindingvoor een lijst van gesteunde derdecliënten.