From 01250974dc54ea1fb8d06a215c794f8fed789215 Mon Sep 17 00:00:00 2001 From: wubx Date: Fri, 3 Apr 2026 14:54:43 +0800 Subject: [PATCH 1/3] docs: add bloom_index_type option for Fuse Engine (v1.2.892) Add documentation for the new `bloom_index_type` table option introduced in databendlabs/databend#19621. Covers xor8 (default) and binary_fuse32, including trade-offs and ALTER TABLE behavior. Co-Authored-By: Claude Sonnet 4.6 --- .../30-table-engines/00-fuse.md | 25 ++++++++++++++++++- .../30-table-engines/00-fuse.md | 24 +++++++++++++++++- 2 files changed, 47 insertions(+), 2 deletions(-) diff --git a/docs/cn/sql-reference/00-sql-reference/30-table-engines/00-fuse.md b/docs/cn/sql-reference/00-sql-reference/30-table-engines/00-fuse.md index 330a00ebce..91c45e53b0 100644 --- a/docs/cn/sql-reference/00-sql-reference/30-table-engines/00-fuse.md +++ b/docs/cn/sql-reference/00-sql-reference/30-table-engines/00-fuse.md @@ -4,7 +4,7 @@ title: Fuse Engine 表 import FunctionDescription from '@site/src/components/FunctionDescription'; - + ## 概述 @@ -126,6 +126,29 @@ CREATE TABLE ( --- +### `bloom_index_type` + +- **语法：** + `bloom_index_type = 'xor8' | 'binary_fuse32'` +- **描述：** + 指定 Bloom Index 使用的过滤器算法类型。默认为 `xor8`。对于有大量点查（point lookup）的表，推荐使用 `binary_fuse32`，它具有更低的误判率，但索引体积约为 `xor8` 的 4 倍。 + + 注意：`ALTER TABLE ... SET OPTIONS(bloom_index_type = ...)` 只影响新写入的数据和重建的 Bloom Index，已有的 `xor8` 格式索引文件与新的 `binary_fuse32` 索引文件可以在同一张表中共存。 + + **示例：** + ```sql + -- 建表时指定 bloom_index_type + CREATE TABLE t (a INT) bloom_index_type = 'binary_fuse32'; + + -- 修改已有表的 bloom_index_type（只影响后续写入） + ALTER TABLE t SET OPTIONS(bloom_index_type = 'binary_fuse32'); + + -- 改回 xor8 + ALTER TABLE t SET OPTIONS(bloom_index_type = 'xor8'); + ``` + +--- + ### `change_tracking` - **语法：** diff --git a/docs/en/sql-reference/00-sql-reference/30-table-engines/00-fuse.md b/docs/en/sql-reference/00-sql-reference/30-table-engines/00-fuse.md index 73181a5d46..27c532e072 100644 --- a/docs/en/sql-reference/00-sql-reference/30-table-engines/00-fuse.md +++ b/docs/en/sql-reference/00-sql-reference/30-table-engines/00-fuse.md @@ -4,7 +4,7 @@ title: Fuse Engine Tables import FunctionDescription from '@site/src/components/FunctionDescription'; - + ## Overview @@ -117,6 +117,28 @@ Below are the available Fuse Engine options, grouped by their purpose: --- +### `bloom_index_type` +- **Syntax:** + `bloom_index_type = 'xor8' | 'binary_fuse32'` +- **Description:** + Specifies the filter algorithm used for the bloom index. Defaults to `xor8`. Use `binary_fuse32` for tables with heavy point-lookup workloads — it offers a lower false-positive rate at the cost of a larger index size (approximately 4x that of `xor8`). + + Note that `ALTER TABLE ... SET OPTIONS(bloom_index_type = ...)` only affects new writes and rebuilt bloom indexes. Existing `xor8` index files and new `binary_fuse32` index files can coexist in the same table. + + **Examples:** + ```sql + -- Set bloom_index_type at table creation + CREATE TABLE t (a INT) bloom_index_type = 'binary_fuse32'; + + -- Change bloom_index_type for an existing table (affects new writes only) + ALTER TABLE t SET OPTIONS(bloom_index_type = 'binary_fuse32'); + + -- Revert to xor8 + ALTER TABLE t SET OPTIONS(bloom_index_type = 'xor8'); + ``` + +--- + ### `change_tracking` - **Syntax:** `change_tracking = True / False` From 599aebf892aea0b22d0b71436390db0e45a0b218 Mon Sep 17 00:00:00 2001 From: wubx Date: Fri, 3 Apr 2026 14:58:07 +0800 Subject: [PATCH 2/3] chore: update yarn.lock Co-Authored-By: Claude Sonnet 4.6 --- yarn.lock | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) diff --git a/yarn.lock b/yarn.lock index 89ff047d07..2fca8d406c 100644 --- a/yarn.lock +++ b/yarn.lock @@ -232,6 +232,19 @@ rc-util "^5.35.0" stylis "^4.3.4" +"@ant-design/cssinjs@^2.0.1": + version "2.1.2" + resolved "https://registry.yarnpkg.com/@ant-design/cssinjs/-/cssinjs-2.1.2.tgz#0219e37afdd957248b10da366febae1e4001c952" + integrity sha512-2Hy8BnCEH31xPeSLbhhB2ctCPXE2ZnASdi+KbSeS79BNbUhL9hAEe20SkUk+BR8aKTmqb6+FKFruk7w8z0VoRQ== + dependencies: + "@babel/runtime" "^7.11.1" + "@emotion/hash" "^0.8.0" + "@emotion/unitless" "^0.7.5" + "@rc-component/util" "^1.4.0" + clsx "^2.1.1" + csstype "^3.1.3" + stylis "^4.3.4" + "@ant-design/fast-color@^3.0.0": version "3.0.0" resolved "https://registry.npmmirror.com/@ant-design/fast-color/-/fast-color-3.0.0.tgz#fb5178203de825f284809538f5142203d0ef3d80" @@ -2815,7 +2828,7 @@ utility-types "^3.10.0" webpack "^5.88.1" -"@docusaurus/plugin-content-docs@3.9.2": +"@docusaurus/plugin-content-docs@3.9.2", "@docusaurus/plugin-content-docs@^3.9.2": version "3.9.2" resolved "https://registry.npmmirror.com/@docusaurus/plugin-content-docs/-/plugin-content-docs-3.9.2.tgz#cd8f2d1c06e53c3fa3d24bdfcb48d237bf2d6b2e" integrity sha512-C5wZsGuKTY8jEYsqdxhhFOe1ZDjH0uIYJ9T/jebHwkyxqnr4wW0jTkB72OMqNjsoQRcb0JN3PcSeTwFlVgzCZg== @@ -2988,7 +3001,7 @@ tslib "^2.6.0" utility-types "^3.10.0" -"@docusaurus/theme-common@3.9.2": +"@docusaurus/theme-common@3.9.2", "@docusaurus/theme-common@^3.9.2": version "3.9.2" resolved "https://registry.npmmirror.com/@docusaurus/theme-common/-/theme-common-3.9.2.tgz#487172c6fef9815c2746ef62a71e4f5b326f9ba5" integrity sha512-6c4DAbR6n6nPbnZhY2V3tzpnKnGL+6aOsLvFL26VRqhlczli9eWG0VDUNoCQEPnGwDMhPS42UhSAnz5pThm5Ag== @@ -6682,6 +6695,11 @@ dayjs@^1.11.13: resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.13.tgz#92430b0139055c3ebb60150aa13e860a4b5a366c" integrity sha512-oaMBel6gjolK862uaPQOVTA7q3TZhuSvuMQAAglQDOWYO9A91IrAOUJEyKVlqJlHE0vq5p5UXxzdPfMH/x6xNg== +dayjs@^1.11.19: + version "1.11.20" + resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.20.tgz#88d919fd639dc991415da5f4cb6f1b6650811938" + integrity sha512-YbwwqR/uYpeoP4pu043q+LTDLFBLApUP6VxRihdfNTqu4ubqMlGDLd6ErXhEgsyvY0K6nCs7nggYumAN+9uEuQ== + debounce@^1.2.1: version "1.2.1" resolved "https://registry.yarnpkg.com/debounce/-/debounce-1.2.1.tgz#38881d8f4166a5c5848020c11827b834bcb3e0a5" @@ -10800,7 +10818,7 @@ prompts@^2.4.2: kleur "^3.0.3" sisteransi "^1.0.5" -prop-types@^15.6.2, prop-types@^15.7.2: +prop-types@^15.6.2, prop-types@^15.7.2, prop-types@^15.8.1: version "15.8.1" resolved "https://registry.yarnpkg.com/prop-types/-/prop-types-15.8.1.tgz#67d87bf1a694f48435cf332c24af10214a3140b5" integrity sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg== @@ -11272,6 +11290,18 @@ remark-gfm@^4.0.0: remark-stringify "^11.0.0" unified "^11.0.0" +remark-gfm@^4.0.1: + version "4.0.1" + resolved "https://registry.yarnpkg.com/remark-gfm/-/remark-gfm-4.0.1.tgz#33227b2a74397670d357bf05c098eaf8513f0d6b" + integrity sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg== + dependencies: + "@types/mdast" "^4.0.0" + mdast-util-gfm "^3.0.0" + micromark-extension-gfm "^3.0.0" + remark-parse "^11.0.0" + remark-stringify "^11.0.0" + unified "^11.0.0" + remark-mdx@^3.0.0: version "3.0.1" resolved "https://registry.yarnpkg.com/remark-mdx/-/remark-mdx-3.0.1.tgz#8f73dd635c1874e44426e243f72c0977cf60e212" From 21eb7a99072989ba486f3578ad67ee8875385c6f Mon Sep 17 00:00:00 2001 From: wubx Date: Fri, 3 Apr 2026 14:58:50 +0800 Subject: [PATCH 3/3] Revert "chore: update yarn.lock" This reverts commit 599aebf892aea0b22d0b71436390db0e45a0b218. --- yarn.lock | 36 +++--------------------------------- 1 file changed, 3 insertions(+), 33 deletions(-) diff --git a/yarn.lock b/yarn.lock index 2fca8d406c..89ff047d07 100644 --- a/yarn.lock +++ b/yarn.lock @@ -232,19 +232,6 @@ rc-util "^5.35.0" stylis "^4.3.4" -"@ant-design/cssinjs@^2.0.1": - version "2.1.2" - resolved "https://registry.yarnpkg.com/@ant-design/cssinjs/-/cssinjs-2.1.2.tgz#0219e37afdd957248b10da366febae1e4001c952" - integrity sha512-2Hy8BnCEH31xPeSLbhhB2ctCPXE2ZnASdi+KbSeS79BNbUhL9hAEe20SkUk+BR8aKTmqb6+FKFruk7w8z0VoRQ== - dependencies: - "@babel/runtime" "^7.11.1" - "@emotion/hash" "^0.8.0" - "@emotion/unitless" "^0.7.5" - "@rc-component/util" "^1.4.0" - clsx "^2.1.1" - csstype "^3.1.3" - stylis "^4.3.4" - "@ant-design/fast-color@^3.0.0": version "3.0.0" resolved "https://registry.npmmirror.com/@ant-design/fast-color/-/fast-color-3.0.0.tgz#fb5178203de825f284809538f5142203d0ef3d80" @@ -2828,7 +2815,7 @@ utility-types "^3.10.0" webpack "^5.88.1" -"@docusaurus/plugin-content-docs@3.9.2", "@docusaurus/plugin-content-docs@^3.9.2": +"@docusaurus/plugin-content-docs@3.9.2": version "3.9.2" resolved "https://registry.npmmirror.com/@docusaurus/plugin-content-docs/-/plugin-content-docs-3.9.2.tgz#cd8f2d1c06e53c3fa3d24bdfcb48d237bf2d6b2e" integrity sha512-C5wZsGuKTY8jEYsqdxhhFOe1ZDjH0uIYJ9T/jebHwkyxqnr4wW0jTkB72OMqNjsoQRcb0JN3PcSeTwFlVgzCZg== @@ -3001,7 +2988,7 @@ tslib "^2.6.0" utility-types "^3.10.0" -"@docusaurus/theme-common@3.9.2", "@docusaurus/theme-common@^3.9.2": +"@docusaurus/theme-common@3.9.2": version "3.9.2" resolved "https://registry.npmmirror.com/@docusaurus/theme-common/-/theme-common-3.9.2.tgz#487172c6fef9815c2746ef62a71e4f5b326f9ba5" integrity sha512-6c4DAbR6n6nPbnZhY2V3tzpnKnGL+6aOsLvFL26VRqhlczli9eWG0VDUNoCQEPnGwDMhPS42UhSAnz5pThm5Ag== @@ -6695,11 +6682,6 @@ dayjs@^1.11.13: resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.13.tgz#92430b0139055c3ebb60150aa13e860a4b5a366c" integrity sha512-oaMBel6gjolK862uaPQOVTA7q3TZhuSvuMQAAglQDOWYO9A91IrAOUJEyKVlqJlHE0vq5p5UXxzdPfMH/x6xNg== -dayjs@^1.11.19: - version "1.11.20" - resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.20.tgz#88d919fd639dc991415da5f4cb6f1b6650811938" - integrity sha512-YbwwqR/uYpeoP4pu043q+LTDLFBLApUP6VxRihdfNTqu4ubqMlGDLd6ErXhEgsyvY0K6nCs7nggYumAN+9uEuQ== - debounce@^1.2.1: version "1.2.1" resolved "https://registry.yarnpkg.com/debounce/-/debounce-1.2.1.tgz#38881d8f4166a5c5848020c11827b834bcb3e0a5" @@ -10818,7 +10800,7 @@ prompts@^2.4.2: kleur "^3.0.3" sisteransi "^1.0.5" -prop-types@^15.6.2, prop-types@^15.7.2, prop-types@^15.8.1: +prop-types@^15.6.2, prop-types@^15.7.2: version "15.8.1" resolved "https://registry.yarnpkg.com/prop-types/-/prop-types-15.8.1.tgz#67d87bf1a694f48435cf332c24af10214a3140b5" integrity sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg== @@ -11290,18 +11272,6 @@ remark-gfm@^4.0.0: remark-stringify "^11.0.0" unified "^11.0.0" -remark-gfm@^4.0.1: - version "4.0.1" - resolved "https://registry.yarnpkg.com/remark-gfm/-/remark-gfm-4.0.1.tgz#33227b2a74397670d357bf05c098eaf8513f0d6b" - integrity sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg== - dependencies: - "@types/mdast" "^4.0.0" - mdast-util-gfm "^3.0.0" - micromark-extension-gfm "^3.0.0" - remark-parse "^11.0.0" - remark-stringify "^11.0.0" - unified "^11.0.0" - remark-mdx@^3.0.0: version "3.0.1" resolved "https://registry.yarnpkg.com/remark-mdx/-/remark-mdx-3.0.1.tgz#8f73dd635c1874e44426e243f72c0977cf60e212"