Modelli in linea

I modelli in linea consentono di riutilizzare più condizioni in numerose query. È possibile salvare i criteri in un modello e quindi riutilizzarli in più query. I modelli SQL riutilizzabili riducono le attività di sviluppo e il rischio di errori nella copia di istruzioni lunghe tra le query. Con i modelli in linea, è possibile apportare modifiche in una posizione e far sì che tali modifiche vengano applicate a qualsiasi query che fa riferimento a questo modello.

Questo documento descrive l’utilizzo e le limitazioni dei modelli in linea all’interno dell’editor delle query.

Prerequisiti

I modelli in linea sono supportati sia dall’interfaccia utente che dall’API Query Service. Prima di continuare con questa guida, leggere la documentazione su come creare un modello di query tramite l'API o con Editor query.

Sintassi del modello in linea

Una volta salvata, una query viene definita modello. Quando il modello fa riferimento a un altro modello all’interno dell’istruzione, viene denominato modello in linea. I modelli in linea sono indicati nel codice SQL utilizzando il simbolo hash (#) seguito dal nome del modello. Esempio di sintassi: #YOUR_TEMPLATE_NAME.

Caso d’uso

I seguenti modelli SQL dimostrano l’utilità dei modelli in linea, con un esempio per contare il numero di clienti statunitensi da qualsiasi area geografica che hanno speso più del "ricavo massimo" e hanno ordinato prima di giugno 2023. Il vantaggio del modello in linea è che è possibile modificare facilmente il modello figlio (in questo caso il ricavo massimo e la data dell’ordine) e non dover modificare il modello padre.

Esempio

Durante l’esecuzione della query, Query Service sostituisce il nome del modello a partire dal simbolo hash con l’istruzione SQL del modello denominato.

È possibile utilizzare i modelli per memorizzare una o più condizioni. Non è necessario che siano query complete di per sé. Se il modello contiene una query valida, è possibile eseguirla semplicemente chiamando il nome del modello preceduto da un simbolo hash. Se ad esempio si archivia SELECT * FROM JUNE_2023_LOYALTY_MEMBERS; come modello denominato JUNE_2023_LOYALTY_MEMBERS, il comando #JUNE_2023_LOYALTY_MEMBERS; eseguirà la query valida contenuta nel modello.

Nell’interfaccia utente di Adobe Experience Platform, i modelli in linea sotto forma di query con parametri sono supportati solo a livello principale. Ciò significa che le query con parametri funzionano solo se utilizzate nel modello originale. Il modello figlio deve essere statico e non può avere parametri dinamici. Per ulteriori informazioni, consulta la documentazione sulle query con parametri.