Query Editor Användargränssnittsguide

Query Editor är ett interaktivt verktyg från Adobe Experience Platform Query Servicesom gör det möjligt att skriva, validera och köra frågor om kundupplevelsedata i Experience Platform användargränssnitt. Query Editor har stöd för utveckling av frågor för analys och datautforskande och gör att du kan köra interaktiva frågor i utvecklingssyfte samt icke-interaktiva frågor för att fylla i datauppsättningar i Experience Platform.

Mer information om begrepp och funktioner i Query Service, se Översikt över frågetjänsten. Mer information om hur du navigerar i användargränssnittet för frågetjänsten på Platform, se Översikt över användargränssnittet i frågetjänsten.

Komma igång

Query Editor erbjuder flexibel körning av frågor genom att ansluta till Query Serviceoch frågor körs bara när den här anslutningen är aktiv.

Ansluter till Query Service

Query Editor tar några sekunder att initiera och ansluta till Query Service när den öppnas. Konsolen talar om när den är ansluten, vilket visas nedan. Om du försöker köra en fråga innan redigeraren har anslutit, fördröjs körningen tills anslutningen är klar.

Frågeredigerarens konsolutdata vid den första anslutningen.

Hur frågor körs från Query Editor

Frågor som körs från Query Editor köra interaktivt. Det innebär att om du stänger webbläsaren eller navigerar bort så avbryts frågan. Detta gäller även för frågor som skapas för att generera datauppsättningar från frågeutdata.

Frågeredigering med Query Editor

Använda Query Editorkan du skriva, köra och spara frågor om kundupplevelsedata. Alla frågor har körts eller sparats i Query Editor är tillgängliga för alla användare i organisationen med tillgång till Query Service.

Komma åt Query Editor

I Experience Platform Gränssnitt, välj Queries i den vänstra navigeringsmenyn för att öppna Query Service arbetsyta. Nästa, välj Create Query längst upp till höger på skärmen för att börja skriva frågor. Den här länken är tillgänglig från någon av sidorna i Query Service arbetsyta.

Översiktsfliken i arbetsytan Frågor med frågan Skapa markerad.

Skriver frågor

Query Editor är organiserat för att göra det så enkelt att skriva frågor som möjligt. Skärmbilden nedan visar hur redigeraren visas i användargränssnittet, med SQL-postfältet och Spela upp markerad.

Frågeredigeraren med SQL-indatafältet och uppspelning markerat.

För att minimera utvecklingstiden rekommenderar vi att du utvecklar dina frågor med begränsningar för antalet rader som returneras. Exempel, SELECT fields FROM table WHERE conditions LIMIT number_of_rows. När du har verifierat att frågan ger det förväntade resultatet tar du bort gränserna och kör frågan med CREATE TABLE tablename AS SELECT för att generera en datauppsättning med utdata.

Skrivverktyg i Query Editor

  • Automatisk syntaxmarkering: Gör det enklare att läsa och ordna SQL.

En SQL-sats i Frågeredigeraren som visar färgmarkering för syntaxen.

  • SQL-nyckelord har slutförts automatiskt: Börja skriva frågan, använd sedan piltangenterna för att navigera till önskad term och trycka på Retur.

Några tecken i SQL med listrutan Komplettera automatiskt som innehåller alternativ från Frågeredigeraren.

  • Tabell och fält har fyllts i automatiskt: Börja skriva det tabellnamn som du vill använda SELECT navigera sedan till tabellen du letar efter med piltangenterna och tryck på Retur. När en tabell är markerad identifieras fält i tabellen automatiskt.

Indata från Frågeredigeraren med förslag på listtabellnamn.

Växla mellan automatisk komplettering av användargränssnittskonfigurationen

The Query Editor föreslår automatiskt potentiella SQL-nyckelord tillsammans med tabell- eller kolumninformation för frågan när du skriver den. Funktionen för automatisk komplettering är aktiverad som standard och kan när som helst inaktiveras eller aktiveras genom att du väljer Syntax auto-complete till höger i Frågeredigeraren.

Konfigurationsinställningen som slutförs automatiskt är per användare och sparas för den användarens efterföljande inloggningar.

Frågeredigeraren med syntaxen auto-complete aktiverad.

Om du inaktiverar den här funktionen hindras flera metadatakommandon från att bearbetas och ger rekommendationer som vanligtvis underlättar för författaren att redigera frågor.

När du använder växlingsknappen för att aktivera funktionen för automatisk komplettering blir förslag på tabell- och kolumnnamn samt SQL-nyckelord tillgängliga efter en kort paus. Ett meddelande om att åtgärden lyckades i konsolen under Frågeredigeraren anger att funktionen är aktiv.

Om du inaktiverar funktionen för automatisk komplettering måste du uppdatera sidan för att funktionen ska börja gälla. En bekräftelsedialogruta med tre alternativ visas när du inaktiverar Syntax auto-complete växla:

  • Cancel
  • Save changes and refresh
  • Refresh without saving changes
VIKTIGT

Om du skriver eller redigerar en fråga när du inaktiverar den här funktionen måste du spara alla ändringar i frågan innan du uppdaterar sidan, annars går alla förlopp förlorade.

Bekräftelsedialogrutan för att inaktivera funktionen för automatisk komplettering.

Välj lämpligt alternativ för att inaktivera funktionen för automatisk komplettering.

Felidentifiering

Query Editor validerar automatiskt en fråga medan du skriver den, vilket ger generisk SQL-validering och specifik körningsvalidering. Om en röd understrykning visas under frågan (som bilden nedan visar) representerar den ett fel i frågan.

Indata från Frågeredigeraren som visar SQL understruket i rött för att indikera ett fel.

När fel upptäcks kan du visa de specifika felmeddelandena genom att hovra över SQL-koden.

En dialogruta med ett felmeddelande.

Frågeinformation

Välj en sparad mall från Templates för att visa den i frågeredigeraren. Panelen Frågeinformation innehåller mer information och verktyg för att hantera den valda frågan.

Frågeredigeraren med frågeinformationspanelen markerad.

På den här panelen kan du generera en utdatamängd direkt från användargränssnittet, ta bort eller namnge den visade frågan och lägga till ett schema i frågan.

På den här panelen visas även användbara metadata som den senaste gången frågan ändrades och vem som ändrade den, om tillämpligt. Om du vill generera en datauppsättning väljer du Output Dataset. The Output Dataset visas. Ange ett namn och en beskrivning och välj Run Query. Den nya datauppsättningen visas i Datasets på Query Service användargränssnitt på Platform.

Schemalagda frågor

Frågor som har sparats som en mall kan schemaläggas från Frågeredigeraren. På så sätt kan du automatisera körningar av frågor med en anpassad stängsel. Du kan schemalägga frågor baserat på frekvens, datum och tid och även välja en utdatamängd för dina resultat om det behövs. Frågescheman kan också inaktiveras eller tas bort via användargränssnittet.

Scheman ställs in från frågeredigeraren. Nedan följer en lista över begränsningar för schemalagda frågor när du använder Frågeredigeraren. De gäller inte för Query Service API:

  • Du kan bara lägga till ett schema i en fråga som redan har skapats, sparats och körts.
  • Du inte lägga till ett schema i en parametriserad fråga.
  • Schemalagda frågor inte innehåller ett anonymt block.

Läs dokumentationen om frågescheman för att lära dig mer om skapa frågescheman i användargränssnittet. Du kan även läsa mer om hur du lägger till scheman med API:t i slutpunktsguide för schemalagda frågor.

Alla schemalagda frågor läggs till i listan i Scheduled queries -fliken. Från den arbetsytan kan du övervaka statusen för alla schemalagda frågejobb via gränssnittet. På Scheduled queries kan du hitta viktig information om frågekörningar och prenumerera på aviseringar. Den tillgängliga informationen omfattar status, schemainformation och felmeddelanden/koder om en körning misslyckas. Se Övervaka dokument för schemalagda frågor för mer information.

Sparar frågor

The Query Editor innehåller en funktion för att spara som gör att du kan spara en fråga och arbeta med den senare. Om du vill spara en fråga väljer du Save i det övre högra hörnet av Query Editor. Innan en fråga kan sparas måste ett namn anges för frågan med hjälp av Query Details -panelen.

OBSERVERA

Frågor som namngivits och sparats i med Frågeredigeraren är tillgängliga som mallar på kontrollpanelen Fråga Templates -fliken. Se malldokumentation för mer information.

Söka efter tidigare frågor

Alla frågor som körs från Query Editor finns i loggtabellen. Du kan använda sökfunktionerna i Log för att hitta frågekörningar. Sparade frågor listas i Templates -fliken.

Om en fråga har schemalagts Scheduled Queries -fliken ger förbättrad synlighet via användargränssnittet för dessa frågefunktioner. Se frågeövervakningsdokumentation för mer information.

OBSERVERA

Frågor som inte körs sparas inte av loggen. För att frågan ska vara tillgänglig i Query Servicemåste den köras eller sparas i Query Editor.

Köra frågor med Frågeredigeraren

Så här kör du en fråga i Query Editorkan du ange SQL i redigeraren eller läsa in en tidigare fråga från Log eller Templates och markera Spela upp. Status för frågekörning visas i Console nedan och utdata visas i Results -fliken.

Konsol

Konsolen ger information om status och funktion för Query Service. Konsolen visar anslutningsstatus för Query Service, frågeåtgärder som körs och felmeddelanden som är ett resultat av dessa frågor.

Fliken Konsol i frågeredigeringskonsolen.

OBSERVERA

Konsolen visar bara fel som uppstått när en fråga kördes. Frågevalideringsfel visas inte innan en fråga körs.

Frågeresultat

När en fråga är klar visas resultatet i Results -flik, bredvid Console -fliken. I den här vyn visas frågans tabellutdata med upp till 100 rader. I den här vyn kan du verifiera att frågan ger förväntat resultat. Om du vill generera en datauppsättning med frågan tar du bort begränsningar för returnerade rader och kör frågan med CREATE TABLE tablename AS SELECT för att generera en datauppsättning med utdata. Se skapa datauppsättningar, genomgång för instruktioner om hur du genererar en datauppsättning från frågeresultat i Query Editor.

Fliken Resultat i frågeredigeringskonsolen som visar resultatet av en frågekörning.

Kör frågor med Query Service video med självstudiekurser

I följande video visas hur du kör frågor i Adobe Experience Platform-gränssnittet och i en PSQL-klient. Dessutom visas om du använder enskilda egenskaper i ett XDM-objekt, använder funktioner som definieras av Adobe och använder CREATE TABLE AS SELECT (CTAS).

Nästa steg

Nu när du vet vilka funktioner som är tillgängliga i Query Editor och hur du navigerar i programmet kan du börja skapa egna frågor direkt i Platform. Mer information om hur du kör SQL-frågor mot datauppsättningar i Data Lake, se guiden på köra frågor.

På denna sida