Handleiding voor de Query Editor

De Redacteur van de vraag is een interactief hulpmiddel dat door de Dienst van de Vraag van Adobe Experience Platform wordt verstrekt, die u toestaat schrijven, bevestigen, en vragen voor de gegevens van de klantenervaring in werking te stellen binnen Experience Platform gebruikersinterface. De Redacteur van de vraag steunt het ontwikkelen van vragen voor analyse en gegevensexploratie, en staat u toe om interactieve vragen voor ontwikkelingsdoeleinden evenals niet-interactieve vragen in werking te stellen om datasets in te vullen Experience Platform.

Voor meer informatie over de concepten en de eigenschappen van de Dienst van de Vraag, zie Overzicht van Query Service. Meer over leren hoe te om het gebruikersinterface van de Dienst van de Vraag te navigeren Platform, zie de Overzicht van Query Service.

Aan de slag getting-started

De redacteur van de Vraag verstrekt flexibele uitvoering van vragen door met de Dienst van de Vraag te verbinden, en vragen slechts lopen terwijl deze verbinding actief is.

Query-editor openen accessing-query-editor

In de Experience Platform UI, selecteer Queries in het linkernavigatiemenu om de werkruimte van de Dienst van de Vraag te openen. Selecteer vervolgens Create Query rechtsboven in het scherm. Deze koppeling is beschikbaar op een van de pagina's in de werkruimte van de Query-service.

Verbinding maken met Query-service connecting-to-query-service

De redacteur van de Vraag neemt een paar seconden om met de Dienst van de Vraag te initialiseren en te verbinden wanneer het wordt geopend. De console vertelt u wanneer het wordt aangesloten, zoals hieronder getoond. Als u probeert om een vraag in werking te stellen alvorens de redacteur heeft verbonden, vertraagt het uitvoering tot de verbinding volledig is.

Hoe de vragen van de Redacteur van de Vraag in werking worden gesteld run-a-query

De vragen die van de Redacteur van de Vraag worden uitgevoerd stellen interactief in werking. Dit betekent dat als u browser sluit of weg navigeert, de vraag wordt geannuleerd. Het zelfde is waar voor vragen die worden gemaakt om datasets van vraagoutput te produceren.

Query schrijven met de Uitgebreide Query Editor query-authoring

Gebruikend de Redacteur van de Vraag, kunt u schrijven, uitvoeren en sparen vragen voor de gegevens van de klantenervaring. Alle uitgevoerde vragen, of opgeslagen in de Redacteur van de Vraag zijn beschikbaar aan alle gebruikers in uw organisatie met toegang tot de Dienst van de Vraag.

Instellingen settings

Een instellingenpictogram boven het invoerveld van de Query Editor bevat opties voor het in-/uitschakelen van donker thema of voor het automatisch aanvullen.

Selecteer het instellingspictogram ( ) gevolgd door de optie in het vervolgkeuzemenu dat wordt weergegeven.

Automatisch aanvullen auto-complete

De redacteur van de Vraag stelt automatisch potentiële SQL sleutelwoorden samen met lijst of kolomdetails voor de vraag voor aangezien u het schrijft. De functie voor automatisch aanvullen is standaard ingeschakeld en kan op elk gewenst moment worden uitgeschakeld of ingeschakeld via de instellingen in de Query Editor.

De auto-volledige configuratie het plaatsen is per gebruiker en voor de opeenvolgende logins voor die gebruiker herinnerd. Als u deze functie uitschakelt, worden meerdere metagegevensopdrachten niet verwerkt en worden aanbevelingen gedaan die de snelheid van de auteur bij het bewerken van query's ten goede komen.

Meerdere opeenvolgende query's uitvoeren execute-multiple-sequential-queries

Gebruik de Uitgebreide Redacteur van de Vraag om meer dan één vraag te schrijven en alle vragen op een opeenvolgende manier uit te voeren. De uitvoering van veelvoudige vragen in een opeenvolging elk produceert een logboekingang. Nochtans, slechts de resultaten van de eerste vraagvertoning in de console van de Redacteur van de Vraag. Controleer het vraaglogboek als u de vragen moet problemen oplossen of bevestigen die werden uitgevoerd. Zie de documentatie met querylogbestanden voor meer informatie .

Geselecteerde query uitvoeren execute-selected-query

Als u meerdere query's hebt geschreven maar slechts één query moet uitvoeren, kunt u de gekozen query markeren en de opdracht
Run selected query pictogram. Dit pictogram wordt standaard uitgeschakeld totdat u de querysyntaxis in de editor selecteert.

Query Editor-sessie annuleren cancel-query

Neem controle van vraaguitvoering en verbeter uw productiviteit door langdurige vragen te annuleren. Deze actie ontruimt de Redacteur van de Vraag tijdens een vraaglooppas. De query wordt op de achtergrond uitgevoerd. Als het een vraag CTAS is zal het nog een outputdataset produceren. Als u de uitvoering in de editor wilt annuleren en een SQL-instructie wilt blijven samenstellen, selecteert u Cancel query nadat een query is uitgevoerd.

Er wordt een bevestigingsvenster weergegeven. Selecteren Confirm om de queryuitvoering te annuleren.

Resultaattelling result-count

De redacteur van de Vraag heeft een maximum 50.000 rijoutput. U kunt het aantal rijen kiezen die tegelijkertijd in de console van de Redacteur van de Vraag worden getoond. Als u het aantal rijen wilt wijzigen dat in de console wordt weergegeven, selecteert u de optie Result count en selecteer de opties 50, 100, 150, 300 en 500.

Bezig met schrijven van query's writing-queries

Query Editor is georganiseerd om het schrijven van vragen zo gemakkelijk mogelijk te maken. In de onderstaande schermafbeelding ziet u hoe de editor in de gebruikersinterface wordt weergegeven, met het veld voor SQL-invoer en Afspelen gemarkeerd.

Om uw ontwikkelingstijd te minimaliseren, wordt u geadviseerd om uw vragen met grenzen op het aantal teruggekeerde rijen te ontwikkelen. Bijvoorbeeld: SELECT fields FROM table WHERE conditions LIMIT number_of_rows. Nadat u hebt gecontroleerd dat uw vraag de verwachte output veroorzaakt, verwijder de grenzen en stel de vraag met in werking CREATE TABLE tablename AS SELECT om een dataset met de output te produceren.

Schrijfgereedschappen in de Query Editor writing-tools

Tekst opmaken format-text

De Format text maakt uw query leesbaarder door gestandaardiseerde syntaxisopmaak toe te voegen. Selecteren Format text om alle tekst binnen de Redacteur van de Vraag te standaardiseren.

SQL kopiëren copy-sql

Selecteer het kopieerpictogram om SQL van de Redacteur van de Vraag aan uw klembord te kopiëren. Deze kopieerfunctie is beschikbaar voor zowel querysjablonen als nieuwe query's in de Query Editor.

Query-details query-details

Als u een query wilt weergeven in de Query-editor, selecteert u een opgeslagen sjabloon in het menu Templates tab. Het deelvenster met querydetails bevat meer informatie en gereedschappen voor het beheer van de geselecteerde query. Het toont ook nuttige meta-gegevens zoals de laatste tijd dat de vraag werd gewijzigd en wie het, indien van toepassing wijzigde.

Van het detailspaneel kunt u een outputdataset direct van UI produceren, schrapt of noemt de getoonde vraag, bekijkt het programma van de vraaglooppas, en voegt de vraag aan een programma toe.

Om een outputdataset te produceren, selecteer Run as CTAS. De Enter output dataset details wordt weergegeven. Voer een naam en beschrijving in en selecteer Run as CTAS. De nieuwe dataset wordt getoond in Datasets Tabblad Bladeren. Zie de documentatie van meningsdatasets om meer over beschikbare datasets voor uw organisatie te leren.

Nadat u de opdracht Run as CTAS actie, verschijnt er een bevestigingsbericht om u op de hoogte te brengen van de geslaagde actie. Dit popup bericht bevat een verbinding die een geschikte manier verstrekt om aan de werkruimte van vraaglogboeken te navigeren. Zie de documentatie met querylogbestanden voor meer informatie over vraaglogboeken.

Vragen opslaan saving-queries

De redacteur van de Vraag verstrekt sparen functie die u toestaat om een vraag te bewaren en het later te werken aan het. Als u een query wilt opslaan, selecteert u Save in de hoger-juiste hoek van de Redacteur van de Vraag. Voordat een query kan worden opgeslagen, moet u een naam opgeven voor de query met de opdracht Query Details deelvenster.

Als u een query opslaat in de Query Editor, verschijnt er een bevestigingsbericht om u op de hoogte te brengen van de geslaagde actie. Dit popup bericht bevat een verbinding die een geschikte manier verstrekt om aan de vragen te navigeren die werkruimte plannen. Zie de documentatie met planningquery's om te leren hoe vragen op een douanecadence in werking te stellen.

Geplande query's scheduled-queries

De vragen die als malplaatje zijn bewaard kunnen van de Redacteur van de Vraag worden gepland. Het plannen van vragen staat u toe om vraaglooppas op een douanecadence te automatiseren. U kunt vragen plannen die op frequentie, datum, en tijd worden gebaseerd, en ook een outputdataset voor uw resultaten kiezen indien nodig. De programma's van de vraag kunnen ook door UI worden onbruikbaar gemaakt of worden geschrapt.

Planningen worden ingesteld in de Query-editor. Wanneer het gebruiken van de Redacteur van de Vraag, kunt u een programma aan een vraag slechts toevoegen die reeds is gecreeerd, en bewaard. Dezelfde beperking geldt niet voor de API van de Query-service.

Zie de documentatie van vraagprogramma's leren hoe te vraagprogramma's in UI creëren. U kunt ook leren hoe u schema's kunt toevoegen met de API, door de de geplande gids van het vraageindpunt.

Alle geplande query's worden toegevoegd aan de lijst in de Scheduled queries tab. Van die werkruimte kunt u het statuut van alle geplande vraagbanen door UI controleren. Op de Scheduled queries kunt u belangrijke informatie over uw vraaglooppas vinden en aan alarm intekenen. De beschikbare informatie bevat de status, de planningsdetails en foutberichten/codes als een uitvoering is mislukt. Zie de Geplande query's controleren voor meer informatie .

Hoe te om vorige vragen te vinden previous-queries

Alle vragen die van de Redacteur van de Vraag worden uitgevoerd worden gevangen in de lijst van het Logboek. U kunt de zoekfunctionaliteit in het dialoogvenster Log om query-uitvoeringen te zoeken. Opgeslagen query's worden weergegeven in het dialoogvenster Templates tab.

Als een vraag gepland was, toen Scheduled Queries biedt een verbeterde zichtbaarheid via de gebruikersinterface voor die querytaken. Zie de query-monitoringdocumentatie voor meer informatie .

Vragen uitvoeren met de Query Editor executing-queries

Als u een query wilt uitvoeren in de Query Editor, kunt u SQL invoeren in de editor of een vorige query laden vanuit de Log of Templates en selecteert u Afspelen. De status van query-uitvoering wordt weergegeven in het dialoogvenster Console en de uitvoergegevens worden weergegeven in het dialoogvenster Results tab.

Console console

De console verstrekt informatie over de status en de verrichting van de Dienst van de Vraag. De console toont de verbindingsstatus aan de Dienst van de Vraag, vraagverrichtingen die, en om het even welke foutenmeldingen worden uitgevoerd die uit die vragen voortvloeien.

Zoekresultaten query-results

Nadat een vraag is voltooid, worden de resultaten getoond in Results tab, naast de Console tab. In deze weergave wordt de tabeluitvoer van de query weergegeven. Afhankelijk van uw keuze worden tussen 50 en 500 rijen met resultaten weergegeven aantal resultaten. In deze weergave kunt u controleren of de query de verwachte uitvoer oplevert. Om een dataset met uw vraag te produceren, verwijder grenzen op teruggekeerde rijen, en stel de vraag met in werking CREATE TABLE tablename AS SELECT om een dataset met de output te produceren. Zie de het produceren van datasetleerprogramma voor instructies op hoe te om een dataset van vraagresultaten in de Redacteur van de Vraag te produceren.

Gebruik hoofdletters use-cases

De Dienst van de vraag verstrekt oplossingen aan een verscheidenheid van gebruiksgevallen over industrieën en bedrijfsscenario's. Deze praktische voorbeelden tonen de flexibiliteit en het effect van de dienst in het aanpakken van diverse behoeften aan. Naar ontdekken hoe de Dienst van de Vraag waarde aan uw specifieke bedrijfsbehoeften kan brengen, de uitgebreide verzameling van gebruiksdossiers te onderzoeken. Leer hoe te om de Dienst van de Vraag te gebruiken om inzichten en oplossingen voor verbeterde operationele efficiency en bedrijfssucces te verstrekken.

De vragen van de looppas met de zelfstudie van de Dienst van de Vraag query-tutorial-video

In de volgende video ziet u hoe u query's uitvoert in de Adobe Experience Platform-interface en in een PSQL-client. De video demonstreert ook het gebruik van individuele eigenschappen in een XDM-object, Adobe-gedefinieerde functies en hoe u CREATE TABLE AS SELECT (CTAS)-query's gebruikt.

Volgende stappen

Nu u weet welke eigenschappen in de Redacteur van de Vraag beschikbaar zijn en hoe te om de toepassing te navigeren, kunt u beginnen direct creërend uw eigen vragen in Platform. Voor meer informatie over het runnen van SQL vragen tegen datasets binnen Data Lake, zie de handleiding op uitvoeren, query's.