---
title: github-fill
description: 创建空间索引 OceanBase 数据库支持使用 SPATIAL 关键字创建空间索引，建表时空间索引列必须声明为 NOT NULL 。支持在存储（STORED）生成列上创建空间索引，不支持在虚拟（VIRTUAL）生成列上创建。 约束 创建空间索引的列定义中必须包含 NOT NULL 约束。 创建了空间索引的列需要已经…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# 创建空间索引

更新时间：2026-03-09 12:06:50

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/100.basic-elements-of-mysql-mode/100.data-type-of-mysql-mode/900.spatial-data-type-of-mysql-mode/400.create-spatial-indexes-of-mysql-mode.md)  

OceanBase 数据库支持使用 `SPATIAL` 关键字创建空间索引，建表时空间索引列必须声明为 `NOT NULL`。支持在存储（STORED）生成列上创建空间索引，不支持在虚拟（VIRTUAL）生成列上创建。

## 约束

- 创建空间索引的列定义中必须包含 `NOT NULL` 约束。
 - 创建了空间索引的列需要已经定义 SRID，否则在该列上建的空间索引在查询时无法生效。
 - 如果是在 STORED 生成列上创建空间索引，则创建列时 DDL 必须显式指定 `STORED` 关键字。如果在创建生成列的时候没有指定 `VIRTUAL` 或者 `STORED` 关键字，那么默认创建 VIRTUAL 生成列。
 - 在创建了索引之后，比较的时候使用列定义中的 SRID 所对应的坐标系。空间索引存储了几何对象的 MBR（Minimum Bounding Rectangle）构建，MBR 的比较方式也依赖于 SRID。

## 准备工作

使用 GIS 功能前，需在业务租户配置 GIS 元数据。在连接到服务器后，执行如下命令将 `default_srs_data_mysql.sql` 文件导入到数据库中：

#### 注意

仅支持在 SYS 租户下执行该导入命令，该命令执行时会将数据写入到主租户，并且会同步到备租户中。

```shell
-- module 表示待导入的模块。
-- tenant 表示待导入的租户。
-- infile 表示待导入 sql 文件的相对路径。
ALTER SYSTEM LOAD MODULE DATA module=gis tenant=mysql infile = 'etc/default_srs_data_mysql.sql';

```

语句语法具体说明请参见 [LOAD MODULE DATA](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000004479714)。

返回以下结果代表导入数据文件成功：

```shell
Query OK, 0 rows affected

```

## 示例

以下示例展示如何在常规列上创建空间索引：

- 使用 `CREATE TABLE`:

```sql
CREATE TABLE geom (g GEOMETRY NOT NULL SRID 4326, SPATIAL INDEX(g));

```

- 使用 `ALTER TABLE`：

```sql
CREATE TABLE geom (g GEOMETRY NOT NULL SRID 4326);
ALTER TABLE geom ADD SPATIAL INDEX(g);

```

- 使用 `CREATE INDEX`：

```sql
CREATE TABLE geom (g GEOMETRY NOT NULL SRID 4326);
CREATE SPATIAL INDEX g ON geom (g);

```

以下示例展示如何删除空间索引：

```sql
ALTER TABLE geom DROP INDEX g;

```

- 使用 `DROP INDEX`：

```sql
DROP INDEX g ON geom;

```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线