Requêtes paramétrées parameterized-queries
Query Service prend en charge l’utilisation de requêtes paramétrées dans Query Editor. Avec les requêtes paramétrées, vous pouvez désormais utiliser des espaces réservés pour les paramètres et ajouter les valeurs de paramètre au moment de l’exécution. Les espaces réservés vous permettent de travailler avec des données dynamiques dont vous ne savez pas quelles seront les valeurs tant que l’instruction n’aura pas été exécutée. Vous pouvez également préparer vos requêtes à l’avance et les réutiliser à des fins similaires. La réutilisation des requêtes permet d’économiser un effort considérable, car vous évitez de créer des requêtes SQL distinctes pour chaque cas d’utilisation.
Conditions préalables
Avant de poursuivre avec ce guide, lisez le Guide de l’interface utilisateur de Query Editor. Le guide de Query Editor fournit des informations détaillées sur la manière d’écrire, de valider et d’exécuter des requêtes pour les données d’expérience client dans l’interface utilisateur d’Experience Platform.
Syntaxe de requête paramétrée syntax
Les requêtes paramétrées utilisent le format '$YOUR_PARAMETER_NAME' et peuvent être concaténées à l’aide de la notation par points. Vous trouverez ci-dessous un exemple d’instruction SQL qui utilise des requêtes paramétrées.
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;
Création d’une requête paramétrée create
Pour créer votre requête paramétrée dans l’interface utilisateur, accédez à l’éditeur de requêtes. Pour plus d’instructions, consultez la section relative à accès à Query Editor.
Utilisez la préface '$' pour saisir un paramètre de requête dans l’éditeur de texte. Sélectionnez ensuite l’onglet Paramètres de requête à côté de la Console et ajoutez la valeur manquante pour la clé. La requête ne peut pas être exécutée si vous omettez d’ajouter une valeur à l’une des clés requises. Une icône d’alerte (
Utiliser les détails des journaux de requête pour vérifier les valeurs de paramètre check-parameter-values
Vous ne pouvez pas enregistrer de paramètres dans les modèles, car les valeurs utilisées ne sont pas persistantes. Cependant, vous pouvez consulter la page Détails du journal de requête pour trouver les valeurs de paramètre utilisées dans une exécution de requête. Dans ce cas, les journaux n’indiquent pas que la requête était une requête paramétrée. Consultez la documentation sur les journaux de requêtes pour obtenir des instructions sur la manière de trouver les valeurs utilisées.
Planifier une requête paramétrée schedule
Les valeurs de paramètre sont enregistrées lorsque vous planifiez une requête paramétrée. Pour planifier une requête paramétrée, suivez le processus standard de création d’une requête planifiée comme décrit dans le guide de création d’un planning de requête, puis saisissez les valeurs de paramètre à utiliser dans l’exécution de la requête. Cette section de l’interface utilisateur s’affiche uniquement pour les requêtes paramétrées. Pour obtenir des instructions spécifiques, reportez-vous à la section Définition des paramètres d’une requête paramétrée planifiée.
Étapes suivantes
En lisant ce document, vous avez appris à paramétrer les requêtes dans l’interface utilisateur de Adobe Experience Platform et à les utiliser dans des exécutions de requêtes planifiées. Le document a également mis en évidence comment vérifier les journaux pour les valeurs de paramètre utilisées dans les exécutions de requête.
Nous vous recommandons ensuite de lire le guide sur la surveillance des requêtes planifiées pour mieux comprendre le statut de tous les traitements de requêtes via l’interface utilisateur d’Experience Platform.