Användargränssnittshandbok för frågeredigeraren

Frågeredigeraren är ett interaktivt verktyg som tillhandahålls av Adobe Experience Platform Query Service, som gör att du kan skriva, validera och köra frågor för kundupplevelsedata i Experience Platform-användargränssnittet. Frågeredigeraren har stöd för att utveckla frågor för analys och datautforskande. Du kan även köra interaktiva frågor i utvecklingssyfte och icke-interaktiva frågor för att fylla i datauppsättningar i Experience Platform.

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

Komma igång getting-started

Frågeredigeraren erbjuder flexibel körning av frågor genom att ansluta till frågetjänsten och frågor som bara körs när den här anslutningen är aktiv.

Åtkomst till frågeredigeraren accessing-query-editor

I Experience Platform-gränssnittet väljer du Queries i den vänstra navigeringsmenyn för att öppna arbetsytan för frågetjänsten. Om du vill 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 på arbetsytan för frågetjänsten.

Ansluter till frågetjänsten 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 Frågeredigeraren run-a-query

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

Redigera frågor med den förbättrade Frågeredigeraren query-authoring

Med Frågeredigeraren kan du skriva, köra och spara frågor om kundupplevelsedata. Alla frågor som körs eller sparas i Frågeredigeraren är tillgängliga för alla användare i organisationen som har tillgång till Frågetjänsten.

Inställningar settings

En inställningsikon ovanför inmatningsfältet i Frågeredigeraren innehåller alternativ för att aktivera/inaktivera 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.

Komplettera automatiskt auto-complete

Frågeredigeraren 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 inaktiveras eller aktiveras när som helst från inställningarna för 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.

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

Använd den förbättrade frågeredigeraren för att skriva mer än en fråga 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. Mer information finns i frågeloggsdokumentationen.

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 komponera en SQL-sats väljer du Cancel query efter att du har kört en fråga.

En bekräftelsedialogruta visas. Välj Confirm om du vill 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 listrutan Result count och väljer bland alternativen 50, 100, 150, 300 och 500.

Skriver frågor writing-queries

Query Editor är organiserat för att göra skrivfrågor så enkla som möjligt. Skärmbilden nedan visar hur redigeraren visas i användargränssnittet, med SQL-inmatningsfältet och Spela upp markerat.

För att minimera utvecklingstiden rekommenderar vi att du utvecklar 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 din fråga skapar förväntade utdata 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 Frågeredigeraren writing-tools

Formatera text format-text

Funktionen Format text gör din fråga mer läsbar genom att lägga till en standardiserad syntaxformatering. Välj Format text om du vill 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.

Frågeinformation query-details

Om du vill visa en fråga i frågeredigeraren väljer du en sparad mall på fliken Templates. 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. Dialogrutan Enter output dataset details visas. Ange ett namn och en beskrivning och välj sedan Run as CTAS. Den nya datauppsättningen visas på fliken Datasets Bläddra. Mer information om tillgängliga datauppsättningar för din organisation finns i dokumentationen för att visa datauppsättningar.

När du har utfört åtgärden Run as CTAS visas ett bekräftelsemeddelande som meddelar 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 frågeloggar. Mer information om frågeloggar finns i frågeloggsdokumentationen.

Sparar frågor saving-queries

Frågeredigeraren innehåller en funktion för att 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 i Frågeredigeraren. Innan en fråga kan sparas måste ett namn anges för frågan med hjälp av panelen Query Details.

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. Läs dokumentationen för schemafrågor om du vill veta hur du kör frågor på en anpassad cache.

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 API:t för frågetjänsten.

I dokumentationen för frågescheman finns mer information om hur du skapar frågescheman i användargränssnittet. Om du vill lära dig hur du lägger till scheman med API:t läser du slutpunktshandboken för schemalagda frågor.

Alla schemalagda frågor läggs till i listan på fliken Scheduled queries. Från den arbetsytan kan du övervaka statusen för alla schemalagda frågejobb via gränssnittet. På fliken 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. Mer information finns i dokumentet Övervaka schemalagda frågor.

Söka efter tidigare frågor previous-queries

Alla frågor som körs från Frågeredigeraren hämtas i loggtabellen. Du kan använda sökfunktionen på fliken Log för att hitta frågekörningar. Sparade frågor visas på fliken Templates.

Om en fråga har schemalagts ger fliken Scheduled Queries förbättrad synlighet via gränssnittet för dessa frågefunktioner. Mer information finns i frågeövervakningsdokumentationen.

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

Om du vill köra en fråga i frågeredigeraren kan du ange SQL i redigeraren eller läsa in en tidigare fråga från fliken Log eller Templates och välja Spela upp. Status för frågekörning visas på fliken Console nedan och utdata visas på fliken Results.

Konsol console

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

Frågeresultat query-results

När en fråga har slutförts visas resultaten på fliken Results bredvid fliken Console. I den här vyn visas frågans tabellutdata, med mellan 50 och 500 resultatrader beroende på ditt valda resultatantal. I den här vyn kan du verifiera att frågan ger förväntat resultat. Om du vill generera en datauppsättning med din fråga 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 självstudiekursen om att generera datauppsättningar för instruktioner om hur du genererar en datauppsättning från frågeresultat i Frågeredigeraren.

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. Om du vill ta reda på hur frågetjänsten kan tillföra värde till dina specifika affärsbehov kan du 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öra frågor med självstudievideo om frågetjänsten 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 Frågeredigeraren 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 finns i guiden om att köra frågor.