カテゴリ：: 集計関数 (Boolean) , ウィンドウ関数 , 条件式関数

BOOLXOR_AGG¶

グループの正確に1つの記録が TRUE と評価される場合にのみ TRUE を返します。

グループのすべての記録が NULL の場合、またはグループが空の場合、関数は NULL を返します。

こちらもご参照ください。: BOOLXOR、 BOOLAND_AGG、 BOOLOR_AGG

構文¶

集計関数

BOOLXOR_AGG( <expr> )

ウィンドウ関数

BOOLXOR_AGG( <expr> ) OVER ( [ PARTITION BY <partition_expr> ] )

引数¶

expr: 入力式は、ブール値に評価されるか、ブール値に変換できる式でなければなりません。
partition_expr: この列または式は、入力をパーティション（サブウィンドウ）に分割する方法を指定します。

戻り値¶

この関数は BOOLEAN型の値を返します。

使用上の注意¶

Numeric values are converted to TRUE if they are non-zero.
String and binary values aren't supported because they can't be converted to Boolean values.

この関数がウィンドウ関数として呼び出される場合、以下はサポートされていません。
- OVER 句内の ORDER BY 句。
- 明示的なウィンドウフレーム。

例¶

次の例は、boolxor_aggが正確に1つの入力値がtrueのときにtrueを返すことを示しています。

テーブルを作成してロードします。

CREATE OR REPLACE TABLE test_boolean_agg (
  id INTEGER,
  c1 BOOLEAN,
  c2 BOOLEAN,
  c3 BOOLEAN,
  c4 BOOLEAN
);

INSERT INTO test_boolean_agg (id, c1, c2, c3, c4) VALUES
  (1, TRUE, TRUE,  TRUE,  FALSE),
  (2, TRUE, FALSE, FALSE, FALSE),
  (3, TRUE, TRUE,  FALSE, FALSE),
  (4, TRUE, FALSE, FALSE, FALSE);

データを表示します。

SELECT *
  FROM test_boolean_agg;

+----+------+-------+-------+-------+
| ID | C1   | C2    | C3    | C4    |
|----+------+-------+-------+-------|
|  1 | True | True  | True  | False |
|  2 | True | False | False | False |
|  3 | True | True  | False | False |
|  4 | True | False | False | False |
+----+------+-------+-------+-------+

データをクエリします。

SELECT BOOLXOR_AGG(c1), BOOLXOR_AGG(c2), BOOLXOR_AGG(c3), BOOLXOR_AGG(c4)
  FROM test_boolean_agg;

+-----------------+-----------------+-----------------+-----------------+
| BOOLXOR_AGG(C1) | BOOLXOR_AGG(C2) | BOOLXOR_AGG(C3) | BOOLXOR_AGG(C4) |
|-----------------+-----------------+-----------------+-----------------|
| False           | False           | True            | False           |
+-----------------+-----------------+-----------------+-----------------+

ウィンドウ関数

この例は前の例と似ていますが、入力関数が2つのパーティションに分割されたウィンドウ関数としての使用法を示しています（0よりも大きいIDs が1つと、0以下の IDs が1つ）。テーブルに追加データが追加されました。

テーブルに行を追加します。

INSERT INTO test_boolean_agg (id, c1, c2, c3, c4) VALUES
  (-4, FALSE, FALSE, FALSE, TRUE),
  (-3, FALSE, TRUE,  TRUE,  TRUE),
  (-2, FALSE, FALSE, TRUE,  TRUE),
  (-1, FALSE, TRUE,  TRUE,  TRUE);

データを表示します。

SELECT *
  FROM test_boolean_agg
  ORDER BY id;

+----+-------+-------+-------+-------+
| ID | C1    | C2    | C3    | C4    |
|----+-------+-------+-------+-------|
| -4 | False | False | False | True  |
| -3 | False | True  | True  | True  |
| -2 | False | False | True  | True  |
| -1 | False | True  | True  | True  |
|  1 | True  | True  | True  | False |
|  2 | True  | False | False | False |
|  3 | True  | True  | False | False |
|  4 | True  | False | False | False |
+----+-------+-------+-------+-------+

データをクエリします。

SELECT
    id,
    BOOLXOR_AGG(c1) OVER (PARTITION BY (id > 0)),
    BOOLXOR_AGG(c2) OVER (PARTITION BY (id > 0)),
    BOOLXOR_AGG(c3) OVER (PARTITION BY (id > 0)),
    BOOLXOR_AGG(c4) OVER (PARTITION BY (id > 0))
  FROM test_boolean_agg
  ORDER BY id;

+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------+
| ID | BOOLXOR_AGG(C1) OVER (PARTITION BY (ID > 0)) | BOOLXOR_AGG(C2) OVER (PARTITION BY (ID > 0)) | BOOLXOR_AGG(C3) OVER (PARTITION BY (ID > 0)) | BOOLXOR_AGG(C4) OVER (PARTITION BY (ID > 0)) |
|----+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------|
| -4 | False                                        | False                                        | False                                        | False                                        |
| -3 | False                                        | False                                        | False                                        | False                                        |
| -2 | False                                        | False                                        | False                                        | False                                        |
| -1 | False                                        | False                                        | False                                        | False                                        |
|  1 | False                                        | False                                        | True                                         | False                                        |
|  2 | False                                        | False                                        | True                                         | False                                        |
|  3 | False                                        | False                                        | True                                         | False                                        |
|  4 | False                                        | False                                        | True                                         | False                                        |
+----+----------------------------------------------+----------------------------------------------+----------------------------------------------+----------------------------------------------+

エラーの例

この関数にブール値に変換できない文字列が渡されると、関数はエラーを返します。

select boolxor_agg('invalid type');

100037 (22018): Boolean value 'invalid_type' is not recognized