sub_bitmap

BITMAP 値 src から、指定された位置 offset から始まる len 個の要素を抽出します。出力される要素は src の部分集合です。

この関数は、主にページネーションされたクエリのようなシナリオで使用されます。v2.5 からサポートされています。

この関数は bitmap_subset_limit に似ています。違いは、この関数がオフセットから要素を抽出するのに対し、bitmap_subset_limit は要素の値 (start_range) から抽出する点です。

構文

BITMAP sub_bitmap(BITMAP src, BIGINT offset, BIGINT len)

パラメータ

• src: 要素を取得したい BITMAP 値。
• offset: 開始位置。BIGINT 値でなければなりません。offset を使用する際の注意点は以下の通りです:
  • オフセットは 0 から始まります。
  • 負のオフセットは右から左に数えます。例 3 と 4 を参照してください。
  • offset で指定された開始位置が BITMAP 値の実際の長さを超える場合、NULL が返されます。例 6 を参照してください。
• len: 取得する要素の数。1 以上の BIGINT 値でなければなりません。マッチする要素の数が len の値より少ない場合、すべてのマッチする要素が返されます。例 2、3、7 を参照してください。

戻り値

BITMAP 型の値を返します。入力パラメータが無効な場合は NULL が返されます。

例

以下の例では、sub_bitmap() の入力は bitmap_from_string の出力です。例えば、bitmap_from_string('1,1,3,1,5,3,5,7,7,9') は 1, 3, 5, 7, 9 を返します。sub_bitmap() はこの BITMAP 値を入力として受け取ります。

例 1: オフセットを 0 に設定して、BITMAP 値から 2 つの要素を取得します。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), 0, 2)) value;
+-------+
| value |
+-------+
| 1,3   |
+-------+

例 2: オフセットを 0 に設定して、BITMAP 値から 100 個の要素を取得します。100 は BITMAP 値の長さを超えており、すべてのマッチする要素が返されます。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), 0, 100)) value;
+-----------+
| value     |
+-----------+
| 1,3,5,7,9 |
+-----------+

例 3: オフセットを -3 に設定して、BITMAP 値から 100 個の要素を取得します。100 は BITMAP 値の長さを超えており、すべてのマッチする要素が返されます。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), -3, 100)) value;
+-------+
| value |
+-------+
| 5,7,9 |
+-------+

例 4: オフセットを -3 に設定して、BITMAP 値から 2 つの要素を取得します。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), -3, 2)) value;
+-------+
| value |
+-------+
| 5,7   |
+-------+

例 5: -10 は len の無効な入力であるため、NULL が返されます。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), 0, -10)) value;
+-------+
| value |
+-------+
| NULL  |
+-------+

例 6: オフセット 5 で指定された開始位置が BITMAP 値 1,3,5,7,9 の長さを超えています。NULL が返されます。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), 5, 1)) value;
+-------+
| value |
+-------+
| NULL  |
+-------+

例 7: len が 5 に設定されていますが、条件に一致する要素は 2 つだけです。これらの 2 つの要素がすべて返されます。

select bitmap_to_string(sub_bitmap(bitmap_from_string('1,1,3,1,5,3,5,7,7,9'), -2, 5)) value;
+-------+
| value |
+-------+
| 7,9   |
+-------+