> For the complete documentation index, see [llms.txt](https://docs.tibero.com/tibero-manuals/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/tibero-manuals/7.2.6.manuals/spatial-reference-guide/spatial-indexes.md).

# 공간 인덱스

Tibero Spatial에서는 공간 질의 성능 향상을 위해 RTREE 방식으로 구현된 공간 인덱스를 제공합니다. 좌표 계에 따라 평면 좌표계, 회전타원체 좌표계에 대한 인덱스를 제공합니다.

## 공간 인덱스 생성

공간 인덱스 생성 방법과 제약 사항을 설명합니다.

* 사용법

```
CREATE INDEX index_name on [schema_name.]
             table_name ON col_name RTREE
```

| 항목           | 설명                                                                  |
| ------------ | ------------------------------------------------------------------- |
| index\_name  | 생성할 공간 인덱스의 이름                                                      |
| schema\_name | 인덱스를 생성할 대상 테이블의 소유자.                                               |
| table\_name  | 인덱스를 생성할 대상 테이블                                                     |
| col\_name    | <ul><li>인덱스를 생성할 대상 컬럼을 설정</li><li>컬럼은 GEOMETRY TYPE이어야 함</li></ul> |
| RTREE        | RTREE 인덱스로 생성함을 의미하는 예약어                                            |

* 예제

```
SQL>CREATE TABLE GIS (ID INTEGER PRIMARY KEY, GEOM GEOMETRY);
Table 'GIS' created.
SQL>CREATE INDEX RT_IDX_GIS ON GIS(GEOM) RTREE;
Index 'RT_IDX_GIS' created.

INSERT INTO GIS VALUES (101, ST_GEOMFROMTEXT('POINT(1 1)'));
INSERT INTO GIS VALUES (102, ST_GEOMFROMTEXT('MULTIPOINT(1 1, 2 2)'));
INSERT INTO GIS VALUES (103, ST_GEOMFROMTEXT('LINESTRING(1 1, 2 2)'));
INSERT INTO GIS VALUES (104, ST_GEOMFROMTEXT('MULTILINESTRING((1 1, 2 2),
(3 3, 4 5))'));
INSERT INTO GIS VALUES (105, ST_GEOMFROMTEXT('POLYGON((1 1, 2 1, 2 2, 1 2,
1 1))'));
INSERT INTO GIS VALUES (106, ST_GEOMFROMTEXT('POLYGON((0 0, 0 12, 12 12, 12 0,0 0),
(6 10, 6 11, 9 11, 9 10,6 10), (6 3, 6 6, 9 6, 9 3,6 3))'));
INSERT INTO GIS VALUES (107, ST_GEOMFROMTEXT('MULTIPOLYGON(((1 1, 2 1, 2 2, 1 2, 1 1)),

((3 3, 3 5, 5 5, 5 3, 3 3)))'));
INSERT INTO GIS VALUES (108, ST_GEOMFROMTEXT('GEOMETRYCOLLECTION(POINT(1 1),
LINESTRING(2 2, 3 3))'));
INSERT INTO GIS VALUES (109, ST_BOUNDARY(ST_GEOMFROMTEXT('POINT(10 10)')));
INSERT INTO GIS VALUES (110, ST_GEOMFROMTEXT('GEOMETRYCOLLECTION(POINT(1 1),
LINESTRING(2 2, 3 3))'));
COMMIT;
```

### 공간 인덱스 제약 사항

공간 인덱스에는 다음과 같은 제약 사항이 있습니다.

* 여러 컬럼에 대해 하나의 인덱스를 걸 수 없습니다.
* 공간 인덱스는 파티션될 수 없습니다.
* 공간 인덱스는 GEOMETRY TYPE이 아닌 컬럼에 대하여 생성할 수 없습니다.
* SQL의 WHERE 절에서 다음 함수를 사용할 때만 공간 인덱스를 사용할 수 있습니다.
  * ST\_CONTAINS
  * ST\_COVEREDBY
  * ST\_COVERS
  * ST\_CROSSES
  * ST\_DWITHIN
  * ST\_EQUALS
  * ST\_FILTER
  * ST\_INTERSECTS
  * ST\_OVERLAPS
  * ST\_TOUCHES
  * ST\_WITHIN
* 회전타원체 좌표계의 공간 인덱스는 해당 테이블의 GEOMETRY 컬럼에 제약 조건을 추가하여 생성 가능합니다.

– 사용법

```
ALTER TABLE table_name ADD CONSTRAINTS
constraint_name CHECK(ST_SRID(col_name)=srid);
```

– 예제

```
SQL>DROP INDEX RT_IDX_GIS;
Index 'RT_IDX_GIS' dropped.
SQL>UPDATE GIS SET GEOM=ST_SETSRID(GEOM,4326);
10 rows updated.
SQL>ALTER TABLE GIS ADD CONSTRAINTS SRID4326 CHECK(ST_SRID(GEOM)=4326);
Table 'GIS' altered.
SQL>CREATE INDEX RT_IDX_4326 ON GIS(GEOM) RTREE;
Index 'RT_IDX_4326' created. COMMIT;
```

* 기존의 GEOMETRY 컬럼의 좌표계를 변경하여 공간 인덱스를 생성해야 할 경우, 기존의 제약 조건이 있다면 이를 삭제하고 GEOMETRY들의 SRID를 변경한 후, 해당 SRID에 대한 제약 조건을 추가하여 공간 인덱스를 생성합니다.<br>

– 사용법

```
ALTER TABLE table_name DROP CONSTRAINTS constraint_name;
```

– 예제

```
SQL>DROP INDEX RT_IDX_4326;
Index 'RT_IDX_4326' dropped.
SQL>ALTER TABLE GIS DROP CONSTRAINTS SRID4326;
Table 'GIS' altered.
SQL>UPDATE GIS SET GEOM=ST_SETSRID(GEOM,0);
10 rows updated.
SQL>ALTER TABLE GIS ADD CONSTRAINTS SRID4326 CHECK(ST_SRID(GEOM)=0);
Table 'GIS' altered.
SQL>CREATE INDEX RT_IDX_GIS ON GIS(GEOM) RTREE;
Index 'RT_IDX_GIS' created.
COMMIT;
```

## 공간 인덱스 제거

공간 인덱스 제거 방법은 다른 인덱스와 동일합니다.

* 사용법

<table><thead><tr><th width="233">항목</th><th>설명</th></tr></thead><tbody><tr><td>index_name</td><td>삭제할 공간 인덱스의 이름</td></tr></tbody></table>
