Categorias:: Funções de agregação (Boolean) , Funções de janela , Funções de expressão condicional

BOOLAND_AGG¶

Retornará TRUE se todos os registros booleanos diferentes de NULL em um grupo forem avaliados como TRUE.

Se todos os registros no grupo forem NULL, ou se o grupo estiver vazio, a função retornará NULL.

Consulte também:: BOOLAND , BOOLOR_AGG , BOOLXOR_AGG

Sintaxe¶

Função de agregação

BOOLAND_AGG( <expr> )

Função de janela

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

Argumentos¶

expr: A expressão de entrada deve ser uma expressão que pode ser avaliada como um booleano ou convertida em um booleano.
partition_expr: Esta coluna ou expressão especifica como separar a entrada em partições (subjanelas).

Retornos¶

Esta função retorna um valor do tipo BOOLEAN.

Notas de uso¶

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.

Quando esta função é chamada como uma função de janela, ela não oferece suporte para:
- Uma cláusula ORDER BY dentro da cláusula OVER.
- Quadros de janela explícitos.

Exemplos¶

Função de agregação

O exemplo a seguir mostra que booland_agg retorna verdadeiro quando todos os valores de entrada são verdadeiros.

Criar e carregar a tabela:

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);

Exibir os dados:

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 |
+----+------+-------+-------+-------+

Consultar os dados:

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

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

Função de janela

Este exemplo é similar ao exemplo anterior, mas mostra o uso como uma função de janela, com as linhas de entrada divididas em duas partições (uma para IDs maior que 0 e outra para IDs menor ou igual a 0). Dados adicionais foram adicionados à tabela.

Adicionar linhas à tabela:

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);

Exibir os dados:

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 |
+----+-------+-------+-------+-------+

Consultar os dados:

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

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

Exemplo de erro

Se esta função for passada por strings que não podem ser convertidas em booleano, a função retornará um erro:

select booland_agg('invalid type');

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