Geneste gegevensstructuren samenvoegen voor gebruik met BI-gereedschappen van derden

Adobe Experience Platform Query Service ondersteunt de FLATTEN het plaatsen wanneer het verbinden met een gegevensbestand door derdehulpmiddelen van BI. 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 native geen ondersteuning voor geneste gegevensstructuren. De FLATTEN het plaatsen verwijdert de behoefte om SQL meningen bovenop uw gegevens tot stand te brengen om een vlakke versie, of de Dienst van de Vraag te gebruiken CTAS of INSERT INTO taken om uw datasets in vlakke versies te dupliceren wanneer het gebruiken van ad hoc regelingen.

De FLATTEN met deze instelling 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

Met de FLATTEN voor het instellen is een goed begrip van de volgende onderdelen van Adobe Experience Platform vereist:

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

De FLATTEN bij het instellen worden geneste gegevensstructuren afgevlakt in 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 het verbinden met de Dienst van de Vraag met uw gekozen derde cliënt, voeg toe FLATTEN instellen op de databasenaam. Voor informatie over hoe te om een specifiek hulpmiddel van BI aan te sluiten, gelieve zijn respectieve documentatie in te zien Verbind cliënten met het overzicht van de Dienst van de Vraag. 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 gebruikt Commerce Details, die gebruik maakt van de commerce de objectstructuur en de productListItems array. Zie de XDM-documentatie voor meer informatie over de Commerce Details veldgroep. 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 verwijzingen te voorzien genestelde gebieden indien zij geserialiseerde waarden (zoals bevatten commerce en productListItems in het voorbeeldschema). Deze waarden kunnen verschijnen als delen van één gecodeerde waarde 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 geneste velden met een slechte opmaak.

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

Met de opdracht FLATTEN Als u een instelling instelt, kunt u afzonderlijke velden in uw schema of volledige secties van de geneste gegevensstructuur openen met behulp van puntnotatie en de oorspronkelijke padnaam. Een voorbeeld van deze indeling met de commerce de veldgroep wordt hieronder weergegeven.

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

De FLATTEN het plaatsen heeft bepaalde beperkingen wanneer het behandelen van andere gegevensstructuren. De volledige details worden vermeld in het sectie 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

De FLATTEN met deze instelling worden momenteel niet de volgende gegevensstructuren 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 handleiding over hoe u Geavanceerde opties voor Power BI gebruiken om een aangepaste SQL-query in te voeren in de SQL-instructiesectie.

Volgende stappen

In dit document wordt beschreven hoe u geneste gegevensstructuren kunt afvlakken voor gebruik met externe BI-gereedschappen. Als u nog geen verbinding met de client hebt, raadpleegt u het overzicht van de clientverbinding voor een lijst met ondersteunde clients van derden.