バージョンごとのドキュメント一覧

9.21. 集約関数 #

<title>Aggregate Functions</title>

<firstterm>Aggregate functions</firstterm> compute a single result from a set of input values. The built-in general-purpose aggregate functions are listed in <xref linkend="functions-aggregate-table"/> while statistical aggregates are in <xref linkend="functions-aggregate-statistics-table"/>. The built-in within-group ordered-set aggregate functions are listed in <xref linkend="functions-orderedset-table"/> while the built-in within-group hypothetical-set ones are in <xref linkend="functions-hypothetical-table"/>. Grouping operations, which are closely related to aggregate functions, are listed in <xref linkend="functions-grouping-table"/>. The special syntax considerations for aggregate functions are explained in <xref linkend="syntax-aggregates"/>. Consult <xref linkend="tutorial-agg"/> for additional introductory information. 集約関数は入力値の集合から単一の結果を計算します。 表 9.60に組み込みの汎用的な集約関数を、表 9.61に統計集約関数を示します。 表 9.62には組み込みのグループ内順序集合集約関数を、一方表 9.63には組み込みのグループ内仮想集合用の順序集約関数を示します。 表 9.64には、集約関数と密接に関係するグループ化演算を示します。 集約関数の特殊な構文に関する考察は4.2.7で説明されています。 また、初歩的な情報については2.7を参照して下さい。

Aggregate functions that support <firstterm>Partial Mode</firstterm> are eligible to participate in various optimizations, such as parallel aggregation. 部分モードをサポートする集約関数は並列集約など、様々な最適化に有用です。

While all aggregates below accept an optional <literal>ORDER BY</literal> clause (as outlined in <xref linkend="syntax-aggregates"/>), the clause has only been added to aggregates whose output is affected by ordering. 以下のすべての集約は、オプションのORDER BY句を受け付けます(4.2.7で概説)。この句は出力が順序に影響される集約にのみ追加されました。

表9.60 汎用集約関数

<title>General-Purpose Aggregate Functions</title>

Function 関数

Description 説明

部分モード

any_value ( anyelement ) → same as input type

Returns an arbitrary value from the non-null input values. NULL以外の入力値から任意の値を返します。

array_agg ( anynonarray ORDER BY input_sort_columns ) → anyarray

Collects all the input values, including nulls, into an array. NULLも含めてすべての入力値を収集して配列に格納します。

array_agg ( anyarray ORDER BY input_sort_columns ) → anyarray

Concatenates all the input arrays into an array of one higher dimension. (The inputs must all have the same dimensionality, and cannot be empty or null.) すべての入力配列を結合して次元が1高い配列に格納します。 (入力配列はすべて同じ次元数を持ち、空もしくはNULLであってはいけません。)

avg ( smallint ) → numeric

avg ( integer ) → numeric

avg ( bigint ) → numeric

avg ( numeric ) → numeric

avg ( real ) → double precision

avg ( double precision ) → double precision

avg ( interval ) → interval

Computes the average (arithmetic mean) of all the non-null input values. すべての非NULL入力値の平均(算術平均)を計算します。

bit_and ( smallint ) → smallint

bit_and ( integer ) → integer

bit_and ( bigint ) → bigint

bit_and ( bit ) → bit

Computes the bitwise AND of all non-null input values. 全ての非NULLの入力値のビット積を計算します。

bit_or ( smallint ) → smallint

bit_or ( integer ) → integer

bit_or ( bigint ) → bigint

bit_or ( bit ) → bit

Computes the bitwise OR of all non-null input values. 全ての非NULLの入力値のビット和を計算します。

bit_xor ( smallint ) → smallint

bit_xor ( integer ) → integer

bit_xor ( bigint ) → bigint

bit_xor ( bit ) → bit

Computes the bitwise exclusive OR of all non-null input values. Can be useful as a checksum for an unordered set of values. すべての非NULL入力値のビット毎の排他的論理和を計算します。 順序付けられない値の集合のチェックサムとして有用かもしれません。

bool_and ( boolean ) → boolean

Returns true if all non-null input values are true, otherwise false. 全ての入力が真ならば真、そうでなければ偽を返します。

bool_or ( boolean ) → boolean

Returns true if any non-null input value is true, otherwise false. 入力のどれかが真ならば真、そうでなければ偽を返します。

count ( * ) → bigint

Computes the number of input rows. 入力行数を返します。

count ( "any" ) → bigint

Computes the number of input rows in which the input value is not null. 非NULLの入力行数を返します。

every ( boolean ) → boolean

This is the SQL standard's equivalent to <function>bool_and</function>. これはSQL標準のbool_andと等価です。

json_agg ( anyelement ORDER BY input_sort_columns ) → json

jsonb_agg ( anyelement ORDER BY input_sort_columns ) → jsonb

Collects all the input values, including nulls, into a JSON array. Values are converted to JSON as per <function>to_json</function> or <function>to_jsonb</function>. NULLも含めてすべての入力値を収集し、JSON配列に格納します。 入力はto_jsonあるいはto_jsonbでJSONに変換されます。

json_agg_strict ( anyelement ) → json

jsonb_agg_strict ( anyelement ) → jsonb

Collects all the input values, skipping nulls, into a JSON array. Values are converted to JSON as per <function>to_json</function> or <function>to_jsonb</function>. NULLをスキップして、すべての入力値をJSON配列に収集します。 値はto_JSONまたはto_JSONに従ってjsonbに変換されます。

json_arrayagg ( [ value_expression ] [ ORDER BY sort_expression ] [ { NULL | ABSENT } ON NULL ] [ RETURNING data_type [ FORMAT JSON [ ENCODING UTF8 ] ] ])

Behaves in the same way as <function>json_array</function> but as an aggregate function so it only takes one <replaceable>value_expression</replaceable> parameter. If <literal>ABSENT ON NULL</literal> is specified, any NULL values are omitted. If <literal>ORDER BY</literal> is specified, the elements will appear in the array in that order rather than in the input order. JSON_配列と同じように動作しますが、集約関数として動作するため、1つのvalue_式パラメータのみを使用します。 ABSENT ON NULLが指定されている場合、NULL値は無視されます。 ORDER BYが指定されている場合、要素は入力順ではなく、配列の順に表示されます。

SELECT json_arrayagg(v) FROM (VALUES(2),(1)) t(v)[2, 1]

json_objectagg ( [ { key_expression { VALUE | ':' } value_expression } ] [ { NULL | ABSENT } ON NULL ] [ { WITH | WITHOUT } UNIQUE [ KEYS ] ] [ RETURNING data_type [ FORMAT JSON [ ENCODING UTF8 ] ] ])

Behaves like <function>json_object</function><!&#45;- xref &#45;->, but as an aggregate function, so it only takes one <replaceable>key_expression</replaceable> and one <replaceable>value_expression</replaceable> parameter. JSON_オブジェクト xref のように動作しますが、集約関数として動作するため、1つのkey_expressionと1つのvalue_expression引数のみを使用します。

SELECT json_objectagg(k:v) FROM (VALUES ('a'::text,current_date),('b',current_date + 1)) AS t(k,v){ "a" : "2022-05-10", "b" : "2022-05-11" }

json_object_agg ( key "any", value "any" ORDER BY input_sort_columns ) → json

jsonb_object_agg ( key "any", value "any" ORDER BY input_sort_columns ) → jsonb

Collects all the key/value pairs into a JSON object. Key arguments are coerced to text; value arguments are converted as per <function>to_json</function> or <function>to_jsonb</function>. Values can be null, but keys cannot. すべてのキー/値ペアをJSONオブジェクトに格納します。 キー引数はテキストに変換されます。値引数はto_jsonあるいはto_jsonbにしたがって変換されます。 値はNULLでも構いませんが、キーはNULLにはできません。

json_object_agg_strict ( key "any", value "any" ) → json

jsonb_object_agg_strict ( key "any", value "any" ) → jsonb

Collects all the key/value pairs into a JSON object. Key arguments are coerced to text; value arguments are converted as per <function>to_json</function> or <function>to_jsonb</function>. The <parameter>key</parameter> can not be null. If the <parameter>value</parameter> is null then the entry is skipped, すべてのキー/値ペアをJSONオブジェクトに格納します。 キー引数はテキストに変換されます。値はto_jsonあるいはto_jsonbにしたがって変換されます。 keyはNULLにはできません。 valueがNULLなら、そのエントリはスキップされます。

json_object_agg_unique ( key "any", value "any" ) → json

jsonb_object_agg_unique ( key "any", value "any" ) → jsonb

Collects all the key/value pairs into a JSON object. Key arguments are coerced to text; value arguments are converted as per <function>to_json</function> or <function>to_jsonb</function>. Values can be null, but keys cannot. If there is a duplicate key an error is thrown. すべてのキー/値ペアをJSONオブジェクトに格納します。 キー引数はテキストに変換されます。値はto_jsonあるいはto_jsonbにしたがって変換されます。 値はNULLでも構いませんが、キーはNULLにはできません。 重複キーがある場合、エラーが発生します。

json_object_agg_unique_strict ( key "any", value "any" ) → json

jsonb_object_agg_unique_strict ( key "any", value "any" ) → jsonb

Collects all the key/value pairs into a JSON object. Key arguments are coerced to text; value arguments are converted as per <function>to_json</function> or <function>to_jsonb</function>. The <parameter>key</parameter> can not be null. If the <parameter>value</parameter> is null then the entry is skipped. If there is a duplicate key an error is thrown. すべてのキー/値ペアをJSONオブジェクトに格納します。 キー引数はテキストに変換されます。値はto_jsonあるいはto_jsonbにしたがって変換されます。 keyはNULLにはできません。 valueがNULLなら、そのエントリはスキップされます。 重複キーがある場合、エラーが発生します。

max ( see text ) → same as input type

Computes the maximum of the non-null input values. Available for any numeric, string, date/time, or enum type, as well as <type>inet</type>, <type>interval</type>, <type>money</type>, <type>oid</type>, <type>pg_lsn</type>, <type>tid</type>, <type>xid8</type>, and arrays of any of these types. 非NULL入力値の最大を計算します。 数値、文字列、日時、列挙型およびinetintervalmoneyoidpg_lsntidxid8、およびこれらすべての配列でも同様に利用できます。

min ( see text ) → same as input type

Computes the minimum of the non-null input values. Available for any numeric, string, date/time, or enum type, as well as <type>inet</type>, <type>interval</type>, <type>money</type>, <type>oid</type>, <type>pg_lsn</type>, <type>tid</type>, <type>xid8</type>, and arrays of any of these types. 非NULL入力値の最小を計算します。 数値、文字列、日時、列挙型およびinetintervalmoneyoidpg_lsntidxid8、およびこれらすべての配列でも同様に利用できます。

range_agg ( value anyrange ) → anymultirange

range_agg ( value anymultirange ) → anymultirange

Computes the union of the non-null input values. 非NULL入力の和を計算します。

range_intersect_agg ( value anyrange ) → anyrange

range_intersect_agg ( value anymultirange ) → anymultirange

Computes the intersection of the non-null input values. 非NULL入力の共通部分を計算します。

string_agg ( value text, delimiter text ) → text

string_agg ( value bytea, delimiter bytea ORDER BY input_sort_columns ) → bytea

Concatenates the non-null input values into a string. Each value after the first is preceded by the corresponding <parameter>delimiter</parameter> (if it's not null). 非NULL入力を結合して文字列に格納します。 最初の値以降、各値の前にdelimiterで指定した値が(NULLでなければ)追加されます。

sum ( smallint ) → bigint

sum ( integer ) → bigint

sum ( bigint ) → numeric

sum ( numeric ) → numeric

sum ( real ) → real

sum ( double precision ) → double precision

sum ( interval ) → interval

sum ( money ) → money

Computes the sum of the non-null input values. 非NULL入力値の合計を計算します。

xmlagg ( xml ORDER BY input_sort_columns ) → xml

Concatenates the non-null XML input values (see <xref linkend="functions-xml-xmlagg"/>). 非NULLのXML入力値を結合します。(9.15.1.8参照。)


It should be noted that except for <function>count</function>, these functions return a null value when no rows are selected. In particular, <function>sum</function> of no rows returns null, not zero as one might expect, and <function>array_agg</function> returns null rather than an empty array when there are no input rows. The <function>coalesce</function> function can be used to substitute zero or an empty array for null when necessary. 上記の関数は、count関数を除き、1行も選択されなかった場合NULL値を返すことに注意してください。 特に、行の選択がないsum関数は、予想されるであろうゼロではなくNULLを返し、そしてarray_aggは、入力行が存在しない場合に、空配列ではなくNULLを返します。 必要であれば、NULLをゼロまたは空配列と置換する目的でcoalesce関数を使うことができます。

The aggregate functions <function>array_agg</function>, <function>json_agg</function>, <function>jsonb_agg</function>, <function>json_agg_strict</function>, <function>jsonb_agg_strict</function>, <function>json_object_agg</function>, <function>jsonb_object_agg</function>, <function>json_object_agg_strict</function>, <function>jsonb_object_agg_strict</function>, <function>json_object_agg_unique</function>, <function>jsonb_object_agg_unique</function>, <function>json_object_agg_unique_strict</function>, <function>jsonb_object_agg_unique_strict</function>, <function>string_agg</function>, and <function>xmlagg</function>, as well as similar user-defined aggregate functions, produce meaningfully different result values depending on the order of the input values. This ordering is unspecified by default, but can be controlled by writing an <literal>ORDER BY</literal> clause within the aggregate call, as shown in <xref linkend="syntax-aggregates"/>. Alternatively, supplying the input values from a sorted subquery will usually work. For example: 集約関数array_aggjson_aggjsonb_aggjson_agg_strictjsonb_agg_strictjson_object_aggjsonb_object_aggjson_object_agg_strictjsonb_object_agg_strictjson_object_agg_uniquejsonb_object_agg_uniquejson_object_agg_unique_strictjsonb_object_agg_unique_strictstring_agg、およびxmlagg、そして類似のユーザ定義の集約関数は、入力値の順序に依存した意味のある別の結果値を生成します。 この並び順はデフォルトでは指定されませんが、4.2.7に記述されているように、集計呼び出し中にORDER BY句を書くことで制御可能となります。別の方法として、並べ替えられた副問い合わせから入力値を供給することでも上手くいきます。 例をあげます。

SELECT xmlagg(x) FROM (SELECT x FROM test ORDER BY y DESC) AS tab;

Beware that this approach can fail if the outer query level contains additional processing, such as a join, because that might cause the subquery's output to be reordered before the aggregate is computed. 外側の問い合わせのレベルで結合などの追加処理がある場合、この方法は失敗するかもしれないことに注意して下さい。 なぜなら、集約の計算の前に副問い合わせの出力を並べ替える必要があるかも知れないからです。

注記

The boolean aggregates <function>bool_and</function> and <function>bool_or</function> correspond to the standard SQL aggregates <function>every</function> and <function>any</function> or <function>some</function>. <productname>PostgreSQL</productname> supports <function>every</function>, but not <function>any</function> or <function>some</function>, because there is an ambiguity built into the standard syntax: bool_andbool_or論理集約関数は標準SQLの集約関数everyanyまたはsomeに対応します。 PostgreSQLeveryをサポートしますが、any、あるいはsomeはサポートしません。 anysomeの標準の構文には曖昧さがあるからです。

SELECT b1 = ANY((SELECT b2 FROM t2 ...)) FROM t1 ...;

Here <function>ANY</function> can be considered either as introducing a subquery, or as being an aggregate function, if the subquery returns one row with a Boolean value. Thus the standard name cannot be given to these aggregates. ここで、副問い合わせが論理値での1行を返す場合、ANYは副問い合わせを導入するもの、もしくは集約関数であるものいずれかとみなすことができます。 従って、これらの集約関数に標準の名前を付けることはできません。

注記

Users accustomed to working with other SQL database management systems might be disappointed by the performance of the <function>count</function> aggregate when it is applied to the entire table. A query like: 他のSQLデータベース管理システムでの作業に親しんだユーザは、count集約関数がテーブル全体に適用される場合の性能に失望するかも知れません。

SELECT count(*) FROM sometable;

will require effort proportional to the size of the table: <productname>PostgreSQL</productname> will need to scan either the entire table or the entirety of an index that includes all rows in the table. のような問い合わせはテーブルサイズに比例した労力が必要です。PostgreSQLはテーブル全体か、そのテーブルの全ての行を含んだインデックス全体のスキャンを必要とします。

<xref linkend="functions-aggregate-statistics-table"/> shows aggregate functions typically used in statistical analysis. (These are separated out merely to avoid cluttering the listing of more-commonly-used aggregates.) Functions shown as accepting <replaceable>numeric_type</replaceable> are available for all the types <type>smallint</type>, <type>integer</type>, <type>bigint</type>, <type>numeric</type>, <type>real</type>, and <type>double precision</type>. Where the description mentions <parameter>N</parameter>, it means the number of input rows for which all the input expressions are non-null. In all cases, null is returned if the computation is meaningless, for example when <parameter>N</parameter> is zero. 統計解析処理によく使用される集約関数を表 9.61に示します。 (これらは、より一般的に使用される集約関数との混乱を防ぐために別出ししました。) numeric_typeを受け付けると表示されている関数は、smallintintegerbigintnumericrealdouble precisionのすべての型で利用可能です。 説明の部分におけるNは、すべての入力式が非NULLの入力行の個数を表します。 すべての場合にて、例えばNが0の時など計算が無意味である場合にはNULLが返されます。

表9.61 統計処理用の集約関数

<title>Aggregate Functions for Statistics</title>

Function 関数

Description 説明

部分モード

corr ( Y double precision, X double precision ) → double precision

Computes the correlation coefficient. 相関係数を計算します。

covar_pop ( Y double precision, X double precision ) → double precision

Computes the population covariance. 母共分散を計算します。

covar_samp ( Y double precision, X double precision ) → double precision

Computes the sample covariance. 標本の共分散を計算します。

regr_avgx ( Y double precision, X double precision ) → double precision

Computes the average of the independent variable, <literal>sum(<parameter>X</parameter>)/<parameter>N</parameter></literal>. 独立変数の平均値を計算します。 sum(X)/N.

regr_avgy ( Y double precision, X double precision ) → double precision

Computes the average of the dependent variable, <literal>sum(<parameter>Y</parameter>)/<parameter>N</parameter></literal>. 従属変数の平均値を計算します。 sum(Y)/N.

regr_count ( Y double precision, X double precision ) → bigint

Computes the number of rows in which both inputs are non-null. 両方の入力が非NULLとなる行数を計算します。

regr_intercept ( Y double precision, X double precision ) → double precision

Computes the y-intercept of the least-squares-fit linear equation determined by the (<parameter>X</parameter>, <parameter>Y</parameter>) pairs. (X, Y)の組み合わせで決まる、最小二乗法による線形方程式のY切片を計算します。

regr_r2 ( Y double precision, X double precision ) → double precision

Computes the square of the correlation coefficient. 相関係数の二乗を計算します。

regr_slope ( Y double precision, X double precision ) → double precision

Computes the slope of the least-squares-fit linear equation determined by the (<parameter>X</parameter>, <parameter>Y</parameter>) pairs. (X, Y)の組み合わせで決まる、最小二乗法による線型方程式の勾配を計算します。

regr_sxx ( Y double precision, X double precision ) → double precision

Computes the <quote>sum of squares</quote> of the independent variable, <literal>sum(<parameter>X</parameter>^2) - sum(<parameter>X</parameter>)^2/<parameter>N</parameter></literal>. 独立変数の二乗和sum(X^2) - sum(X)^2/Nを計算します。

regr_sxy ( Y double precision, X double precision ) → double precision

Computes the <quote>sum of products</quote> of independent times dependent variables, <literal>sum(<parameter>X</parameter>*<parameter>Y</parameter>) - sum(<parameter>X</parameter>) * sum(<parameter>Y</parameter>)/<parameter>N</parameter></literal>. 独立変数と従属変数の積の和sum(X*Y) - sum(X) * sum(Y)/Nを計算します。

regr_syy ( Y double precision, X double precision ) → double precision

Computes the <quote>sum of squares</quote> of the dependent variable, <literal>sum(<parameter>Y</parameter>^2) - sum(<parameter>Y</parameter>)^2/<parameter>N</parameter></literal>. 従属変数の積の和sum(Y^2) - sum(Y)^2/Nを計算します。

stddev ( numeric_type ) <returnvalue></returnvalue> <type>double precision</type> for <type>real</type> or <type>double precision</type>, otherwise <type>numeric</type> 引数がdouble precisionあるいはrealに対してはdouble precision、それ以外はnumeric

This is a historical alias for <function>stddev_samp</function>. これはstddev_sampの歴史的な別名です。

stddev_pop ( numeric_type ) <returnvalue></returnvalue> <type>double precision</type> for <type>real</type> or <type>double precision</type>, otherwise <type>numeric</type> 引数がdouble precisionあるいはrealに対してはdouble precision、それ以外はnumeric

Computes the population standard deviation of the input values. 入力値の母標準偏差を計算します。

stddev_samp ( numeric_type ) <returnvalue></returnvalue> <type>double precision</type> for <type>real</type> or <type>double precision</type>, otherwise <type>numeric</type> 引数がdouble precisionあるいはrealに対してはdouble precision、それ以外はnumeric

Computes the sample standard deviation of the input values. 入力値の標本標準偏差を計算します。

variance ( numeric_type ) <returnvalue></returnvalue> <type>double precision</type> for <type>real</type> or <type>double precision</type>, otherwise <type>numeric</type> 引数がdouble precisionあるいはrealに対してはdouble precision、それ以外はnumeric

This is a historical alias for <function>var_samp</function>. これはvar_sampの歴史的な別名です。

var_pop ( numeric_type ) <returnvalue></returnvalue> <type>double precision</type> for <type>real</type> or <type>double precision</type>, otherwise <type>numeric</type> 引数がdouble precisionあるいはrealに対してはdouble precision、それ以外はnumeric

Computes the population variance of the input values (square of the population standard deviation). 入力値の母分散(母標準偏差の二乗)を計算します。

var_samp ( numeric_type ) <returnvalue></returnvalue> <type>double precision</type> for <type>real</type> or <type>double precision</type>, otherwise <type>numeric</type> 引数がdouble precisionあるいはrealに対してはdouble precision、それ以外はnumeric

Computes the sample variance of the input values (square of the sample standard deviation). 入力値の標本分散(標本標準偏差の二乗)を計算します。


<xref linkend="functions-orderedset-table"/> shows some aggregate functions that use the <firstterm>ordered-set aggregate</firstterm> syntax. These functions are sometimes referred to as <quote>inverse distribution</quote> functions. Their aggregated input is introduced by <literal>ORDER BY</literal>, and they may also take a <firstterm>direct argument</firstterm> that is not aggregated, but is computed only once. All these functions ignore null values in their aggregated input. For those that take a <parameter>fraction</parameter> parameter, the fraction value must be between 0 and 1; an error is thrown if not. However, a null <parameter>fraction</parameter> value simply produces a null result. 表 9.62順序集合集約構文を使う集約関数を示します。 これらの関数は逆分散関数として参照されることがあります。 これらの集約入力はORDER BYで導入され、集約ではないdirect argumentを取ることもでき、一度だけ計算されます。 fractionパラメータを取る関数では、その値は0と1の間でなければなりません。そうでなければエラーが生じます。 ただしNULLのfraction値は単にNULLの結果をもたらします。

表9.62 順序集合集約関数

<title>Ordered-Set Aggregate Functions</title>

Function 関数

Description 説明

部分モード

mode () WITHIN GROUP ( ORDER BY anyelement ) → anyelement

Computes the <firstterm>mode</firstterm>, the most frequent value of the aggregated argument (arbitrarily choosing the first one if there are multiple equally-frequent values). The aggregated argument must be of a sortable type. 集約引数の最頻値、最も頻出する値(複数の同じ度数の結果があれば、任意に選んだ最初のもの)を計算します。 集約引数はソート可能な型でなければなりません。

percentile_cont ( fraction double precision ) WITHIN GROUP ( ORDER BY double precision ) → double precision

percentile_cont ( fraction double precision ) WITHIN GROUP ( ORDER BY interval ) → interval

Computes the <firstterm>continuous percentile</firstterm>, a value corresponding to the specified <parameter>fraction</parameter> within the ordered set of aggregated argument values. This will interpolate between adjacent input items if needed. 連続百分位数、引数の値の順序付け集合中で指定されたfractionに対応する値を計算します。 これは必要なら隣り合う入力項目を補間します。

percentile_cont ( fractions double precision[] ) WITHIN GROUP ( ORDER BY double precision ) → double precision[]

percentile_cont ( fractions double precision[] ) WITHIN GROUP ( ORDER BY interval ) → interval[]

Computes multiple continuous percentiles. The result is an array of the same dimensions as the <parameter>fractions</parameter> parameter, with each non-null element replaced by the (possibly interpolated) value corresponding to that percentile. 複数の連続百分位数を計算します。 結果はfractionsパラメータと同じ次元数の配列です。各非NULL要素は(必要なら隣り合う入力項目を補間して)その百分位数に対応する値で置き換えられます。

percentile_disc ( fraction double precision ) WITHIN GROUP ( ORDER BY anyelement ) → anyelement

Computes the <firstterm>discrete percentile</firstterm>, the first value within the ordered set of aggregated argument values whose position in the ordering equals or exceeds the specified <parameter>fraction</parameter>. The aggregated argument must be of a sortable type. 離散百分位数を計算します。集約引数の順序付け集合中で、その位置が指定したfractionと等しいか越えた最初の値です。 集約引数はソート可能な型でなければなりません。

percentile_disc ( fractions double precision[] ) WITHIN GROUP ( ORDER BY anyelement ) → anyarray

Computes multiple discrete percentiles. The result is an array of the same dimensions as the <parameter>fractions</parameter> parameter, with each non-null element replaced by the input value corresponding to that percentile. The aggregated argument must be of a sortable type. 複数の離散百分位数を計算します 結果はfractionsパラメータと同じ次元数の配列です。各非NULL要素はその百分位数に対応する値で置き換えられます。 集約引数はソート可能な型でなければなりません。


Each of the <quote>hypothetical-set</quote> aggregates listed in <xref linkend="functions-hypothetical-table"/> is associated with a window function of the same name defined in <xref linkend="functions-window"/>. In each case, the aggregate's result is the value that the associated window function would have returned for the <quote>hypothetical</quote> row constructed from <replaceable>args</replaceable>, if such a row had been added to the sorted group of rows represented by the <replaceable>sorted_args</replaceable>. For each of these functions, the list of direct arguments given in <replaceable>args</replaceable> must match the number and types of the aggregated arguments given in <replaceable>sorted_args</replaceable>. Unlike most built-in aggregates, these aggregates are not strict, that is they do not drop input rows containing nulls. Null values sort according to the rule specified in the <literal>ORDER BY</literal> clause. 表 9.63に列挙されている仮想集合集約は、それぞれ9.22で定義されている同じ名前のウィンドウ関数と関連します。 どの場合も、集約結果は、argsから構築される仮想的な行に対して、関連するウィンドウ関数が返す値で、そのような行がsorted_argsから計算されるソートされた行のグループに追加される場合を想定します。 これらの関数に対してargsで与えられる直接引数のリストは、sorted_argsで与えられる集約された引数の数と型に一致しなければなりません。 ほとんどの組み込み集約とは異なり、この集約はSTRICTではありません、すなわち、NULLを含む入力行を落としません。 NULL値はORDER BY節で指定されるルールに従って並べられます。

表9.63 仮想集合集約関数

<title>Hypothetical-Set Aggregate Functions</title>

Function 関数

Description 説明

部分モード

rank ( args ) WITHIN GROUP ( ORDER BY sorted_args ) → bigint

Computes the rank of the hypothetical row, with gaps; that is, the row number of the first row in its peer group. 重複する行のギャップを含む仮想の行の順位を計算します。すなわち、ピアグループの先頭の行の番号です。

dense_rank ( args ) WITHIN GROUP ( ORDER BY sorted_args ) → bigint

Computes the rank of the hypothetical row, without gaps; this function effectively counts peer groups. 重複する行のギャップなしの仮想の行の順位を計算します。この関数は実効的にピアグループを数えます。

percent_rank ( args ) WITHIN GROUP ( ORDER BY sorted_args ) → double precision

Computes the relative rank of the hypothetical row, that is (<function>rank</function> - 1) / (total rows - 1). The value thus ranges from 0 to 1 inclusive. 仮想行の相対的な順位を計算します。すなわち、(rank - 1) / (total rows - 1)です。 ですから値の範囲は境界を含んで0から1までです。

cume_dist ( args ) WITHIN GROUP ( ORDER BY sorted_args ) → double precision

Computes the cumulative distribution, that is (number of rows preceding or peers with hypothetical row) / (total rows). The value thus ranges from 1/<parameter>N</parameter> to 1. 現在行の相対順位を計算します。すなわち、(仮想行より先行する、あるいはピアの行数) / (合計行数)です。 ですから範囲は1/Nから1です。


表9.64 グループ化演算

<title>Grouping Operations</title>

Function 関数

Description 説明

GROUPING ( group_by_expression(s) ) → integer

Returns a bit mask indicating which <literal>GROUP BY</literal> expressions are not included in the current grouping set. Bits are assigned with the rightmost argument corresponding to the least-significant bit; each bit is 0 if the corresponding expression is included in the grouping criteria of the grouping set generating the current result row, and 1 if it is not included. どのGROUP BY式が現在のグループ化セットに含まれないかを示す整数のビットマスクを返します。 最も右側の引数が最下位ビットになるようにビットが割り当てられます。 各ビットは対応する式が結果の行を生成するグループ化セットのグループ化条件に含まれていれば0、そうでなければ1です。


The grouping operations shown in <xref linkend="functions-grouping-table"/> are used in conjunction with grouping sets (see <xref linkend="queries-grouping-sets"/>) to distinguish result rows. The arguments to the <literal>GROUPING</literal> function are not actually evaluated, but they must exactly match expressions given in the <literal>GROUP BY</literal> clause of the associated query level. For example: 表 9.64で示すグループ化演算はグループ化セット(7.2.4参照)と一緒に使われ、結果の行を区別するものです。 GROUPING関数の引数は実際には評価されませんが、関連する問い合わせのGROUP BY句にある式と正確に一致する必要があります。 例えば以下のようになります。

=> SELECT * FROM items_sold;
 make  | model | sales
-------+-------+-------
 Foo   | GT    |  10
 Foo   | Tour  |  20
 Bar   | City  |  15
 Bar   | Sport |  5
(4 rows)

=> SELECT make, model, GROUPING(make,model), sum(sales) FROM items_sold GROUP BY ROLLUP(make,model);
 make  | model | grouping | sum
-------+-------+----------+-----
 Foo   | GT    |        0 | 10
 Foo   | Tour  |        0 | 20
 Bar   | City  |        0 | 15
 Bar   | Sport |        0 | 5
 Foo   |       |        1 | 30
 Bar   |       |        1 | 20
       |       |        3 | 50
(7 rows)

Here, the <literal>grouping</literal> value <literal>0</literal> in the first four rows shows that those have been grouped normally, over both the grouping columns. The value <literal>1</literal> indicates that <literal>model</literal> was not grouped by in the next-to-last two rows, and the value <literal>3</literal> indicates that neither <literal>make</literal> nor <literal>model</literal> was grouped by in the last row (which therefore is an aggregate over all the input rows). ここで、最初の4行のグループ化0はこれらがグループ化列に対して正常にグループ化されたことを示します。 値1modelが最後とその一つ前の行ではグループ化されなかったことを、値3makemodelも最後の行でグループ化されなかったことを意味します(ですから最後の行はすべての入力行に対する集約になっています)。