This is an automated email from the ASF dual-hosted git repository.
zhangliang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/shardingsphere.git
The following commit(s) were added to refs/heads/master by this push:
new abbdba6755a Add sharding key limitation for document (#37428)
abbdba6755a is described below
commit abbdba6755ad8aeb7def57ccdf91aeef8b9fcbd8
Author: Liang Zhang <[email protected]>
AuthorDate: Thu Dec 18 21:18:55 2025 +0800
Add sharding key limitation for document (#37428)
---
docs/document/content/features/sharding/limitation.cn.md | 5 +++++
docs/document/content/features/sharding/limitation.en.md | 5 +++++
2 files changed, 10 insertions(+)
diff --git a/docs/document/content/features/sharding/limitation.cn.md
b/docs/document/content/features/sharding/limitation.cn.md
index f8e7d0dba29..1c7f66c7ae8 100644
--- a/docs/document/content/features/sharding/limitation.cn.md
+++ b/docs/document/content/features/sharding/limitation.cn.md
@@ -187,3 +187,8 @@ Oracle 和 SQLServer 由于分页查询较为复杂，目前有部分分页查
### 分号分隔多语句
不支持使用 `;` 分隔的多条 SQL 同时执行。
+
+### 分片键值提取
+
+分片键值仅支持可直接解析的字面量或绑定参数；
+需要类型标注、表达式计算或函数求值的写法当前不会用于分片值提取，可能触发全路由或路由校验失败。
diff --git a/docs/document/content/features/sharding/limitation.en.md
b/docs/document/content/features/sharding/limitation.en.md
index 42acdab9834..e81077d2975 100644
--- a/docs/document/content/features/sharding/limitation.en.md
+++ b/docs/document/content/features/sharding/limitation.en.md
@@ -178,3 +178,8 @@ Not support MySQL `LOAD DATA` and `LOAD XML` statements to
load data to sharding
### Semicolons separate multiple statements
Not support simultaneous execution of multiple SQL statements separated by `;`.
+
+### Shard key value extraction
+
+Shard key extraction only supports literals or bound parameters that can be
parsed directly;
+Values requiring type annotations, expression evaluation, or function
calculation are not used for sharding and may result in full routing or routing
validation failures.
