Inline-sjablonen

Met inlinesjablonen kunt u meerdere voorwaarden hergebruiken in meerdere query's. U kunt criteria in een malplaatje opslaan en dan hen opnieuw gebruiken in veelvoudige vragen. De herbruikbare SQL malplaatjes verminderen ontwikkelingsinspanningen en ook het risico van fouten van het kopiëren van lange verklaringen tussen vragen. Met gealigneerde malplaatjes, kunt u veranderingen in één plaats aanbrengen en hebben die veranderingen in om het even welke vraag weerspiegelen die naar dit malplaatje verwijst.

Dit document behandelt het gebruik en de beperkingen van gealigneerde malplaatjes binnen de Redacteur van de Vraag.

Vereisten

Inlinesjablonen worden ondersteund door zowel de UI als de API van de Query Service. Alvorens met deze gids verder te gaan, lees de documentatie over hoe te een vraagmalplaatje door APIof met de Redacteur van de Vraagcreëren.

Inline sjabloonsyntaxis syntax

Als een query eenmaal is opgeslagen, wordt deze een sjabloon genoemd. Wanneer de sjabloon naar een andere sjabloon binnen de instructie verwijst, wordt deze een inline sjabloon genoemd. Inline sjablonen worden in uw SQL aangegeven met het hashsymbool (#) gevolgd door de sjabloonnaam. Een voorbeeld van deze syntaxis is is #YOUR_TEMPLATE_NAME .

Gebruiksscenario use-case

De volgende SQL malplaatjes tonen het nut van gealigneerde malplaatjes aan, met een voorbeeld om het aantal klanten van de V.S. van om het even welk gebied te tellen die meer dan de "maximum opbrengst"besteedden en vóór Juni 2023 bevolen. Het voordeel van de inlinesjabloon is dat u de onderliggende sjabloon gemakkelijk kunt bewerken (in dit geval de maximale omzet- en besteldatum) en dat u de bovenliggende sjabloon niet hoeft te wijzigen.

Voorbeeld

#parent_template : SELECT count(*) FROM customer WHERE region=NA AND country=US AND revenue > #revenue_max
#revenue_max: SELECT max(revenue) FROM revenue_table WHERE order_date > '01-06-2023'

Wanneer het uitvoeren van de vraag, vervangt de Dienst van de Vraag de malplaatjenaam die van het knoeiboelsymbool met de genoemde SQL verklaring van het malplaatje begint.

U kunt sjablonen gebruiken om een of meerdere voorwaarden op te slaan. Ze hoeven op zich geen volledige query te zijn. Als uw malplaatje een geldige vraag bevat, kunt u de vraag eenvoudig uitvoeren door de malplaatjenaam te roepen die met een knoeiboelsymbool wordt voorafgegaan. Als u SELECT * FROM JUNE_2023_LOYALTY_MEMBERS; bijvoorbeeld hebt opgeslagen als een sjabloon met de naam JUNE_2023_LOYALTY_MEMBERS , voert de opdracht #JUNE_2023_LOYALTY_MEMBERS; de geldige query uit die zich in de sjabloon bevindt.

In de gebruikersinterface van Adobe Experience Platform worden inlinesjablonen in de vorm van geparameteriiseerde query's alleen op het hoofdniveau ondersteund. Dit betekent dat de parameters bepaalde vragen slechts werken wanneer gebruikt in het originele malplaatje. Het kindmalplaatje moet een statisch malplaatje zijn en kan geen dynamische parameters hebben. Zie de parameters bepaalde vragen documentatieom meer te leren.

Volgende stappen

Na het lezen van dit document, weet u nu hoe te om andere malplaatjes binnen uw SQL, of in de Redacteur van de Vraag of door de Dienst API van de Vraag van verwijzingen te voorzien.

Bovendien, zou u de anonieme blokgidsmoeten lezen, die verklaart hoe te om ontwikkelingsoverheadkosten te minimaliseren door één of meerdere SQL verklaringen te ketenen die in opeenvolging worden uitgevoerd.