Pour vous aider à comprendre et à contrôler les requêtes produites par votre code, Django fournit un point d’accès pour installer des fonctions enveloppantes autour de l’exécution des requêtes de base de données. Par exemple, ces fonctions peuvent compter les requêtes, mesurer leur durée, les journaliser ou même empêcher leur exécution (par ex. pour s’assurer qu’aucune requête ne soit exécutée lors du rendu d’un gabarit avec des données préchargées.
\nLes fonctions enveloppantes sont structurées comme pour les intergiciels – il s’agit d’objets exécutables qui acceptent un autre exécutable dans l’un de leurs paramètres. Elles appellent ce dernier pour invoquer la requête de base de données (potentiellement enveloppée), et elles peuvent faire ce qu’elles veulent autour de cet appel. Elles sont cependant créées et installées par le code utilisateur, ce qui fait qu’elles n’ont pas besoin d’une fabrique distincte comme pour les intergiciels.
\nL’installation d’une fonction enveloppante se fait dans un gestionnaire de contexte, ce qui rend ces fonctions temporaires et spécifiques à un certain flux de votre code.
\nComme mentionné ci-dessus, un exemple de fonction enveloppante est un bloqueur d’exécution de requête. Voici à quoi cela pourrait ressembler
\ndef blocker(*args):\n raise Exception('No database access allowed here.')\nEt cela serait utilisé dans une vue pour bloquer les requêtes provenant d’un gabarit, comme ceci
\nfrom django.db import connection\nfrom django.shortcuts import render\n\ndef my_view(request):\n context = {...} # Code to generate context with all data.\n template_name = ...\n with connection.execute_wrapper(blocker):\n return render(request, template_name, context)\nLes paramètres envoyés à la fonction enveloppante sont :
\nexecute – un objet exécutable, qui devrait être appelé avec le reste des paramètres afin d’exécuter la requête.
sql – une chaîne str, la requête SQL qui sera envoyée à la base de données.
params – une liste (ou tuple) de paramètres à destination de la commande SQL, ou une liste de listes si l’appel enveloppé est executemany().
many – une valeur booléenne indiquant si l’appel invoqué en définitive sera execute() ou executemany() (et si params doit être une liste de valeurs ou une liste de listes de valeurs).
context – un dictionnaire avec des données supplémentaires sur le contexte de l’invocation. Cela inclut les éléments connection et cursor.
En utilisant les paramètres, une version à peine plus complexe du bloqueur pourrait inclure le nom de la connexion dans le message d’erreur
\ndef blocker(execute, sql, params, many, context):\n alias = context['connection'].alias\n raise Exception("Access to database '{}' blocked here".format(alias))\nPour un exemple plus complet, un journaliseur de requête pourrait ressembler à ceci
\nimport time\n\nclass QueryLogger:\n\n def __init__(self):\n self.queries = []\n\n def __call__(self, execute, sql, params, many, context):\n current_query = {'sql': sql, 'params': params, 'many': many}\n start = time.time()\n try:\n result = execute(sql, params, many, context)\n except Exception as e:\n current_query['status'] = 'error'\n current_query['exception'] = e\n raise\n else:\n current_query['status'] = 'ok'\n return result\n finally:\n duration = time.time() - start\n current_query['duration'] = duration\n self.queries.append(current_query)\nPour utiliser cela, il faut créer un objet de journalisation et l’installer comme enveloppeur
\nfrom django.db import connection\n\nql = QueryLogger()\nwith connection.execute_wrapper(ql):\n do_queries()\n# Now we can print the log.\nprint(ql.queries)\nconnection.execute_wrapper()Lien vers cette rubrique#Renvoie un gestionnaire de contexte qui, en entrée, installe la fonction d’enveloppement autour des exécutions de requêtes de base de données, et en sortie enlève cette fonction. La fonction d’enveloppement est installée sur l’objet connexion du fil d’exécution local.
\nwrapper est un objet exécutable acceptant cinq paramètres. Il est appelé lors de chaque exécution de requête dans la portée du gestionnaire de contexte, avec les arguments execute, sql, params, many et context, tels que décrits ci-dessus. Cet exécutable est censé appeler execute(sql, params, many, context) et renvoyer la valeur de renvoi de cet appel.