{"title":"Fonctions d’agrégation spécifiques à PostgreSQL","version":"1.9","locale":"fr","docname":"ref/contrib/postgres/aggregates","url":"/fr/1.9/ref/contrib/postgres/aggregates/","canonical":"https://djangodocs.dev/fr/1.9/ref/contrib/postgres/aggregates/","summary":"New in Django 1.9 Ces fonctions sont décrites plus en détails dans la documentation PostgreSQL . Note Toutes ces fonctions n’ont pas d’alias par défaut, il faut…","html":"<span id=\"postgresql-specific-aggregation-functions\"></span><h1>Fonctions d’agrégation spécifiques à PostgreSQL<a class=\"heading-anchor\" href=\"#module-django.contrib.postgres.aggregates\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h1>\n<aside class=\"version-note version-added\" data-version=\"1.9\">\n<p class=\"version-note-title\">New in Django 1.9</p></aside>\n<p>Ces fonctions sont décrites plus en détails dans la <a class=\"reference external\" href=\"http://www.postgresql.org/docs/current/static/functions-aggregate.html\">documentation PostgreSQL</a>.</p>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>Toutes ces fonctions n’ont pas d’alias par défaut, il faut donc en indiquer un explicitement. Par exemple :</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=\"n\">SomeModel</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">aggregate</span><span class=\"p\">(</span><span class=\"n\">arr</span><span class=\"o\">=</span><span class=\"n\">ArrayAgg</span><span class=\"p\">(</span><span class=\"s1\">&#39;somefield&#39;</span><span class=\"p\">))</span>\n<span class=\"go\">{&#39;arr&#39;: [0, 1, 2]}</span>\n</code></pre></div>\n</aside>\n<section id=\"general-purpose-aggregation-functions\">\n<h2>Fonctions d’agrégation d’ordre général<a class=\"heading-anchor\" href=\"#general-purpose-aggregation-functions\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"arrayagg\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">ArrayAgg</span></code><a class=\"heading-anchor\" href=\"#arrayagg\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.ArrayAgg\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">ArrayAgg</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">expression</span></span></em>, <em class=\"sig-param\"><span class=\"o\"><span class=\"pre\">**</span></span><span class=\"n\"><span class=\"pre\">extra</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.ArrayAgg\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie une liste de valeurs, y compris nulles, concaténées dans un tableau.</p>\n</dd></dl>\n\n</section>\n<section id=\"bitand\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">BitAnd</span></code><a class=\"heading-anchor\" href=\"#bitand\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.BitAnd\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">BitAnd</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">expression</span></span></em>, <em class=\"sig-param\"><span class=\"o\"><span class=\"pre\">**</span></span><span class=\"n\"><span class=\"pre\">extra</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BitAnd\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie un entier <code class=\"docutils literal notranslate\"><span class=\"pre\">int</span></code> résultat de l’opération <code class=\"docutils literal notranslate\"><span class=\"pre\">AND</span></code> bit-à-bit de toutes les valeurs non nulles, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si toutes les valeurs sont nulles.</p>\n</dd></dl>\n\n</section>\n<section id=\"bitor\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">BitOr</span></code><a class=\"heading-anchor\" href=\"#bitor\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.BitOr\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">BitOr</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">expression</span></span></em>, <em class=\"sig-param\"><span class=\"o\"><span class=\"pre\">**</span></span><span class=\"n\"><span class=\"pre\">extra</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BitOr\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie un entier <code class=\"docutils literal notranslate\"><span class=\"pre\">int</span></code> résultat de l’opération <code class=\"docutils literal notranslate\"><span class=\"pre\">OR</span></code> bit-à-bit de toutes les valeurs non nulles, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si toutes les valeurs sont nulles.</p>\n</dd></dl>\n\n</section>\n<section id=\"booland\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">BoolAnd</span></code><a class=\"heading-anchor\" href=\"#booland\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.BoolAnd\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">BoolAnd</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">expression</span></span></em>, <em class=\"sig-param\"><span class=\"o\"><span class=\"pre\">**</span></span><span class=\"n\"><span class=\"pre\">extra</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BoolAnd\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code> si toutes les valeurs d’entrée sont vraies, <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si toutes les valeurs sont nulles ou s’il n’y a pas de valeur, sinon renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">False</span></code>.</p>\n</dd></dl>\n\n</section>\n<section id=\"boolor\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">BoolOr</span></code><a class=\"heading-anchor\" href=\"#boolor\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.BoolOr\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">BoolOr</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">expression</span></span></em>, <em class=\"sig-param\"><span class=\"o\"><span class=\"pre\">**</span></span><span class=\"n\"><span class=\"pre\">extra</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BoolOr\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">True</span></code> si au moins une valeur d’entrée est vraie, <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si toutes les valeurs sont nulles ou s’il n’y a pas de valeur, sinon renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">False</span></code>.</p>\n</dd></dl>\n\n</section>\n<section id=\"stringagg\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">StringAgg</span></code><a class=\"heading-anchor\" href=\"#stringagg\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.StringAgg\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">StringAgg</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">expression</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">delimiter</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.StringAgg\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie les valeurs d’entrée concaténées dans une chaîne, séparées par la chaîne <code class=\"docutils literal notranslate\"><span class=\"pre\">delimiter</span></code>.</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.StringAgg.delimiter\">\n<span class=\"sig-name descname\"><span class=\"pre\">delimiter</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.StringAgg.delimiter\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Paramètre obligatoire. Doit être une chaîne.</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n</section>\n<section id=\"aggregate-functions-for-statistics\">\n<h2>Fonctions d’agrégation à but statistique<a class=\"heading-anchor\" href=\"#aggregate-functions-for-statistics\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"y-and-x\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">y</span></code> et <code class=\"docutils literal notranslate\"><span class=\"pre\">x</span></code><a class=\"heading-anchor\" href=\"#y-and-x\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Les paramètres <code class=\"docutils literal notranslate\"><span class=\"pre\">y</span></code> et <code class=\"docutils literal notranslate\"><span class=\"pre\">x</span></code> de toutes ces fonctions peuvent être un nom de champ ou une expression renvoyant une donnée numérique. Les deux sont obligatoires.</p>\n</section>\n<section id=\"corr\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">Corr</span></code><a class=\"heading-anchor\" href=\"#corr\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.Corr\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">Corr</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.Corr\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie le coefficient de corrélation sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n<section id=\"covarpop\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">CovarPop</span></code><a class=\"heading-anchor\" href=\"#covarpop\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.CovarPop\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">CovarPop</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">sample</span></span><span class=\"o\"><span class=\"pre\">=</span></span><span class=\"default_value\"><span class=\"pre\">False</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.CovarPop\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie la covariance de population sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n<p>Accepte un paramètre facultatif :</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.CovarPop.sample\">\n<span class=\"sig-name descname\"><span class=\"pre\">sample</span></span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.CovarPop.sample\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Par défaut, <code class=\"docutils literal notranslate\"><span class=\"pre\">CovarPop</span></code> renvoie la covariance de population générale. Cependant, si <code class=\"docutils literal notranslate\"><span class=\"pre\">sample=True</span></code>, la valeur renvoyée sera la covariance d’échantillon de population.</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"regravgx\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrAvgX</span></code><a class=\"heading-anchor\" href=\"#regravgx\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrAvgX\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrAvgX</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrAvgX\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie la moyenne de la variable indépendante (<code class=\"docutils literal notranslate\"><span class=\"pre\">sum(x)/N</span></code>) sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n<section id=\"regravgy\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrAvgY</span></code><a class=\"heading-anchor\" href=\"#regravgy\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrAvgY\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrAvgY</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrAvgY\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Returns the average of the dependent variable (<code class=\"docutils literal notranslate\"><span class=\"pre\">sum(y)/N</span></code>) as a\n<code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, or <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> if there aren’t any matching rows.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrcount\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrCount</span></code><a class=\"heading-anchor\" href=\"#regrcount\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrCount\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrCount</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrCount\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie un entier <code class=\"docutils literal notranslate\"><span class=\"pre\">int</span></code> correspondant au nombre de lignes d’entrée dans lesquelles les deux expressions ne sont pas nulles.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrintercept\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrIntercept</span></code><a class=\"heading-anchor\" href=\"#regrintercept\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrIntercept\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrIntercept</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrIntercept\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie l’interception de l’axe y pour l’équation linéaire de la méthode des moindres carrés déterminée par les paires <code class=\"docutils literal notranslate\"><span class=\"pre\">(x,</span> <span class=\"pre\">y)</span></code> sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrr2\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrR2</span></code><a class=\"heading-anchor\" href=\"#regrr2\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrR2\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrR2</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrR2\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Returns the square of the correlation coefficient as a <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, or\n<code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> if there aren’t any matching rows.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrslope\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrSlope</span></code><a class=\"heading-anchor\" href=\"#regrslope\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrSlope\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrSlope</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSlope\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie l’inclinaison pour l’équation linéaire de la méthode des moindres carrés déterminée par les paires <code class=\"docutils literal notranslate\"><span class=\"pre\">(x,</span> <span class=\"pre\">y)</span></code> sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrsxx\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrSXX</span></code><a class=\"heading-anchor\" href=\"#regrsxx\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrSXX\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrSXX</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSXX\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">sum(x^2)</span> <span class=\"pre\">-</span> <span class=\"pre\">sum(x)^2/N</span></code> (« somme des carrés » de la variable indépendante) sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrsxy\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrSXY</span></code><a class=\"heading-anchor\" href=\"#regrsxy\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrSXY\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrSXY</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSXY\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">sum(x*y)</span> <span class=\"pre\">-</span> <span class=\"pre\">sum(x)</span> <span class=\"pre\">*</span> <span class=\"pre\">sum(y)/N</span></code> (« somme des produits » de la variable indépendante multipliée par la variable dépendante) sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n<section id=\"regrsyy\">\n<h3><code class=\"docutils literal notranslate\"><span class=\"pre\">RegrSYY</span></code><a class=\"heading-anchor\" href=\"#regrsyy\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h3>\n<dl class=\"py class\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.RegrSYY\">\n<em class=\"property\"><span class=\"k\"><span class=\"pre\">class</span></span><span class=\"w\"> </span></em><span class=\"sig-name descname\"><span class=\"pre\">RegrSYY</span></span><span class=\"sig-paren\">(</span><em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">y</span></span></em>, <em class=\"sig-param\"><span class=\"n\"><span class=\"pre\">x</span></span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSYY\"><span class=\"visually-hidden\">Lien vers cette définition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>Renvoie <code class=\"docutils literal notranslate\"><span class=\"pre\">sum(y^2)</span> <span class=\"pre\">-</span> <span class=\"pre\">sum(y)^2/N</span></code> (« somme des carrés » de la variable dépendante) sous forme de nombre <code class=\"docutils literal notranslate\"><span class=\"pre\">float</span></code>, ou <code class=\"docutils literal notranslate\"><span class=\"pre\">None</span></code> si aucune ligne ne correspond.</p>\n</dd></dl>\n\n</section>\n</section>\n<section id=\"usage-examples\">\n<h2>Exemples d’utilisation<a class=\"heading-anchor\" href=\"#usage-examples\"><span class=\"visually-hidden\">Lien vers cette rubrique</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Nous allons utiliser cette table d’exemple :</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=\"o\">|</span> <span class=\"n\">FIELD1</span> <span class=\"o\">|</span> <span class=\"n\">FIELD2</span> <span class=\"o\">|</span> <span class=\"n\">FIELD3</span> <span class=\"o\">|</span>\n<span class=\"o\">|--------|--------|--------|</span>\n<span class=\"o\">|</span>    <span class=\"n\">foo</span> <span class=\"o\">|</span>      <span class=\"mi\">1</span> <span class=\"o\">|</span>     <span class=\"mi\">13</span> <span class=\"o\">|</span>\n<span class=\"o\">|</span>    <span class=\"n\">bar</span> <span class=\"o\">|</span>      <span class=\"mi\">2</span> <span class=\"o\">|</span> <span class=\"p\">(</span><span class=\"n\">null</span><span class=\"p\">)</span> <span class=\"o\">|</span>\n<span class=\"o\">|</span>   <span class=\"n\">test</span> <span class=\"o\">|</span>      <span class=\"mi\">3</span> <span class=\"o\">|</span>     <span class=\"mi\">13</span> <span class=\"o\">|</span>\n</code></pre></div>\n<p>Voici quelques exemples de certaines des fonctions d’agrégation d’ordre général :</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=\"n\">TestModel</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">aggregate</span><span class=\"p\">(</span><span class=\"n\">result</span><span class=\"o\">=</span><span class=\"n\">StringAgg</span><span class=\"p\">(</span><span class=\"s1\">&#39;field1&#39;</span><span class=\"p\">,</span> <span class=\"n\">delimiter</span><span class=\"o\">=</span><span class=\"s1\">&#39;;&#39;</span><span class=\"p\">))</span>\n<span class=\"go\">{&#39;result&#39;: &#39;foo;bar;test&#39;}</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">TestModel</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">aggregate</span><span class=\"p\">(</span><span class=\"n\">result</span><span class=\"o\">=</span><span class=\"n\">ArrayAgg</span><span class=\"p\">(</span><span class=\"s1\">&#39;field2&#39;</span><span class=\"p\">))</span>\n<span class=\"go\">{&#39;result&#39;: [1, 2, 3]}</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">TestModel</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">aggregate</span><span class=\"p\">(</span><span class=\"n\">result</span><span class=\"o\">=</span><span class=\"n\">ArrayAgg</span><span class=\"p\">(</span><span class=\"s1\">&#39;field1&#39;</span><span class=\"p\">))</span>\n<span class=\"go\">{&#39;result&#39;: [&#39;foo&#39;, &#39;bar&#39;, &#39;test&#39;]}</span>\n</code></pre></div>\n<p>L’exemple suivant montre l’utilisation des fonctions d’agrégats pour les statistiques. Les mathématiques sous-jacentes ne sont pas expliquées (vous pouvez vous renseigner à ce sujet sur <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>Wikipédia &lt;<a class=\"reference external\" href=\"https://fr.wikipedia.org/wiki\">https://fr.wikipedia.org/wiki</a>/Régression_(statistiques)&gt; <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>_ par exemple) :</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=\"n\">TestModel</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">aggregate</span><span class=\"p\">(</span><span class=\"n\">count</span><span class=\"o\">=</span><span class=\"n\">RegrCount</span><span class=\"p\">(</span><span class=\"n\">y</span><span class=\"o\">=</span><span class=\"s1\">&#39;field3&#39;</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"o\">=</span><span class=\"s1\">&#39;field2&#39;</span><span class=\"p\">))</span>\n<span class=\"go\">{&#39;count&#39;: 2}</span>\n<span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">TestModel</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">aggregate</span><span class=\"p\">(</span><span class=\"n\">avgx</span><span class=\"o\">=</span><span class=\"n\">RegrAvgX</span><span class=\"p\">(</span><span class=\"n\">y</span><span class=\"o\">=</span><span class=\"s1\">&#39;field3&#39;</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"o\">=</span><span class=\"s1\">&#39;field2&#39;</span><span class=\"p\">),</span>\n<span class=\"gp\">... </span>                            <span class=\"n\">avgy</span><span class=\"o\">=</span><span class=\"n\">RegrAvgY</span><span class=\"p\">(</span><span class=\"n\">y</span><span class=\"o\">=</span><span class=\"s1\">&#39;field3&#39;</span><span class=\"p\">,</span> <span class=\"n\">x</span><span class=\"o\">=</span><span class=\"s1\">&#39;field2&#39;</span><span class=\"p\">))</span>\n<span class=\"go\">{&#39;avgx&#39;: 2, &#39;avgy&#39;: 13}</span>\n</code></pre></div>\n</section>","rootId":"module-django.contrib.postgres.aggregates","toc":[{"title":"Fonctions d’agrégation d’ordre général","anchor":"general-purpose-aggregation-functions","children":[{"title":"ArrayAgg","anchor":"arrayagg","children":[]},{"title":"BitAnd","anchor":"bitand","children":[]},{"title":"BitOr","anchor":"bitor","children":[]},{"title":"BoolAnd","anchor":"booland","children":[]},{"title":"BoolOr","anchor":"boolor","children":[]},{"title":"StringAgg","anchor":"stringagg","children":[]}]},{"title":"Fonctions d’agrégation à but statistique","anchor":"aggregate-functions-for-statistics","children":[{"title":"y et x","anchor":"y-and-x","children":[]},{"title":"Corr","anchor":"corr","children":[]},{"title":"CovarPop","anchor":"covarpop","children":[]},{"title":"RegrAvgX","anchor":"regravgx","children":[]},{"title":"RegrAvgY","anchor":"regravgy","children":[]},{"title":"RegrCount","anchor":"regrcount","children":[]},{"title":"RegrIntercept","anchor":"regrintercept","children":[]},{"title":"RegrR2","anchor":"regrr2","children":[]},{"title":"RegrSlope","anchor":"regrslope","children":[]},{"title":"RegrSXX","anchor":"regrsxx","children":[]},{"title":"RegrSXY","anchor":"regrsxy","children":[]},{"title":"RegrSYY","anchor":"regrsyy","children":[]}]},{"title":"Exemples d’utilisation","anchor":"usage-examples","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/1.9/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/1.9/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/fr/1.9/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/fr/1.9/ref/contrib/postgres/"},"next":{"docname":"ref/contrib/postgres/fields","title":"Champs de modèles spécifiques à PostgreSQL","url":"/fr/1.9/ref/contrib/postgres/fields/"},"formats":{"html":"/fr/1.9/ref/contrib/postgres/aggregates/","markdown":"/fr/1.9/ref/contrib/postgres/aggregates.md","json":"/fr/1.9/ref/contrib/postgres/aggregates.json"},"source":"https://github.com/django/django/blob/stable/1.9.x/docs/ref/contrib/postgres/aggregates.txt","official":"https://docs.djangoproject.com/fr/1.9/ref/contrib/postgres/aggregates/","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","fr","ja","id","pt-br","es"]}