docs: add spatial index DDL (#3292)

Author: b41sh

docs/cn/sql-reference/10-sql-commands/00-ddl/07-spatial-index/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "空间索引 (Spatial Index)",
+  "position": 13
+}

docs/cn/sql-reference/10-sql-commands/00-ddl/07-spatial-index/create-spatial-index.md

@@ -0,0 +1,148 @@
+---
+title: CREATE SPATIAL INDEX
+sidebar_position: 1
+---
+
+在 Databend 中创建新的空间索引。
+
+## 语法
+
+```sql
+CREATE [ OR REPLACE ] SPATIAL INDEX [IF NOT EXISTS] <index>
+    ON [<database>.]<table>( <geometry_column>[, <geometry_column> ...] )
+```
+
+| 参数 | 描述 |
+|-----------|-------------|
+| `[ OR REPLACE ]` | 如果索引已存在，则替换已有索引。 |
+| `[ IF NOT EXISTS ]` | 仅在同名索引不存在时创建索引。 |
+| `<index>` | 空间索引的名称。 |
+| `[<database>.]<table>` | 包含被索引列的表。 |
+| `<geometry_column>` | 要加入索引的 `GEOMETRY` 列。语句中列名不能重复。 |
+
+## 使用说明
+
+- 空间索引仅支持 Fuse 表。
+- 空间索引仅支持 `GEOMETRY` 列，不支持 `GEOGRAPHY` 列。
+- 一个空间索引定义中可以包含多个列，这些列都必须是 `GEOMETRY` 类型。
+
+## 示例
+
+创建包含空间列的表：
+
+```sql
+CREATE TABLE stores (
+    store_id INT,
+    store_name STRING,
+    location GEOMETRY
+) ENGINE = FUSE;
+```
+
+在 `location` 列上创建空间索引：
+
+```sql
+CREATE SPATIAL INDEX stores_location_idx ON stores(location);
+```
+
+查看表定义：
+
+```sql
+SHOW CREATE TABLE stores;
+
+┌──────────────────────────────────────────────────────────────────────────────────────────────┐
+│ Table  │ Create Table                                                                      │
+├──────────────────────────────────────────────────────────────────────────────────────────────┤
+│ stores │ CREATE TABLE stores (                                                             │
+│        │   store_id INT NULL,                                                              │
+│        │   store_name VARCHAR NULL,                                                        │
+│        │   location GEOMETRY NULL,                                                         │
+│        │   SYNC SPATIAL INDEX stores_location_idx (location)                               │
+│        │ ) ENGINE=FUSE                                                                     │
+└──────────────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+插入一些用于空间过滤的示例数据：
+
+```sql
+INSERT INTO stores VALUES
+  (1, 'Starbucks', TO_GEOMETRY('POINT(10 10)')),
+  (2, 'Costa', TO_GEOMETRY('POINT(11 11)')),
+  (3, 'Gong Cha', TO_GEOMETRY('POINT(20 20)')),
+  (4, 'Dunkin', TO_GEOMETRY('POINT(-10 -10)'));
+```
+
+### 使用 `ST_WITHIN`、`ST_INTERSECTS` 和 `ST_CONTAINS` 过滤
+
+这些谓词是常见的 geofence 场景过滤条件，通常都可以从空间索引中受益。
+
+```sql
+-- 查询位于多边形内部的位置
+SELECT store_id, store_name
+FROM stores
+WHERE ST_WITHIN(
+    location,
+    TO_GEOMETRY('POLYGON((9 9, 9 12, 12 12, 12 9, 9 9))')
+)
+ORDER BY store_id;
+```
+
+```sql
+-- 查询与多边形相交的位置
+SELECT store_id, store_name
+FROM stores
+WHERE ST_INTERSECTS(
+    location,
+    TO_GEOMETRY('POLYGON((9 9, 9 12, 12 12, 12 9, 9 9))')
+)
+ORDER BY store_id;
+```
+
+```sql
+-- 查询被多边形包含的点
+SELECT store_id, store_name
+FROM stores
+WHERE ST_CONTAINS(
+    TO_GEOMETRY('POLYGON((9 9, 9 12, 12 12, 12 9, 9 9))'),
+    location
+)
+ORDER BY store_id;
+```
+
+### 使用 `ST_DWITHIN` 按距离过滤
+
+`ST_DWITHIN` 适合做半径范围查询，例如“查找附近位置”。
+
+```sql
+SELECT store_id, store_name
+FROM stores
+WHERE ST_DWITHIN(
+    location,
+    TO_GEOMETRY('POINT(10 10)'),
+    1.5
+)
+ORDER BY store_id;
+```
+
+### 在空间 Join 中过滤
+
+当 Join 条件是受支持的空间谓词时，空间索引同样有帮助。
+
+```sql
+CREATE TABLE districts (
+    district_id INT,
+    district_name STRING,
+    geom GEOMETRY
+) ENGINE = FUSE;
+
+INSERT INTO districts VALUES
+  (1, 'Central', TO_GEOMETRY('POLYGON((8 8, 8 13, 13 13, 13 8, 8 8))')),
+  (2, 'West', TO_GEOMETRY('POLYGON((-2 -2, -2 2, 2 2, 2 -2, -2 -2))'));
+```
+
+```sql
+SELECT d.district_name, s.store_name
+FROM districts AS d
+JOIN stores AS s
+  ON ST_WITHIN(s.location, d.geom)
+ORDER BY d.district_name, s.store_name;
+```

docs/cn/sql-reference/10-sql-commands/00-ddl/07-spatial-index/drop-spatial-index.md

@@ -0,0 +1,25 @@
+---
+title: DROP SPATIAL INDEX
+sidebar_position: 3
+---
+
+在 Databend 中删除空间索引。
+
+## 语法
+
+```sql
+DROP SPATIAL INDEX [IF EXISTS] <index> ON [<database>.]<table>
+```
+
+## 示例
+
+```sql
+CREATE TABLE stores (
+    store_id INT,
+    store_name STRING,
+    location GEOMETRY,
+    SPATIAL INDEX location_idx (location)
+) ENGINE = FUSE;
+
+DROP SPATIAL INDEX location_idx ON stores;
+```

docs/cn/sql-reference/10-sql-commands/00-ddl/07-spatial-index/index.md

@@ -0,0 +1,36 @@
+---
+title: 空间索引（Spatial Index）
+---
+
+Databend 中的空间索引可加速 `GEOMETRY` 列上的空间谓词过滤。它面向 Fuse 表设计，能够在执行精确空间函数前帮助优化器先做 block pruning。
+
+:::tip[关键特性：自动索引构建]
+空间索引会在索引创建后的新数据写入过程中自动维护。如果你是在表中已有数据后再创建索引，可以使用 `REFRESH SPATIAL INDEX` 对历史数据进行回填。
+:::
+
+## 空间索引管理
+
+| 命令 | 描述 |
+|---------|-------------|
+| [CREATE SPATIAL INDEX](create-spatial-index.md) | 在一个或多个 `GEOMETRY` 列上创建空间索引 |
+| [REFRESH SPATIAL INDEX](refresh-spatial-index.md) | 为索引创建前已有的数据回填空间索引 |
+| [DROP SPATIAL INDEX](drop-spatial-index.md) | 从表中删除空间索引 |
+
+## 支持的谓词
+
+Databend 可以使用空间索引来加速以下空间谓词构造的查询：
+
+- `ST_CONTAINS`
+- `ST_INTERSECTS`
+- `ST_WITHIN`
+- `ST_DWITHIN`
+
+## 限制
+
+- 空间索引仅支持 Fuse 表。
+- 被索引的列必须是 `GEOMETRY` 类型。
+- 不支持 `GEOGRAPHY` 列。
+
+## 相关主题
+
+- [地理空间函数](/sql/sql-functions/geospatial-functions)

docs/cn/sql-reference/10-sql-commands/00-ddl/07-spatial-index/refresh-spatial-index.md

@@ -0,0 +1,38 @@
+---
+title: REFRESH SPATIAL INDEX
+sidebar_position: 2
+---
+
+Databend 会在 `SYNC` 模式下对新写入的数据自动维护空间索引。`REFRESH SPATIAL INDEX` 主要用于在索引创建之前表中已经存在数据时，对这些历史数据进行回填。
+
+## 语法
+
+```sql
+REFRESH SPATIAL INDEX <index> ON [<database>.]<table> [LIMIT <limit>]
+```
+
+| 参数 | 描述 |
+|-----------|-------------|
+| `<limit>` | 指定本次刷新最多处理的行数。如果不指定，则处理表中的全部数据。 |
+
+## 示例
+
+```sql
+-- 先创建已经有数据的表
+CREATE TABLE IF NOT EXISTS stores (
+  store_id INT,
+  location GEOMETRY
+) ENGINE = FUSE;
+
+INSERT INTO stores VALUES
+  (1, TO_GEOMETRY('POINT(10 10)')),
+  (2, TO_GEOMETRY('POINT(20 20)'));
+
+-- 在表创建之后再添加空间索引
+CREATE SPATIAL INDEX stores_location_idx ON stores(location);
+
+-- 回填历史数据，让索引覆盖已有行
+REFRESH SPATIAL INDEX stores_location_idx ON stores;
+
+-- 之后的新写入会在 SYNC 模式下自动维护索引
+```

docs/cn/sql-reference/10-sql-commands/00-ddl/index.md

@@ -22,6 +22,8 @@ title: DDL（Data Definition Language）命令
 | **[聚合索引 (Aggregating Index)](07-aggregating-index/index.md)** | 预计算聚合以加快查询速度 |
 | **[倒排索引 (Inverted Index)](07-inverted-index/index.md)** | 用于文本列的全文搜索索引 |
 | **[Ngram 索引 (Ngram Index)](07-ngram-index/index.md)** | 用于 LIKE 模式的子字符串搜索索引 |
+| **[空间索引 (Spatial Index)](07-spatial-index/index.md)** | 用于 `GEOMETRY` 列的空间裁剪索引 |
+| **[向量索引 (Vector Index)](07-vector-index/index.md)** | 向量嵌入的相似度搜索索引 |
 | **[虚拟列 (Virtual Column)](07-virtual-column/index.md)** | 将 JSON 字段提取并索引为虚拟列 |
 
 ## 安全和访问控制

docs/en/sql-reference/10-sql-commands/00-ddl/07-spatial-index/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "Spatial Index",
+  "position": 13
+}