Syntaxe de requête paramétrée

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

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 ( une icône d’alerte. ) apparaît dans la section Paramètres de requête en regard de tout champ d’entrée Valeur vide.

NOTE
Si votre requête ne prend pas de paramètres, vous pouvez toujours saisir des paramètres inutiles dans l’éditeur de requêtes. Le Query Editor ignore toutes les paires clé-valeur inutiles et elles n’ont aucun effet sur l’exécution ou les résultats de la requête.

Query Editor avec une requête paramétrée et la section Paramètres de requête mise en surbrillance.

TIP
Remplacez les onglets Paramètres de requête par Console pour afficher la sortie console de la requête.

Utiliser les détails des journaux de requête pour vérifier les valeurs de paramètre

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.

La vue des logs de requête avec le SQL d’une requête paramétrée mise en surbrillance dans la section détails.

Planifier une requête paramétrée

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.

TIP
Query Service prend en charge les instructions préparées à l’aide de requêtes paramétrées. Pour plus d’informations sur la syntaxe SQL impliquée🔗 consultez le guide de syntaxe des instructions préparées .