Parametriserade frågor parameterized-queries

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.

NOTE
I Adobe Experience Platform-gränssnittet stöds parametriserade frågor bara på den överordnade nivån för textbundna mallar. Detta innebär att parametriserade frågor bara fungerar när de används i den ursprungliga mallen. Underordnade mallar måste vara en statisk mall och får inte ha dynamiska parametrar. Se dokumentation för infogade mallar om du vill veta mer.

Parametriserad frågesyntax syntax

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 create

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. Nästa steg är att välja Query parameters -fliken bredvid Console lägger till det saknade värdet för nyckeln. Frågan kan inte utföras om du inte lägger till ett värde till någon av nycklarna. En varningsikon ( En varningsikon. ) visas i avsnittet Frågeparametrar bredvid eventuella tomma Value indatafält.

NOTE
Om frågan inte innehåller några parametrar kan du ändå ange onödiga parametrar i Frågeredigeraren. Frågeredigeraren ignorerar alla onödiga nyckelvärdepar och påverkar inte körningen eller resultatet av frågan.

Frågeredigeraren med en parametriserad fråga och avsnittet Frågeparametrar markerat.

TIP
Ändra tabbar från Query parameters till Console för att visa konsolutdata för frågan.

Använd frågeloggsdetaljer för att kontrollera parametervärden check-parameter-values

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.

Vyn med frågeloggar med SQL för en parametriserad fråga markerad i informationsavsnittet.

Schemalägg en parametriserad fråga schedule

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.

TIP
Frågetjänsten stöder förberedda satser med hjälp av parametriserade frågor. Se guide för förberedda programsatser om du vill ha mer information om SQL-syntaxen.

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.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb