BOOLAND_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¶

O tipo de dados do valor retornado é BOOLEAN.

Notas de uso¶

• Valores numéricos, decimais e de ponto flutuante são convertidos em TRUE se forem diferentes de zero.

• Os tipos de caracteres/texto não são suportados, pois não podem ser convertidos em booleanos.

• Quando usado como uma função de janela:

  • Esta função não oferece suporte para:

    • Subcláusula ORDER BY na cláusula OVER.

    • Quadros de janela.

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

Copy

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

Copy

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

Copy

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

Copy

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

Copy

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

Copy

Exemplo de erro

Se esta função for passada por cadeias de caracteres que não podem ser convertidas em booleano, a função dará um erro:

select booland_agg('invalid type');

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