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 getting-started

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.

Komma åt Query Editor accessing-query-editor

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

Ansluter till Query Service connecting-to-query-service

Frågeredigeraren tar några sekunder att initiera och ansluta till frågetjänsten när den öppnas. Konsolen talar om för dig 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.

Hur frågor körs från Query Editor run-a-query

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

Med den förbättrade versionen av Frågeredigeraren kan du skriva mer än en fråga i Frågeredigeraren och köra alla frågor sekventiellt. Se avsnittet om köra flera sekventiella frågor för mer information.

Frågeredigering med Query Editor query-authoring

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.

Förbättrad frågeredigerare enhanced-editor-toggle

Med ett användargränssnitt kan du växla mellan den tidigare och förbättrade versionen av Frågeredigeraren. Den äldre versionen är aktiverad som standard, men den förbättrade versionen har bättre tillgänglighet och stöd för flera teman. Aktivera den förbättrade versionen för att komma åt inställningarna för Frågeredigeraren.

När du aktiverar växlingsknappen ändras redigeraren till ett ljust tema och syntaxens läsbarhet förbättras. En inställningsikon visas också ovanför inmatningsfältet i Frågeredigeraren, som innehåller det automatiska avslutningsreglaget. Från inställningsikonen kan du aktivera mörkt tema eller inaktivera/aktivera automatisk komplettering.

Om du vill aktivera mörka eller ljusa teman väljer du inställningsikonen ( ) följt av alternativet i listrutan som visas.

Kör flera sekventiella frågor execute-multiple-sequential-queries

Med den förbättrade versionen av Frågeredigeraren kan du skriva mer än en fråga i Frågeredigeraren och köra alla frågor sekventiellt.

Körningen av flera frågor i en sekvens skapar varje loggpost. Endast resultatet av den första frågan visas dock i frågeredigeringskonsolen. Kontrollera frågeloggen om du behöver felsöka eller bekräfta de frågor som kördes. Se dokumentation för frågeloggar för mer information.

Kör markerad fråga execute-selected-query

Om du har skrivit flera frågor men bara behöver köra en fråga, kan du markera den valda frågan och välja
Run selected query -ikon. Den här ikonen är som standard inaktiverad tills du väljer frågesyntax i redigeraren.

Avbryt frågeredigeringssession cancel-query

Ta kontroll över frågekörningen och förbättra produktiviteten genom att avbryta frågor som körs länge. Den här åtgärden rensar frågeredigeraren under en frågekörning. Frågan fortsätter att köras i bakgrunden. Om det är en CTAS-fråga kommer den fortfarande att generera en utdatamängd. Om du vill avbryta körningen i redigeraren och fortsätta att komponera en SQL-sats väljer du Cancel query efter att en fråga har körts.

En bekräftelsedialogruta visas. Välj Confirm för att avbryta frågekörningen.

Resultatantal result-count

Frågeredigeraren har maximalt 50 000 radutdata. Du kan välja hur många rader som ska visas samtidigt i frågeredigeringskonsolen. Om du vill ändra antalet rader som visas i konsolen väljer du Result count och välj mellan alternativen 50, 100, 150, 300 och 500.

Skriver frågor writing-queries

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.

För att minimera utvecklingstiden rekommenderar vi att du utvecklar frågor med begränsningar för antalet rader som returneras. Till 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 writing-tools

Formatera text format-text

The Format text gör din fråga mer läsbar genom att lägga till en standardiserad syntaxformatering. Välj Format text för att standardisera all text i Frågeredigeraren.

Kopiera SQL copy-sql

Välj kopieringsikonen om du vill kopiera SQL från Frågeredigeraren till Urklipp. Den här kopieringsfunktionen är tillgänglig för både frågemallar och nyskapade frågor i Frågeredigeraren.

Växla mellan automatisk komplettering av användargränssnittskonfigurationen auto-complete

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.

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 när han/hon redigerar 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:

Om du vill inaktivera funktionen för automatisk komplettering väljer du lämpligt bekräftelsealternativ.

Felidentifiering error-detection

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.

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

Frågeinformation query-details

Om du vill visa en fråga i Frågeredigeraren väljer du en sparad mall i dialogrutan Templates -fliken. Panelen Frågeinformation innehåller mer information och verktyg för att hantera den valda frågan. Här visas även användbara metadata, t.ex. den senaste gången frågan ändrades och vem som ändrade den, om tillämpligt.

På informationspanelen kan du generera en utdatauppsättning direkt från användargränssnittet, ta bort eller namnge den visade frågan, visa frågekörningsschemat och lägga till frågan i ett schema.

Om du vill generera en utdatamängd väljer du Run as CTAS. The Enter output dataset details visas. Ange ett namn och en beskrivning och välj Run as CTAS. Den nya datauppsättningen visas i Datasets Fliken Bläddra. Se visa datauppsättningsdokumentation om du vill veta mer om tillgängliga datauppsättningar för din organisation.

När du har kört Run as CTAS visas ett bekräftelsemeddelande som meddelar dig om åtgärden har slutförts. Det här popup-meddelandet innehåller en länk som gör det enkelt att navigera till arbetsytan för frågeloggar. Se dokumentation för frågeloggar om du vill ha mer information om frågeloggar.

Sparar frågor saving-queries

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.

När du sparar en fråga i Frågeredigeraren visas ett bekräftelsemeddelande som informerar dig om den slutförda åtgärden. Det här popup-meddelandet innehåller en länk som gör det enkelt att navigera till arbetsytan för schemaläggning av frågor. Se dokumentation för schemafrågor om du vill lära dig hur du kör frågor på en anpassad cadence.

Schemalagda frågor scheduled-queries

Frågor som har sparats som en mall kan schemaläggas från Frågeredigeraren. Med schemaläggningsfrågor kan du automatisera frågekörningar på en anpassad cache. 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 även inaktiveras eller tas bort via användargränssnittet.

Scheman ställs in i Frågeredigeraren. När du använder Frågeredigeraren kan du bara lägga till ett schema i en fråga som redan har skapats och sparats. Samma begränsning gäller inte för Query Service API.

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.

Söka efter tidigare frågor previous-queries

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.

Köra frågor med Frågeredigeraren executing-queries

Köra 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 console

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.

Frågeresultat query-results

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 mellan 50 och 500 resultatrader beroende på vad du väljer antal resultat. 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.

Användningsfall use-cases

Frågetjänsten ger lösningar på en mängd olika användningsområden i olika branscher och affärsscenarier. Dessa praktiska exempel visar tjänstens flexibilitet och effekt när det gäller att ta itu med olika behov. Till Upptäck hur frågetjänsten kan ge mervärde till dina specifika affärsbehov, utforska den omfattande samlingen av falldokument. Lär dig använda frågetjänsten för att få insikter och lösningar för ökad effektivitet och affärsframgångar.

Kör frågor med Query Service videokurs query-tutorial-video

I följande video visas hur du kör frågor i Adobe Experience Platform-gränssnittet och i en PSQL-klient. I videon visas också hur du använder enskilda egenskaper i ett XDM-objekt, Adobe-definierade funktioner och hur du använder CREATE TABLE AS SELECT-frågor (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.