カテゴリ：

集計関数 （ビット単位）、 ウィンドウ関数 （一般）、 ビット単位の式関数

BITOR_AGG

グループ内のすべての非NULL 数値レコードのビット単位の OR 値を返します。

ビット位置ごとに、少なくとも1つの行のビットが1に設定されている場合、結果のビットは1に設定されます。すべての行のビットがゼロに設定されている場合、結果はゼロになります。

グループ内のすべてのレコード がNULLの場合、またはグループが空の場合、関数は NULLを返します。

エイリアス：

BITORAGG, BIT_OR_AGG, BIT_ORAGG

こちらもご参照ください。

BITAND_AGG、 BITXOR_AGG

BITOR

構文

集計関数

BITOR_AGG( <expr1> )
Copy

ウィンドウ関数

BITOR_AGG( <式1> ) OVER ( [ PARTITION BY <式2> ] )

引数

expr1

入力式は、数値に評価されるか、数値に変換できる式でなければなりません。

expr2

この式は、パーティション内の行をグループ化するために使用されます。

戻り値

返される値のデータ型は NUMERIC（38、0）です。

使用上の注意

  • 数値は最も近い整数データ型に集約されます。10進値と浮動小数点値は、集約の前に最も近い整数に四捨五入されます。

  • 文字/テキスト列（データ型 VARCHAR、 CHAR、 STRINGなど）を集約すると、入力値が暗黙的に FLOATにキャストされ、値が最も近い整数に四捨五入されます。キャストできない場合、値は NULLとして扱われます。

  • これらの関数には DISTINCT キーワードを指定できますが、効果はありません。

  • ウィンドウ関数として使用する場合：

    • この関数は次をサポートしていません。

      • OVER（）句のORDER BY サブ句。

      • ウィンドウフレーム。

例

テーブルを作成し、データをロードします。

CREATE OR REPLACE TABLE bitwise_example
        (k int, d decimal(10,5), s1 varchar(10), s2 varchar(10));

INSERT INTO bitwise_example VALUES
        (15, 1.1, '12','one'),
        (26, 2.9, '10','two'),
        (12, 7.1, '7.9','two'),
        (14, null, null,'null'),
        (8, null, null, 'null'),
        (null, 9.1, '14','nine');
Copy

データを表示します。

SELECT k AS k_col, d AS d_col, s1, s2
  FROM bitwise_example
  ORDER BY k_col;
+-------+---------+------+------+
| K_COL |   D_COL | S1   | S2   |
|-------+---------+------+------|
|     8 |    NULL | NULL | null |
|    12 | 7.10000 | 7.9  | two  |
|    14 |    NULL | NULL | null |
|    15 | 1.10000 | 12   | one  |
|    26 | 2.90000 | 10   | two  |
|  NULL | 9.10000 | 14   | nine |
+-------+---------+------+------+
Copy

データをクエリします。

select bitor_agg(k), bitor_agg(d), bitor_agg(s1) from bitwise_example;
+--------------+--------------+---------------+
| BITOR_AGG(K) | BITOR_AGG(D) | BITOR_AGG(S1) |
|--------------+--------------+---------------|
|           31 |           15 |            14 |
+--------------+--------------+---------------+
Copy

データをクエリし、 GROUP BY を使用します。

select s2, bitor_agg(k), bitor_agg(d) from bitwise_example group by s2
    order by 3;
+------+--------------+--------------+
| S2   | BITOR_AGG(K) | BITOR_AGG(D) |
|------+--------------+--------------|
| one  |           15 |            1 |
| two  |           30 |            7 |
| nine |         NULL |            9 |
| null |           14 |         NULL |
+------+--------------+--------------+
Copy

数値に変換できないこの関数の文字列を渡すと、エラーが発生します。

select bitor_agg(s2) from bitwise_example;
Copy
100038 (22018): Numeric value 'one' is not recognized
Copy
言語: 日本語