Parametriserade frågor

Frågetjänsten stöder användning av parametriserade frågor i Frågeredigeraren. Med parametriserade frågor kan du nu använda platshållare för parametrar och lägga till parametervärden vid körning. Med platshållare kan du arbeta med dynamiska data där du inte vet vilka värden som kommer att vara förrän programsatsen har körts. Du kan också förbereda dina frågor i förväg och återanvända dem för liknande syften. Att återanvända frågor sparar mycket arbete eftersom du slipper skapa distinkta SQL-frågor för varje användningsfall.

Förutsättningar

Innan du fortsätter med den här guiden ska du läsa Användargränssnittshandbok för frågeredigeraren. Frågeredigeringsguiden ger detaljerad information om hur man skriver, validerar och kör frågor om kundupplevelsedata i användargränssnittet i Experience Platform.

Parametriserad frågesyntax

Parametriserade frågor använder formatet '$YOUR_PARAMETER_NAME' och kan sammanfogas med punktnotation. Ett exempel på en SQL-sats som använder parametriserade frågor visas nedan.

INSERT INTO
   $Database_Name.Schema_Name.adwh_lkup_process_delta_log
   (process_name, merge_policy_id, process_status, process_date, create_ts, change_ts)
SELECT
   '$Table_Process_Name' process_name,
   hash('$Merge_PolicyID') merge_policy_id,
   '$process_status' process_status,
   to_date('$date_key') process_date,
   CURRENT_TIMESTAMP create_ts,
   CURRENT_TIMESTAMP change_ts;

Skapa en parametriserad fråga

Om du vill skapa en parametriserad fråga i användargränssnittet går du till Frågeredigeraren. Se avsnittet om få åtkomst till Frågeredigeraren för fler instruktioner.

Använd '$' för att ange en frågeparameter i frågan i textredigeraren. Lägg sedan till värdet som saknas för nyckeln i Query parameters under redigeraren. Frågan kan inte utföras om du inte lägger till ett värde till någon av nycklarna. En varningsikon () visas i avsnittet Frågeparametrar bredvid eventuella tomma Value indatafält.

Om du tar bort en parameter och försöker köra frågan igen när den redan har körts visas ett felmeddelande i Query parameters för att varna dig.

Använd frågeloggsdetaljer för att kontrollera parametervärden

Du kan inte spara parametrar i mallar eftersom de värden som används inte är beständiga. Du kan dock kontrollera Query log details för att hitta parametervärdena som används i en frågekörning. I det här fallet anger loggarna inte att frågan var en parametriserad fråga. Se dokumentation för frågeloggar för instruktioner om hur du hittar de värden som används.

Schemalägg en parametriserad fråga

Parametervärden sparas när du schemalägger en parametriserad fråga. Om du vill schemalägga en parametriserad fråga följer du den vanliga processen och skapar en schemalagd fråga enligt anvisningarna i guiden för att skapa ett frågeschemaanger du sedan parametervärdena som ska användas i frågekörningen. Det här användargränssnittsavsnittet visas bara för parametriserade frågor. Se avsnittet om ställa in parametrar för en schemalagd parametriserad fråga för specifika instruktioner.

Nästa steg

Genom att läsa det här dokumentet har du lärt dig att parametrisera frågor i Adobe Experience Platform-gränssnittet och använda dem i schemalagda frågekörningar. Dokumentet visade också hur loggarna skulle kontrolleras för parametervärden som används i frågekörningar.

Därefter rekommenderar vi att du läser guiden övervaka schemalagda frågor för att få en bättre förståelse för statusen för alla frågejobb via plattformens användargränssnitt.