{"title":"Fonctions de bases de données spécifiques à PostgreSQL","version":"4.0","locale":"fr","docname":"ref/contrib/postgres/functions","url":"/fr/4.0/ref/contrib/postgres/functions/","canonical":"https://djangodocs.dev/fr/4.0/ref/contrib/postgres/functions/","summary":"Toutes ces fonctions sont disponibles dans le module django.contrib.postgres.functions.","html":"<h1>Fonctions de bases de données spécifiques à PostgreSQL<a class=\"heading-anchor\" href=\"#postgresql-specific-database-functions\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Toutes ces fonctions sont disponibles dans le module <code class=\"docutils literal notranslate\">django.contrib.postgres.functions</code>.</p>\n<section id=\"randomuuid\">\n<h2><code class=\"docutils literal notranslate\">RandomUUID</code><a class=\"heading-anchor\" href=\"#randomuuid\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.functions.RandomUUID\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">RandomUUID</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.functions.RandomUUID\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Renvoie un UUID version 4.</p>\n<p>Avec PostgreSQL &lt; 13, l”<a class=\"reference external\" href=\"https://www.postgresql.org/docs/current/pgcrypto.html\">extension pgcrypto</a> doit être installée. Vous pouvez utiliser l’opération de migration <a class=\"reference internal\" href=\"/fr/4.0/ref/contrib/postgres/operations/#django.contrib.postgres.operations.CryptoExtension\" title=\"django.contrib.postgres.operations.CryptoExtension\"><code class=\"xref py py-class docutils literal notranslate\">CryptoExtension</code></a> pour l’installer.</p>\n<p>Exemple d’utilisation :</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.postgres.functions</span> <span class=\"kn\">import</span> RandomUUID\n<span class=\"gp\">&gt;&gt;&gt; </span>Article<span class=\"o\">.</span>objects<span class=\"o\">.</span>update<span class=\"p\">(</span>uuid<span class=\"o\">=</span>RandomUUID<span class=\"p\">())</span>\n</code></pre></div>\n</section>\n<section id=\"transactionnow\">\n<h2><code class=\"docutils literal notranslate\">TransactionNow</code><a class=\"heading-anchor\" href=\"#transactionnow\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.functions.TransactionNow\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">TransactionNow</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.functions.TransactionNow\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd></dd></dl>\n\n<p>Renvoie la date et l’heure du serveur de base de données au départ de la transaction actuelle. Si vous n’êtes pas dans une transaction, elle renvoie la date et l’heure de l’instruction en cours. Il s’agit d’un complément à <a class=\"reference internal\" href=\"/fr/4.0/ref/models/database-functions/#django.db.models.functions.Now\" title=\"django.db.models.functions.Now\"><code class=\"xref py py-class docutils literal notranslate\">django.db.models.functions.Now</code></a> qui renvoie toujours la date et l’heure de l’instruction en cours.</p>\n<p>Notez que seul l’appel le plus extérieur à <a class=\"reference internal\" href=\"/fr/4.0/topics/db/transactions/#django.db.transaction.atomic\" title=\"django.db.transaction.atomic\"><code class=\"xref py py-func docutils literal notranslate\">atomic()</code></a> définit une transaction et c’est donc l’heure de ce premier appel qui sera renvoyée par <code class=\"docutils literal notranslate\">TransactionNow()</code>; les appels imbriqués créent des points de sauvegarde qui n’affectent pas l’heure de début de transaction.</p>\n<p>Exemple d’utilisation :</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"kn\">from</span> <span class=\"nn\">django.contrib.postgres.functions</span> <span class=\"kn\">import</span> TransactionNow\n<span class=\"gp\">&gt;&gt;&gt; </span>Article<span class=\"o\">.</span>objects<span class=\"o\">.</span>filter<span class=\"p\">(</span>published__lte<span class=\"o\">=</span>TransactionNow<span class=\"p\">())</span>\n<span class=\"go\">&lt;QuerySet [&lt;Article: How to Django&gt;]&gt;</span>\n</code></pre></div>\n</section>","rootId":"postgresql-specific-database-functions","toc":[{"title":"RandomUUID","anchor":"randomuuid","children":[]},{"title":"TransactionNow","anchor":"transactionnow","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/4.0/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/4.0/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/fr/4.0/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/forms","title":"Champs et composants de formulaires spécifiques à PostgreSQL","url":"/fr/4.0/ref/contrib/postgres/forms/"},"next":{"docname":"ref/contrib/postgres/indexes","title":"Index de modèles spécifiques à PostgreSQL","url":"/fr/4.0/ref/contrib/postgres/indexes/"},"formats":{"html":"/fr/4.0/ref/contrib/postgres/functions/","markdown":"/fr/4.0/ref/contrib/postgres/functions.md","json":"/fr/4.0/ref/contrib/postgres/functions.json"},"source":"https://github.com/django/django/blob/stable/4.0.x/docs/ref/contrib/postgres/functions.txt","official":"https://docs.djangoproject.com/fr/4.0/ref/contrib/postgres/functions/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}