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 d’utiliser des données dynamiques dans lesquelles vous ne savez pas quelles seront les valeurs tant que l’instruction n’est pas exécutée. Vous pouvez également préparer vos requêtes à l’avance et les réutiliser à des fins similaires. La réutilisation de 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 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 de l’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éer 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’informations, reportez-vous à la section sur l’ accès à l’éditeur de requêtes .
Utilisez la préface '$' pour saisir un paramètre de requête dans l’éditeur de texte. Ensuite, sélectionnez l’onglet Paramètres de requête en regard de la Console pour ajouter la valeur manquante pour la clé. La requête ne peut pas être exécutée si vous négligez d’ajouter une valeur à l’une des clés requises. Icône d’alerte (
Utiliser les détails des logs de requête pour vérifier les valeurs des paramètres 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 logs n'indiquent pas que la requête était paramétrée. Pour obtenir des instructions sur la recherche des valeurs utilisées, reportez-vous à la documentation sur les journaux de requête.
Planification d’une requête paramétrée schedule
Les valeurs des paramètres sont enregistrées lorsque vous planifiez une requête paramétrée. Pour planifier une requête paramétrée, suivez le processus type pour créer une requête planifiée comme décrit dans le guide créer 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 sur la définition des paramètres pour une requête paramétrée planifiée .
Étapes suivantes
En lisant ce document, vous avez appris à paramétrer des 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 la manière de vérifier les journaux pour les valeurs de paramètre utilisées dans les exécutions de requête.
Ensuite, il est recommandé de lire le guide sur la surveillance des requêtes planifiées pour mieux comprendre l’état de toutes les tâches de requête via l’interface utilisateur de Platform.