创建空间列

本文档介绍了如何在 OceanBase 数据库中创建空间列。

准备工作

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

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

语句语法具体说明请参见 LOAD MODULE DATA。

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

Query OK, 0 rows affected

示例

OceanBase 数据库支持使用 CREATE TABLE 或 ALTER TABLE 创建空间列。

使用 CREATE TABLE 语句创建具有空间列的表，语法示例如下：

CREATE TABLE geom (g GEOMETRY);

使用 ALTER TABLE 语句在现有表中添加或删除空间列，语法示例如下：

ALTER TABLE geom ADD pt POINT;
ALTER TABLE geom DROP pt;

以下示例展示如何创建带有各种几何类型的表：

obclient> CREATE TABLE geom (
    p POINT SRID 0,
    g GEOMETRY NOT NULL SRID 4326
);
Query OK, 0 rows affected

创建空间列的相关约束如下：

• 定义空间列的时候，可以显式指定 SRID。如果列上没有定义 SRID，查询的时候优化器不会选择空间索引，但是插入/更新的时候，仍然会生成索引记录。

• 空间列在指定 NOT NULL 约束以及指定了 SRID 之后，可以在空间列上定义空间索引，也即只有定义了 SRID 的列才能使用空间索引。

• 在空间列上定义了 SRID 之后，插入其它 SRID 值会报错。

SRID 的相关约束如下：

• 空间列上显示指定了 SRID。

• 列上所有对象的 SRID 必须一样。