{"title":"PostgreSQL 特有聚合函数","version":"3.1","locale":"zh-hans","docname":"ref/contrib/postgres/aggregates","url":"/zh-hans/3.1/ref/contrib/postgres/aggregates/","canonical":"https://djangodocs.dev/zh-hans/3.1/ref/contrib/postgres/aggregates/","summary":"这些功能可以从 django.contrib.postgres.aggregates 模块中获得。在 PostgreSQL docs 中对这些功能有更详细的描述。","html":"<span id=\"postgresql-specific-aggregation-functions\"></span><h1>PostgreSQL 特有聚合函数<a class=\"heading-anchor\" href=\"#module-django.contrib.postgres.aggregates\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>这些功能可以从 <code class=\"docutils literal notranslate\">django.contrib.postgres.aggregates</code> 模块中获得。在 <a class=\"reference external\" href=\"https://www.postgresql.org/docs/current/functions-aggregate.html\">PostgreSQL docs</a> 中对这些功能有更详细的描述。</p>\n<aside class=\"admonition admonition-note\" role=\"note\">\n<p class=\"admonition-title\">Note</p>\n<p>所有的函数都没有默认的别名，所以你必须明确提供一个别名。例如：</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>SomeModel<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>arr<span class=\"o\">=</span>ArrayAgg<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<aside class=\"admonition-common-aggregate-options admonition\" role=\"note\">\n<p class=\"admonition-title\">通用聚合选项</p>\n<p>所有聚合体都有 <a class=\"reference internal\" href=\"/zh-hans/3.1/ref/models/querysets/#aggregate-filter\"><span class=\"std std-ref\">filter</span></a> 关键字参数。</p>\n</aside>\n<section id=\"general-purpose-aggregation-functions\">\n<h2>通用聚合函数<a class=\"heading-anchor\" href=\"#general-purpose-aggregation-functions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"arrayagg\">\n<h3><code class=\"docutils literal notranslate\">ArrayAgg</code><a class=\"heading-anchor\" href=\"#arrayagg\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">ArrayAgg</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expression</em>, <em class=\"sig-param\">distinct<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">ordering<span class=\"o\">=</span><span class=\"default_value\">()</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>extra</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.ArrayAgg\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回一个值的列表，包括空值，连接成一个数组。</p>\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.ArrayAgg.distinct\">\n<span class=\"sig-name descname\">distinct</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.ArrayAgg.distinct\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>一个可选的布尔参数，用于确定数组值是否会被去重。默认值为 <code class=\"docutils literal notranslate\">False</code>。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.ArrayAgg.ordering\">\n<span class=\"sig-name descname\">ordering</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.ArrayAgg.ordering\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>可选的字段名字符串（可选的 <code class=\"docutils literal notranslate\">&quot;-&quot;</code> 前缀表示降序）或表达式（或字符串和／或表达式的元组或列表），指定结果列表中元素的顺序。</p>\n<p>举例：</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=\"s1\">&#39;some_field&#39;</span>\n<span class=\"s1\">&#39;-some_field&#39;</span>\n<span class=\"kn\">from</span> <span class=\"nn\">django.db.models</span> <span class=\"kn\">import</span> F\nF<span class=\"p\">(</span><span class=\"s1\">&#39;some_field&#39;</span><span class=\"p\">)</span><span class=\"o\">.</span>desc<span class=\"p\">()</span>\n</code></pre></div>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"bitand\">\n<h3><code class=\"docutils literal notranslate\">BitAnd</code><a class=\"heading-anchor\" href=\"#bitand\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">BitAnd</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expression</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>extra</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BitAnd\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回所有非空输入值的位式 <code class=\"docutils literal notranslate\">AND</code> 的 <code class=\"docutils literal notranslate\">int</code>，如果所有值为空，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"bitor\">\n<h3><code class=\"docutils literal notranslate\">BitOr</code><a class=\"heading-anchor\" href=\"#bitor\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">BitOr</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expression</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>extra</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BitOr\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回所有非空输入值的位式 <code class=\"docutils literal notranslate\">OR</code> 的 <code class=\"docutils literal notranslate\">int</code>，如果所有值为空，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"booland\">\n<h3><code class=\"docutils literal notranslate\">BoolAnd</code><a class=\"heading-anchor\" href=\"#booland\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">BoolAnd</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expression</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>extra</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BoolAnd\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>如果所有输入值为真，返回 <code class=\"docutils literal notranslate\">True</code>，如果所有值为空或没有值，返回 <code class=\"docutils literal notranslate\">None</code>，否则返回 <code class=\"docutils literal notranslate\">False</code>。</p>\n<p>使用实例：</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=\"k\">class</span> <span class=\"nc\">Comment</span><span class=\"p\">(</span>models<span class=\"o\">.</span>Model<span class=\"p\">):</span>\n    body <span class=\"o\">=</span> models<span class=\"o\">.</span>TextField<span class=\"p\">()</span>\n    published <span class=\"o\">=</span> models<span class=\"o\">.</span>BooleanField<span class=\"p\">()</span>\n    rank <span class=\"o\">=</span> models<span class=\"o\">.</span>IntegerField<span class=\"p\">()</span>\n\n<span class=\"o\">&gt;&gt;&gt;</span> <span class=\"kn\">from</span> <span class=\"nn\">django.db.models</span> <span class=\"kn\">import</span> BooleanField<span class=\"p\">,</span> Q\n<span class=\"o\">&gt;&gt;&gt;</span> <span class=\"kn\">from</span> <span class=\"nn\">django.contrib.postgres.aggregates</span> <span class=\"kn\">import</span> BoolAnd\n<span class=\"o\">&gt;&gt;&gt;</span> Comment<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>booland<span class=\"o\">=</span>BoolAnd<span class=\"p\">(</span><span class=\"s1\">&#39;published&#39;</span><span class=\"p\">))</span>\n<span class=\"p\">{</span><span class=\"s1\">&#39;booland&#39;</span><span class=\"p\">:</span> <span class=\"kc\">False</span><span class=\"p\">}</span>\n<span class=\"o\">&gt;&gt;&gt;</span> Comment<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>booland<span class=\"o\">=</span>BoolAnd<span class=\"p\">(</span>Q<span class=\"p\">(</span>rank__lt<span class=\"o\">=</span><span class=\"mi\">100</span><span class=\"p\">),</span> output_field<span class=\"o\">=</span>BooleanField<span class=\"p\">()))</span>\n<span class=\"p\">{</span><span class=\"s1\">&#39;booland&#39;</span><span class=\"p\">:</span> <span class=\"kc\">True</span><span class=\"p\">}</span>\n</code></pre></div>\n</dd></dl>\n\n</section>\n<section id=\"boolor\">\n<h3><code class=\"docutils literal notranslate\">BoolOr</code><a class=\"heading-anchor\" href=\"#boolor\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">BoolOr</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expression</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>extra</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.BoolOr\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>如果所有输入值为真，返回 <code class=\"docutils literal notranslate\">True</code>，如果所有值为空或没有值，返回 <code class=\"docutils literal notranslate\">None</code>，否则返回 <code class=\"docutils literal notranslate\">False</code>。</p>\n<p>使用实例：</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=\"k\">class</span> <span class=\"nc\">Comment</span><span class=\"p\">(</span>models<span class=\"o\">.</span>Model<span class=\"p\">):</span>\n    body <span class=\"o\">=</span> models<span class=\"o\">.</span>TextField<span class=\"p\">()</span>\n    published <span class=\"o\">=</span> models<span class=\"o\">.</span>BooleanField<span class=\"p\">()</span>\n    rank <span class=\"o\">=</span> models<span class=\"o\">.</span>IntegerField<span class=\"p\">()</span>\n\n<span class=\"o\">&gt;&gt;&gt;</span> <span class=\"kn\">from</span> <span class=\"nn\">django.db.models</span> <span class=\"kn\">import</span> BooleanField<span class=\"p\">,</span> Q\n<span class=\"o\">&gt;&gt;&gt;</span> <span class=\"kn\">from</span> <span class=\"nn\">django.contrib.postgres.aggregates</span> <span class=\"kn\">import</span> BoolOr\n<span class=\"o\">&gt;&gt;&gt;</span> Comment<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>boolor<span class=\"o\">=</span>BoolOr<span class=\"p\">(</span><span class=\"s1\">&#39;published&#39;</span><span class=\"p\">))</span>\n<span class=\"p\">{</span><span class=\"s1\">&#39;boolor&#39;</span><span class=\"p\">:</span> <span class=\"kc\">True</span><span class=\"p\">}</span>\n<span class=\"o\">&gt;&gt;&gt;</span> Comment<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>boolor<span class=\"o\">=</span>BoolOr<span class=\"p\">(</span>Q<span class=\"p\">(</span>rank__gt<span class=\"o\">=</span><span class=\"mi\">2</span><span class=\"p\">),</span> output_field<span class=\"o\">=</span>BooleanField<span class=\"p\">()))</span>\n<span class=\"p\">{</span><span class=\"s1\">&#39;boolor&#39;</span><span class=\"p\">:</span> <span class=\"kc\">False</span><span class=\"p\">}</span>\n</code></pre></div>\n</dd></dl>\n\n</section>\n<section id=\"jsonbagg\">\n<h3><code class=\"docutils literal notranslate\">JSONBAgg</code><a class=\"heading-anchor\" href=\"#jsonbagg\"><span class=\"visually-hidden\">Link to this heading</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.JSONBAgg\">\n<em class=\"property\"><span class=\"k\">class</span> </em><span class=\"sig-name descname\">JSONBAgg</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expressions</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\"><span class=\"o\">**</span>extra</em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.JSONBAgg\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>将输入值以 <code class=\"docutils literal notranslate\">JSON</code> 数组形式返回。</p>\n</dd></dl>\n\n</section>\n<section id=\"stringagg\">\n<h3><code class=\"docutils literal notranslate\">StringAgg</code><a class=\"heading-anchor\" href=\"#stringagg\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">StringAgg</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">expression</em>, <em class=\"sig-param\">delimiter</em>, <em class=\"sig-param\">distinct<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em>, <em class=\"sig-param\">ordering<span class=\"o\">=</span><span class=\"default_value\">()</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.StringAgg\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回连接成一个字符串的输入值，用 <code class=\"docutils literal notranslate\">delimiter</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\">delimiter</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.StringAgg.delimiter\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>必要参数。需要是一个字符串。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.StringAgg.distinct\">\n<span class=\"sig-name descname\">distinct</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.StringAgg.distinct\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>一个可选的布尔参数，用于确定连接的值是否是不同的。默认值为 <code class=\"docutils literal notranslate\">False</code>。</p>\n</dd></dl>\n\n<dl class=\"py attribute\">\n<dt class=\"sig sig-object py\" id=\"django.contrib.postgres.aggregates.StringAgg.ordering\">\n<span class=\"sig-name descname\">ordering</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.StringAgg.ordering\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>可选的字段名字符串（可选的 <code class=\"docutils literal notranslate\">&quot;-&quot;</code> 前缀表示降序）或表达式（或字符串和／或表达式的元组或列表），指定结果字符串中元素的顺序。</p>\n<p>例子与 <a class=\"reference internal\" href=\"#django.contrib.postgres.aggregates.ArrayAgg.ordering\" title=\"django.contrib.postgres.aggregates.ArrayAgg.ordering\"><code class=\"xref py py-attr docutils literal notranslate\">ArrayAgg.ordering</code></a> 相同。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n</section>\n<section id=\"aggregate-functions-for-statistics\">\n<h2>统计的聚合功能<a class=\"heading-anchor\" href=\"#aggregate-functions-for-statistics\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"y-and-x\">\n<h3><code class=\"docutils literal notranslate\">y</code> 和 <code class=\"docutils literal notranslate\">x</code><a class=\"heading-anchor\" href=\"#y-and-x\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>所有这些函数的参数 <code class=\"docutils literal notranslate\">y</code> 和 <code class=\"docutils literal notranslate\">x</code> 可以是字段名或返回数值数据的表达式。这两个参数都是必须的。</p>\n</section>\n<section id=\"corr\">\n<h3><code class=\"docutils literal notranslate\">Corr</code><a class=\"heading-anchor\" href=\"#corr\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">Corr</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.Corr\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回相关系数为 <code class=\"docutils literal notranslate\">float</code>，如果没有任何匹配的记录，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"covarpop\">\n<h3><code class=\"docutils literal notranslate\">CovarPop</code><a class=\"heading-anchor\" href=\"#covarpop\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">CovarPop</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">sample<span class=\"o\">=</span><span class=\"default_value\">False</span></em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.CovarPop\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回总体方差的 <code class=\"docutils literal notranslate\">float</code>，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n<p>包含一个可选参数：</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\">sample</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.CovarPop.sample\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>默认情况下，<code class=\"docutils literal notranslate\">CovarPop</code> 返回一般总体协方差。但是，如果 <code class=\"docutils literal notranslate\">sample=True</code>，返回值将是样本总体协方差。</p>\n</dd></dl>\n\n</dd></dl>\n\n</section>\n<section id=\"regravgx\">\n<h3><code class=\"docutils literal notranslate\">RegrAvgX</code><a class=\"heading-anchor\" href=\"#regravgx\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrAvgX</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrAvgX\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回自变量的平均值（<code class=\"docutils literal notranslate\">sum(x)/N</code>），作为 <code class=\"docutils literal notranslate\">float</code>，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regravgy\">\n<h3><code class=\"docutils literal notranslate\">RegrAvgY</code><a class=\"heading-anchor\" href=\"#regravgy\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrAvgY</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrAvgY\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回因变量的平均数（<code class=\"docutils literal notranslate\">sum(y)/N</code>），作为 <code class=\"docutils literal notranslate\">float</code>，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrcount\">\n<h3><code class=\"docutils literal notranslate\">RegrCount</code><a class=\"heading-anchor\" href=\"#regrcount\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrCount</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrCount\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回两个表达式都不为空的输入行数的 <code class=\"docutils literal notranslate\">int</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrintercept\">\n<h3><code class=\"docutils literal notranslate\">RegrIntercept</code><a class=\"heading-anchor\" href=\"#regrintercept\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrIntercept</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrIntercept\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回由 <code class=\"docutils literal notranslate\">(x, y)</code> 对确定的最小二乘拟合线性方程的 y 截距，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrr2\">\n<h3><code class=\"docutils literal notranslate\">RegrR2</code><a class=\"heading-anchor\" href=\"#regrr2\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrR2</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrR2\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>以 <code class=\"docutils literal notranslate\">float `` 的形式返回相关系数的平方，如果没有任何匹配的行，则返回 ``None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrslope\">\n<h3><code class=\"docutils literal notranslate\">RegrSlope</code><a class=\"heading-anchor\" href=\"#regrslope\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrSlope</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSlope\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回由 <code class=\"docutils literal notranslate\">(x, y)</code> 对确定的最小二乘拟合线性方程的斜率，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrsxx\">\n<h3><code class=\"docutils literal notranslate\">RegrSXX</code><a class=\"heading-anchor\" href=\"#regrsxx\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrSXX</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSXX\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回 <code class=\"docutils literal notranslate\">sum(x^2) - sum(x)^2/N</code> （自变量的“平方和”）作为 <code class=\"docutils literal notranslate\">float</code>，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrsxy\">\n<h3><code class=\"docutils literal notranslate\">RegrSXY</code><a class=\"heading-anchor\" href=\"#regrsxy\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrSXY</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSXY\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回 <code class=\"docutils literal notranslate\">sum(x*y) - sum(x) * sum(y)/N</code> （自变量与因变量的乘积之和），如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">float</code>，或者 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n<section id=\"regrsyy\">\n<h3><code class=\"docutils literal notranslate\">RegrSYY</code><a class=\"heading-anchor\" href=\"#regrsyy\"><span class=\"visually-hidden\">Link to this heading</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\">class</span> </em><span class=\"sig-name descname\">RegrSYY</span><span class=\"sig-paren\">(</span><em class=\"sig-param\">y</em>, <em class=\"sig-param\">x</em>, <em class=\"sig-param\">filter<span class=\"o\">=</span><span class=\"default_value\">None</span></em><span class=\"sig-paren\">)</span><a class=\"heading-anchor\" href=\"#django.contrib.postgres.aggregates.RegrSYY\"><span class=\"visually-hidden\">Link to this definition</span><span aria-hidden=\"true\">#</span></a></dt>\n<dd><p>返回 <code class=\"docutils literal notranslate\">sum(y^2) - sum(y)^2/N</code> （因变量的“平方和”）作为 <code class=\"docutils literal notranslate\">float</code>，如果没有任何匹配的行，则返回 <code class=\"docutils literal notranslate\">None</code>。</p>\n</dd></dl>\n\n</section>\n</section>\n<section id=\"usage-examples\">\n<h2>使用实例：<a class=\"heading-anchor\" href=\"#usage-examples\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>我们将用这个例表：</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> FIELD1 <span class=\"o\">|</span> FIELD2 <span class=\"o\">|</span> FIELD3 <span class=\"o\">|</span>\n<span class=\"o\">|--------|--------|--------|</span>\n<span class=\"o\">|</span>    foo <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>    bar <span class=\"o\">|</span>      <span class=\"mi\">2</span> <span class=\"o\">|</span> <span class=\"p\">(</span>null<span class=\"p\">)</span> <span class=\"o\">|</span>\n<span class=\"o\">|</span>   test <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>下面是一些通用聚合函数的例子：</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>TestModel<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>result<span class=\"o\">=</span>StringAgg<span class=\"p\">(</span><span class=\"s1\">&#39;field1&#39;</span><span class=\"p\">,</span> delimiter<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>TestModel<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>result<span class=\"o\">=</span>ArrayAgg<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>TestModel<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>result<span class=\"o\">=</span>ArrayAgg<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>下一个例子显示了统计聚合函数的使用。基本的数学知识将不作说明（例如，你可以在 <a class=\"reference external\" href=\"https://en.wikipedia.org/wiki/Regression_analysis\">wikipedia</a> )：</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>TestModel<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>count<span class=\"o\">=</span>RegrCount<span class=\"p\">(</span>y<span class=\"o\">=</span><span class=\"s1\">&#39;field3&#39;</span><span class=\"p\">,</span> x<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>TestModel<span class=\"o\">.</span>objects<span class=\"o\">.</span>aggregate<span class=\"p\">(</span>avgx<span class=\"o\">=</span>RegrAvgX<span class=\"p\">(</span>y<span class=\"o\">=</span><span class=\"s1\">&#39;field3&#39;</span><span class=\"p\">,</span> x<span class=\"o\">=</span><span class=\"s1\">&#39;field2&#39;</span><span class=\"p\">),</span>\n<span class=\"gp\">... </span>                            avgy<span class=\"o\">=</span>RegrAvgY<span class=\"p\">(</span>y<span class=\"o\">=</span><span class=\"s1\">&#39;field3&#39;</span><span class=\"p\">,</span> x<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":"通用聚合函数","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":"JSONBAgg","anchor":"jsonbagg","children":[]},{"title":"StringAgg","anchor":"stringagg","children":[]}]},{"title":"统计的聚合功能","anchor":"aggregate-functions-for-statistics","children":[{"title":"y 和 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":"使用实例：","anchor":"usage-examples","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"API 参考","url":"/zh-hans/3.1/ref/"},{"docname":"ref/contrib/index","title":"contrib 包","url":"/zh-hans/3.1/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/zh-hans/3.1/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/zh-hans/3.1/ref/contrib/postgres/"},"next":{"docname":"ref/contrib/postgres/constraints","title":"PostgreSQL 特有数据库约束","url":"/zh-hans/3.1/ref/contrib/postgres/constraints/"},"formats":{"html":"/zh-hans/3.1/ref/contrib/postgres/aggregates/","markdown":"/zh-hans/3.1/ref/contrib/postgres/aggregates.md","json":"/zh-hans/3.1/ref/contrib/postgres/aggregates.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/ref/contrib/postgres/aggregates.txt","official":"https://docs.djangoproject.com/zh-hans/3.1/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"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}