Förenkla kapslade datastrukturer för användning med BI-verktyg från tredje part

Adobe Experience Platform Query Service stöder inställningen FLATTEN vid anslutning till en databas via BI-verktyg från tredje part. Den här funktionen förenklar kapslade datastrukturer i BI-verktyg från tredje part för att förbättra deras användbarhet och minska den arbetsbelastning som krävs för att hämta, analysera, omvandla och rapportera data.

Många BI-verktyg som Tableau och Power BI stöder inte kapslade datastrukturer. Inställningen FLATTEN tar bort behovet av att skapa SQL-vyer ovanpå dina data för att tillhandahålla en platt version, eller att använda jobb för frågetjänsten CTAS eller INSERT INTO för att duplicera dina datauppsättningar till platta versioner när du använder ad hoc-scheman.

Inställningen FLATTEN hämtar strukturen för varje bladfält till tabellens rot och namnger fältet efter det ursprungliga namnutrymmet. Detta gör att du kan använda punktnotation för att matcha ett fält med dess XDM-sökväg (Experience Data Model) samtidigt som fältets kontext bevaras.

Förhandskrav

Inställningen FLATTEN kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

  • XDM-system: En översikt på hög nivå över XDM och dess implementering i Experience Platform.

    • Skapa ett ad hoc-schema: Ett XDM-schema med fält som bara namnges av en enda datauppsättning kallas för ett ad hoc-schema. Ad hoc-scheman används i olika arbetsflöden för dataöverföring för Experience Platform och för att skapa vissa typer av källanslutningar.
  • Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda plattformsinstans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.

  • Kapslade datastrukturer: Det här dokumentet innehåller exempel på hur du skapar, bearbetar eller omformar datauppsättningar med komplexa datatyper, inklusive kapslade datastrukturer.

Ansluta till en databas med FLATTEN-inställningen connect-with-flatten

Inställningen FLATTEN förenklar kapslade datastrukturer i separata kolumner där attributnamnet blir det kolumnnamn som innehåller radvärdena. När du arbetar med data i BI-verktyg som inte har stöd för kapslade datastrukturer, förbättrar den här inställningen användbarheten för ad hoc-scheman och minskar den nödvändiga arbetsbelastningen.

När du ansluter till frågetjänsten med den valda tredjepartsklienten lägger du till inställningen FLATTEN i databasnamnet. Mer information om hur du ansluter ett specifikt BI-verktyg finns i respektive dokumentation i anslut klienter till frågetjänstöversikt. Anslutningssträngen ska innehålla:

  • Sandlådenamnet.
  • Ett kolon följt av all eller ett specifikt datauppsättnings-ID, vy-ID eller databasnamn.
  • Ett frågetecken (?) följt av nyckelordet FLATTEN.

Indata ska ha följande format:

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

En exempelanslutningssträng kan se ut så här:

prod:all?FLATTEN

Exempel example

Det exempelschema som används i den här handboken använder standardfältgruppen Commerce Details, som använder objektstrukturen commerce och arrayen productListItems. I XDM-dokumentationen finns mer information om Commerce Details-fältgruppen. En representation av schemastrukturen visas i bilden nedan.

Ett schemadiagram över fältgruppen Commerce Details som innehåller strukturerna och .

Om ditt BI-verktyg inte stöder kapslade datastrukturer kan det vara svårt att referera till kapslade fält om de innehåller serialiserade värden (till exempel commerce och productListItems i exempelschemat). Dessa värden kan förekomma som delar i ett enskilt kodat commerce-strängfält och är inte realistiskt oanvändbara.

Följande värden representerar commerce.order.priceTotal (3018.0), commerce.order.purchaseID (c9b5aff9-25de-450b-98f4-4484a2170180) och commerce.purchases.value(1.0) i dåligt formaterade kapslade fält.

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

Genom att använda inställningen FLATTEN kan du komma åt separata fält i schemat eller hela avsnitt i den kapslade datastrukturen genom att använda punktnotation och deras ursprungliga sökvägsnamn. Ett exempel på det här formatet med fältgruppen commerce visas nedan.

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

Inställningen FLATTEN har vissa begränsningar när det gäller andra datastrukturer. Fullständig information finns i avsnittet begränsningar.

Använd citattecken för fält i frågor quotation-marks

De förenklade rotfälten använder nu punktnotation för att matcha sina XDM-sökvägar. När de används i en fråga måste fälten omges av citattecken (" ").

I SQL-exemplet nedan visas det ursprungliga läget för den kapslade frågan:

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

När du använder de förenklade datafälten skrivs frågan med punktnotation och omsluts av citattecken enligt nedan:

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

Begränsningar limitations

Inställningen FLATTEN förenklar för närvarande inte följande datastrukturer:

Datastruktur
Begränsning
Arrayer
Använd ett explicit arrayindex eller funktionen EXPLODE för att komma åt arrayer.
Kartor
Använd strängnyckeln för att komma åt ett värde under en karta för att komma åt kartor.

Om du vill lösa både mappnings- och matrisbegränsningar måste du använda BI-verktygen för SQL-redigering, som de avancerade alternativen -> SQL-satsen i Power BI.

BI-verktyg som rå SQL-redigering krävs för att lösa både mappnings- och matrisbegränsningar. Se guiden om hur du använder avancerade alternativ för Power BI för att ange en anpassad SQL-fråga i SQL-satsavsnittet.

Nästa steg

I det här dokumentet beskrivs hur du förenklar kapslade datastrukturer för användning med BI-verktyg från tredje part. Om du inte redan har anslutit klienten kan du läsa översikten över klientanslutningen för att få en lista över tredjepartsklienter som stöds.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb