Dokumentation Experience Platform Användarhandbok om Query Service

Övervaka schemalagda frågor

Last update: Thu Jul 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Frågor

Skapat för:

Användare
Utvecklare

Adobe Experience Platform ger bättre synlighet för status för alla frågefunktioner via användargränssnittet. På fliken Scheduled Queries kan du nu hitta viktig information om dina frågekörningar som omfattar status, schemainformation och felmeddelanden/koder om de skulle misslyckas. Du kan även prenumerera på aviseringar för frågor baserat på deras status via användargränssnittet för någon av dessa frågor via fliken Scheduled Queries.

Scheduled Queries

Fliken Scheduled Queries innehåller en översikt över alla dina schemalagda CTAS- och ITAS-frågor. Det går att hitta körningsinformation för alla schemalagda frågor samt felkoder och meddelanden för eventuella misslyckade frågor.

Om du vill navigera till fliken Scheduled Queries väljer du Queries i det vänstra navigeringsfältet följt av Scheduled Queries

Fliken Schemalagda frågor på arbetsytan Frågor med schemalagda frågor markerade.

Tabellen nedan beskriver varje tillgänglig kolumn.

NOTE

Ikonen för aviseringsprenumerationer (

) finns i varje rad i en namnlös kolumn. Mer information finns i avsnittet Varningsprenumerationer.

Kolumn

Beskrivning

Name

Namnfältet är antingen mallnamnet eller de första tecknen i SQL-frågan. Alla frågor som skapas via gränssnittet med Frågeredigeraren får i början ett namn. Om frågan skapades med API:t blir dess namn ett fragment av den ursprungliga SQL-kod som användes för att skapa frågan. Om du vill visa en lista över alla körningar som är associerade med frågan väljer du ett objekt i kolumnen Name. Mer information finns i avsnittet Frågor kör schemainformation.

Template

Frågans mallnamn. Välj ett mallnamn för att gå till Frågeredigeraren. Frågemallen visas i Frågeredigeraren. Om det inte finns något mallnamn markeras raden med ett bindestreck och det går inte att omdirigera till Frågeredigeraren för att visa frågan.

SQL

Ett fragment av SQL-frågan.

Run frequency

Den gräns som frågan är inställd på att köras vid. De tillgängliga värdena är Run once och Scheduled.

Created by

Namnet på den användare som skapade frågan.

Created

Tidsstämpeln när frågan skapades, i UTC-format.

Last run timestamp

Den senaste tidsstämpeln när frågan kördes. Den här kolumnen visar om en fråga har körts enligt det aktuella schemat.

Last run status

Status för den senaste frågekörningen. Statusvärdena är: Success, Failed, In progress och No runs.

Schedule Status

Den schemalagda frågans aktuella status. Det finns sex möjliga värden, Registering, Active, Inactive, Deleted, ett bindestreck och Quarantined.

Statusen Registering anger att systemet fortfarande bearbetar skapandet av det nya schemat för frågan. Observera att du inte kan inaktivera eller ta bort en schemalagd fråga medan den registreras.
Statusen Active anger att den schemalagda frågan ännu inte har passerat sitt slutförandedatum och sin slutförandetid.
Statusen Inactive anger att den schemalagda frågan har passerat sitt slutförandedatum och sin slutförandetid eller har markerats av en användare som inaktiv.
Statusen Deleted anger att frågeschemat har tagits bort.
Avstavningen anger att den schemalagda frågan är en enstaka, icke återkommande fråga.
Statusen Quarantined indikerar att frågan har misslyckats tio körningar i följd och kräver att du gör något innan fler körningar kan utföras.

TIP

Om du går till Frågeredigeraren kan du välja Queries för att gå tillbaka till fliken Templates.

Anpassa tabellinställningar för schemalagda frågor customize-table

Du kan justera kolumnerna på fliken Scheduled Queries efter dina behov. Om du vill öppna dialogrutan Customize table-inställningar och redigera tillgängliga kolumner väljer du inställningsikonen ( ) i skärmens övre högra hörn.

NOTE

Kolumnen Created som refererar till datumet då schemat skapades är dold som standard.

Fliken Schemalagda frågor med ikonen Anpassa tabellinställningar markerad.

Växla mellan de relevanta kryssrutorna för att ta bort eller lägga till en tabellkolumn. Välj sedan Apply för att bekräfta dina val.

NOTE

Alla frågor som har skapats via användargränssnittet blir en namngiven mall som en del av skapandeprocessen. Mallnamnet visas i mallkolumnen. Om frågan skapades via API är mallkolumnen tom.

Dialogrutan Anpassa tabellinställningar.

Hantera schemalagda frågor med infogade åtgärder inline-actions

I vyn Scheduled Queries finns olika infogade åtgärder för att hantera alla dina schemalagda frågor från en plats. Textbundna åtgärder anges på varje rad med ellips. Markera ellipsen för en schemalagd fråga som du vill hantera för att se de tillgängliga alternativen på en snabbmeny. De tillgängliga alternativen är Disable schedule eller Enable schedule, Delete schedule, Subscribe för att fråga efter varningar och Aktivera eller Disable quarantine.

Fliken Schemalagda frågor med de infogade åtgärdsellipserna och popup-menyn markerade.

Inaktivera eller aktivera en schemalagd fråga disable

Om du vill inaktivera en schemalagd fråga markerar du ellipsen för den schemalagda fråga som du vill hantera och väljer sedan Disable schedule bland alternativen på snabbmenyn. En dialogruta visas där du kan bekräfta åtgärden. Välj Disable för att bekräfta inställningen.

När en schemalagd fråga har inaktiverats kan du aktivera schemat via samma process. Markera ellipsen och välj sedan Enable schedule bland de tillgängliga alternativen.

NOTE

Om en fråga har placerats i karantän bör du granska mallens SQL innan du aktiverar dess schema. Detta förhindrar slöseri med beräkningstimmar om mallfrågan fortfarande har problem.

Ta bort en schemalagd fråga delete

Om du vill ta bort en schemalagd fråga markerar du ellipsen för den schemalagda fråga som du vill hantera och väljer sedan Delete schedule bland alternativen på snabbmenyn. En dialogruta visas där du kan bekräfta åtgärden. Välj Delete för att bekräfta inställningen.

När en schemalagd fråga har tagits bort tas den inte bort från listan med schemalagda frågor. De infogade åtgärder som tillhandahålls av ellipserna tas bort och ersätts av den nedtonade prenumerationsikonen för att lägga till aviseringar. Du kan inte prenumerera på aviseringar för det borttagna schemat. Raden finns kvar i användargränssnittet för att ge information om körningar som utförts som en del av den schemalagda frågan.

Fliken Schemalagda frågor med en borttagen schemalagd fråga och en nedtonad aviseringsprenumerationsikon markerad.

Om du vill schemalägga körningar för den frågemallen väljer du mallnamnet på lämplig rad för att navigera till frågeredigeraren och följer sedan instruktionerna för att lägga till ett schema i en fråga enligt beskrivningen i dokumentationen.

Prenumerera på aviseringar alert-subscription

Om du vill prenumerera på aviseringar för schemalagda frågekörningar väljer du ikonen ... (ellips) eller aviseringsprenumeration ( ) för den schemalagda frågan som du vill hantera. Listrutan för textbundna åtgärder visas. Välj sedan Subscribe bland de tillgängliga alternativen.

Arbetsytan för schemalagda frågor med en ellips, en aviseringsprenumerationsikon och listrutan för infogade åtgärder är markerad.

Dialogrutan Alerts öppnas. Dialogrutan Alerts prenumererar på både UI-meddelanden och e-postaviseringar. Det finns flera olika prenumerationsalternativ: start, success, failure, quarantine och delay. Markera lämpliga rutor och välj Save att prenumerera på.

Dialogrutan med aviseringsprenumerationer.

Tabellen nedan förklarar vilka frågeartikeltyper som stöds:

Aviseringstyp

Beskrivning

start

Den här varningen meddelar dig när en schemalagd frågekörning initieras eller börjar bearbetas.

success

Den här varningen informerar dig när en schemalagd frågekörning har slutförts, vilket anger att frågan har körts utan fel.

failed

Den här varningen utlöses när en schemalagd frågekörning påträffar ett fel eller misslyckas med att köras. Det hjälper er att snabbt identifiera och åtgärda problem.

quarantine

Den här varningen aktiveras när en schemalagd frågekörning sätts i karantän. När frågor registreras i karantänfunktionen placeras automatiskt alla schemalagda frågor som misslyckas tio på varandra följande körningar i tillståndet Quarantined. De måste sedan ingripa innan fler avrättningar kan utföras.

delay

Den här varningen meddelar dig om det finns en fördröjning i resultatet av en frågekörning över ett angivet tröskelvärde. Du kan ange en anpassad tid som utlöser varningen när frågan körs för den tidslängden utan att slutföra eller misslyckas.

NOTE

Om du vill bli meddelad om att en fråga håller på att sättas i karantän måste du först registrera den schemalagda frågan som körs i karantänfunktionen.

Mer information finns i API-dokumentationen för aviseringsprenumerationer.

Visa frågedetaljer query-details

Välj informationsikonen ( ) om du vill visa informationspanelen för frågan. Panelen Detaljer innehåller all relevant information om frågan utöver de fakta som finns i tabellen med schemalagda frågor. Ytterligare information omfattar fråge-ID, senaste ändringsdatum, frågans SQL, schema-ID och aktuellt uppsättningsschema.

Fliken Schemalagda frågor med informationsikonen och informationspanelen markerad.

Frågor i karantän quarantined-queries

NOTE

Karantänsvarningen är inte tillgänglig för ad hoc-frågor som körs en gång. Karantänsvarningen gäller endast för schemalagda batchfrågor (CTAS och ITAS).

När en schemalagd fråga som misslyckas tio på varandra följande körningar registreras i karantänfunktionen får automatiskt statusen Quarantined. En fråga med den här statusen blir inaktiv och körs inte vid den schemalagda tidpunkten. Sedan måste du ingripa innan fler exekveringar kan utföras. Detta skyddar systemresurser eftersom du måste granska och korrigera problemen med din SQL innan fler körningar utförs.

Om du vill aktivera en schemalagd fråga för karantänfunktionen väljer du ellipserna (...) följt av Enable quarantine i listrutan som visas.

Fliken för schemalagda frågor med ellipserna och Aktivera karantän markerad på den nedrullningsbara menyn för infogade åtgärder.

Frågor kan också registreras i karantänfunktionen när schemat skapas. Mer information finns i dokumentationen om frågescheman.

Fördröjning för frågekörning query-run-delay

Ha full kontroll över beräkningstiden genom att ange varningar för fördröjning av frågor. Du kan övervaka frågeprestanda och få meddelanden om en frågas status inte ändras efter en viss period. Använd aviseringen Query Run Delay om du vill få ett meddelande om en fråga fortsätter att bearbetas efter en viss tidsperiod utan att slutföras.

När du prenumererar på aviseringar för schemalagda frågekörningar är en av de tillgängliga aviseringarna Query Run Delay. Den här varningen kräver att du anger en tröskel för hur lång tid som har ägnats åt att köra. Då får du ett meddelande om fördröjningen i bearbetningen.

Om du vill välja en tröskelvaraktighet som utlöser meddelandet anger du antingen ett tal i textinmatningsfältet eller använder upp- och nedpilarna för att öka i steg om en minut. Eftersom tröskelvärdet anges i minuter är den längsta tiden för att observera en fördröjning av frågekörning 1 440 minuter (24 timmar). Standardtidsperioden för en körningsfördröjning är 150 minuter.

NOTE

En frågekörning kan bara ha en körfördröjningstid. Om du ändrar fördröjningströskeln ändras den för användaren som prenumererar på aviseringen och för hela organisationen.

Dialogrutan Varningar på fliken med schemalagda frågor med inmatningsfältet för fördröjning av frågekörning markerat.

Se avsnittet om prenumerationer på aviseringar om du vill veta mer om hur du prenumererar på Query Run Delay aviseringar.

Filtrera frågor filter

Du kan filtrera frågor baserat på körningsfrekvens. På fliken Scheduled Queries väljer du filterikonen ( ) för att öppna filtersidofältet.

Fliken för schemalagda frågor med filterikonen markerad.

Om du vill filtrera listan med frågor baserat på deras körningsfrekvens markerar du kryssrutorna Scheduled eller Run once för filtret.

NOTE

Alla frågor som har körts men inte schemalagts kvalificeras som Run once.

Fliken för schemalagda frågor med filtersidofältet markerat.

När du har aktiverat filtervillkoren väljer du Hide Filters för att stänga filterpanelen.

Information om schemaläggning av frågekörningar query-runs

Om du vill öppna sidan med schemainformation väljer du ett frågenamn på fliken Scheduled Queries. Den här vyn innehåller en lista över alla körningar som har utförts som en del av den schemalagda frågan. Informationen omfattar start- och sluttid, status och datauppsättning som används.

Sidan med schemainformation.

Den här informationen finns i en tabell med fem kolumner. Varje rad betecknar en frågekörning.

Kolumnnamn

Beskrivning

Query run ID

Frågekörnings-ID för daglig körning. Välj Query run ID för att navigera till Query run overview.

Query run start

Tidsstämpeln när frågan kördes. Tidsstämpeln är i UTC-format.

Query run complete

Tidsstämpeln när frågan slutfördes. Tidsstämpeln är i UTC-format.

Status

Status för den senaste frågekörningen. Statusvärdena är: Success, Failed, In progress eller Quarantined.

Dataset

Den datauppsättning som ingår i körningen.

Information om frågan som schemaläggs kan visas på panelen Properties. Panelen innehåller det inledande fråge-ID:t, klienttyp, mallnamn, frågans SQL-kod och schemats avslutning.

Sidan med schemainformation med egenskapspanelen markerad.

Välj ett ID för frågekörning för att navigera till sidan med körningsinformation och visa frågeinformation.

Skärmen med schemainformation med ett körnings-ID markerat.

Översikt över frågekörning query-run-overview

Query run overview innehåller information om enskilda körningar för den här schemalagda frågan och en mer detaljerad beskrivning av körningsstatusen. Den här sidan innehåller även klientinformation och information om eventuella fel som kan ha gjort att frågan misslyckades.

Skärmen med körningsinformation med översiktsavsnittet markerat.

I avsnittet med frågestatus finns felkoden och felmeddelandet om frågan skulle ha misslyckats.

Skärmen med körningsinformation och felavsnittet markerat.

Du kan kopiera frågans SQL till Urklipp från den här vyn. Om du vill kopiera frågan väljer du kopieringsikonen i det övre högra hörnet av SQL-fragmentet. Ett popup-meddelande bekräftar att koden har kopierats.

Skärmen med körningsinformation och SQL-kopieringsikonen är markerad.

Kör information för frågor med anonymt block anonymous-block-queries

Frågor som använder anonyma block för att bilda SQL-satser separeras till sina individuella underfrågor. Genom att dela upp i underfrågor kan du inspektera körningsinformationen för varje frågeblock individuellt.

NOTE

Körningsinformationen för ett anonymt block som använder DROP-kommandot rapporteras inte som en separat underfråga. Separata körningsdetaljer finns tillgängliga för CTAS-frågor, ITAS-frågor och COPY-satser som används som anonyma blockunderfrågor. Körningsinformation för DROP-kommandot stöds för närvarande inte.

Anonyma block markeras med ett $$-prefix före frågan. Mer information om anonyma block i frågetjänsten finns i det anonyma blockdokumentet.

Anonyma blockunderfrågor har tabbar till vänster om körningsstatusen. Välj en flik för att visa körningsinformation.

Översikt över frågekörningen som visar en anonym blockfråga. Flera frågeflikar är markerade.

Om en anonym blockfråga misslyckas, kan du hitta felkoden för just det blocket via det här användargränssnittet.

Översikt över frågekörningen som visar en anonym blockfråga med felkoden för ett enskilt block markerat.

Välj Query om du vill återgå till skärmen med schemainformation eller Scheduled Queries om du vill gå tillbaka till fliken Scheduled Queries.

Skärmen med körningsinformation och frågan är markerad.

recommendation-more-help

ccf2b369-4031-483f-af63-a93b5ae5e3fb