적용 대상:
Databricks SQL Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
ST 지리 공간 함수는 GEOGRAPHY 및/또는 GEOMETRY 유형의 객체에서 작동하거나, 표준 또는 인기 있는 지리 공간 형식에서 GEOGRAPHY 및 GEOMETRY 값을 생성하며, GEOGRAPHY 및 GEOMETRY 값을 표준 또는 인기 있는 지리 공간 형식으로 내보낼 수 있습니다.
참고 항목:
Databricks 함수를 가져와 ST 함수 가져오기(Databricks 런타임)
Databricks SQL 및 Spark SQL에는 가져오기가 필요 없습니다.
Notebook에서 Python 또는 Scala에 대한 ST 함수를 가져오려면 다음 명령을 사용합니다.
Python
from pyspark.databricks.sql import functions as dbf
Scala
import com.databricks.sql.functions._
ST 지리 공간적 함수 목록(Databricks SQL)
Import
| Function | Description |
|---|---|
| st_geogfromgeojson(geojsonExpr) |
GEOGRAPHY(4326) GeoJSON 표현에서 값을 반환합니다. |
| st_geogfromtext(wktExpr) |
GEOGRAPHY(4326) 값이 WKT 표현에서 반환됩니다. |
| st_geogfromwkb(wktExpr) | WKB 형식에서의 표현값을 반환합니다. |
| st_geogfromwkt(wktExpr) |
GEOGRAPHY(4326) 값이 WKT 표현에서 반환됩니다. |
| st_geomfromewkb(wktExpr) |
GEOMETRY(ANY) EWKB 표현에서 값을 반환합니다. |
| st_geomfromgeohash(geohashExpr) | 입력 지오하시 값에 해당하는 지오하시 그리드 상자를 2D 다각형 GEOMETRY 값으로 반환합니다. |
| st_geomfromgeojson(geojsonExpr) |
GEOMETRY(4326) GeoJSON 표현에서 값을 반환합니다. |
| st_geomfromtext(wktExpr[, sridExpr]) | WKT 표현에서 GEOMETRY(srid) 또는 GEOMETRY(ANY) 값을 반환하고, SRID 값을 sridExpr 값으로 설정하거나, 0가 생략된 경우 sridExpr 값으로 설정합니다. |
| st_geomfromwkb(wkbExpr[, sridExpr]) | WKB 표현에서 GEOMETRY(srid) 또는 GEOMETRY(ANY) 값을 반환하고, SRID 값을 sridExpr 값으로 설정하거나, 0가 생략된 경우 sridExpr를 설정합니다. |
| st_geomfromwkt(wktExpr[, sridExpr]) | WKT 표현에서 GEOMETRY(srid) 또는 GEOMETRY(ANY) 값을 반환하고, SRID 값을 sridExpr 값으로 설정하거나, 0가 생략된 경우 sridExpr 값으로 설정합니다. |
| st_pointfromgeohash(geohash) | 입력 지오하시 값에 해당하는 지오하시 그리드 상자의 중심을 2D 점 기하 도형으로 반환합니다. |
| to_geography(georepExpr) |
GEOGRAPHY(ANY) GeoJSON, WKB 또는 WKT 표현에서 값을 반환합니다. |
| to_geometry(georepExpr) | EWKB, GeoJSON, WKB 또는 WKT 표현에서 GEOMETRY(ANY) 값을 반환합니다. |
| try_to_geography(georepExpr) |
GEOGRAPHY(ANY) GeoJSON, WKB 또는 WKT 표현에서 값을 반환하거나 NULL 입력 표현이 잘못된 경우 반환합니다. |
| try_to_geometry(georepExpr) |
GEOMETRY(ANY) EWKB, GeoJSON, WKB 또는 WKT 표현에서 값을 반환하거나 NULL 입력 표현이 잘못된 경우 반환합니다. |
Export
| Function | Description |
|---|---|
| st_asbinary(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 WKB 표현을 값으로 BINARY 반환합니다. |
| st_asewkb(geoExpr) | 입력 GEOMETRY 값의 EWKB 표현을 값으로 BINARY 반환합니다. |
| st_asgeojson(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 GeoJSON 표현을 값으로 STRING 반환합니다. |
| st_asewkt(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 EWKT 표현을 값으로 STRING 반환합니다. |
| st_astext(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 WKT 표현을 값으로 STRING 반환합니다. |
| st_aswkb(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 WKB 표현을 값으로 BINARY 반환합니다. |
| st_aswkt(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 WKT 표현을 값으로 STRING 반환합니다. |
| st_geohash(geoExpr [, precisionExpr]) | 지정된 정밀도로 입력 기하 도형의 지오하시를 반환합니다. |
Measurements
| Function | Description |
|---|---|
| st_area(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 영역을 반환합니다. |
| st_distance(geoExpr1, geoExpr2) | 두 입력 GEOMETRY 값 사이의 2D 카티시안 거리를 반환합니다. |
| st_distancesphere(geoExpr1, geoExpr2) | 반지름이 WGS84 타원의 평균 반지름인 구에서 측정된 두 점 GEOMETRY 값 사이의 구 거리를 미터 단위로 반환합니다. |
| st_distancespheroid(geoExpr1, geoExpr2) | WGS84 타원의 두 점 GEOMETRY 값 사이의 측지 거리(미터)를 반환합니다. |
| st_length(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 길이를 반환합니다. |
| st_perimeter(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 경계를 반환합니다. |
Constructors
| Function | Description |
|---|---|
| st_makeline(geoArray) | 기하 도형의 입력 배열에서 점, 선, 또는 다중점으로 예상되는 기하 도형의 비어 있지 않은 점들로 이루어진 라인스트링 GEOMETRY 값을 반환합니다. |
| st_makepolygon(outer[, innerArray]) | 입력 외부 경계에서 다각형 GEOMETRY 값을 생성하고 내부 경계의 선택적 배열을 닫은 줄 문자열로 나타냅니다. |
| st_point(x, y [, srid]) | 지정된 X 및 Y 좌표와 SRID 값(제공된 경우)이 있는 점 GEOMETRY 값을 반환합니다. |
Accessors
| Function | Description |
|---|---|
| st_dimension(geoExpr) |
GEOMETRY 값의 2D 투영의 위상 차원을 반환합니다. |
| st_dump(geoExpr) | 입력 기하 도형의 단일 기하 도형을 포함하는 배열을 반환합니다. |
| st_endpoint(geoExpr) | 입력한 지리 공간적 값이 비어있지 않은 라인스트링인 경우, 입력 GEOGRAPHY 또는 GEOMETRY 값의 마지막 지점을 반환합니다. |
| st_envelope(geoExpr) | 입력 GEOMETRY 값의 2D 축에 맞춘 최소 경계 상자(엔벌로프)를 나타내는 2D 카르티시안 GEOMETRY 값을 반환합니다. |
| st_envelope_agg(geoCol) | 열에 있는 모든 기하 도형의 경계 범위를 반환하거나, 열에 행이 0개일 경우 NULL 값을 반환하고, 열에 NULL 값만 포함된 경우 NULL 값을 반환합니다. |
| st_exteriorring(geoExpr) | 입력 다각형 GEOGRAPHY 의 외부 링을 반환하거나 GEOMETRY 줄 바꿈으로 반환합니다. |
| st_geometryn(geoExpr, nExpr) | 입력 GEOMETRY 값의 1부터 시작하는 n번째 요소를 값으로 GEOMETRY 반환합니다. |
| st_geometrytype(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 형식을 문자열로 반환합니다. |
| st_interiorringn(geoExpr, indexExpr) | 입력 다각형 GEOGRAPHYGEOMETRY 의 n번째 내부 링을 줄 바꿈으로 반환합니다. |
| st_isempty(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값에 비어 있지 않은 점이 없으면 true를 반환합니다. |
| st_m(geoExpr) | 입력 지점 GEOMETRY 값의 M 좌표를 반환하거나, 점이 비어 있거나 M 좌표가 없는 경우 NULL을 반환합니다. |
| st_ndims(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 좌표 차원을 반환합니다. |
| st_npoints(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값에서 비어있지 않은 점의 수를 반환합니다. |
| st_numgeometries(geoExpr) | 입력 GEOMETRY 값의 기하 도형 수를 반환합니다. |
| st_numinteriorrings(geoExpr) | 입력 다각형 GEOGRAPHY 또는 GEOMETRY 값의 내부 링 수를 반환합니다. |
| st_pointn(geoExpr, indexExpr) - 이 함수는 주어진 지리 표현(geoExpr)과 색인 표현(indexExpr)을 사용하여 특정 점을 추출하는 기능을 제공합니다. | 입력 줄 문자열 또는 GEOGRAPHY 값에서 n번째 점을 반환합니다GEOMETRY. |
| st_startpoint(geoExpr) | 입력된 지리 공간적 값이 비어있지 않은 라인스트링일 경우, 입력 GEOGRAPHY 또는 GEOMETRY 값의 첫 번째 지점을 반환합니다. |
| st_x(geoExpr) | 입력 지점 GEOMETRY 값의 X 좌표를 반환하거나 NULL 점이 비어 있으면 반환합니다. |
| st_xmax(geoExpr) | 입력 GEOMETRY 값의 최대 X 좌표를 반환하거나 NULL 기하 도형이 비어 있으면 반환합니다. |
| st_xmin(geoExpr) | 입력 GEOMETRY 값의 최소 X 좌표를 반환하거나 NULL 기하 도형이 비어 있으면 반환합니다. |
| st_y(geoExpr) | 입력 지점 GEOMETRY 값의 Y 좌표를 반환하거나 NULL 점이 비어 있으면 반환합니다. |
| st_ymax(geoExpr) | 입력 GEOMETRY 값의 최대 Y 좌표를 반환하거나 NULL 기하 도형이 비어 있으면 반환합니다. |
| st_ymin(geoExpr) | 입력 GEOMETRY 값의 최소 Y 좌표를 반환하거나 NULL 기하 도형이 비어 있으면 반환합니다. |
| st_z(geoExpr) | 입력 지점 GEOMETRY 값의 Z 좌표를 반환하거나 NULL 점이 비어 있거나 Z 좌표가 없는 경우 반환합니다. |
| st_zmax(geoExpr) | 입력 GEOMETRY 값의 최대 Z 좌표를 반환하거나 NULL 기하 도형이 비어 있거나 Z 좌표가 없는 경우 반환합니다. |
| st_zmin(geoExpr) | 입력 GEOMETRY 값의 최소 Z 좌표를 반환하거나 NULL 기하 도형이 비어 있거나 Z 좌표가 없는 경우 반환합니다. |
Editors
| Function | Description |
|---|---|
| st_addpoint(geo1Expr, geo2Expr[, indexExpr]) | 입력 라인스트링 GEOGRAPHY 또는 GEOMETRY 값의 n번째 위치에 새 지점을 추가합니다. |
| st_flipcoordinates(geoExpr) | 입력 GEOMETRY 값의 X 및 Y 좌표를 교환합니다. |
| st_multi(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값을 동등한 다중 지리 공간적 값으로 반환합니다. |
| st_removepoint(geoExpr, indexExpr) | 입력 라인스트링 GEOGRAPHY 또는 GEOMETRY 값에서 n번째 점을 제거합니다. |
| st_reverse(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값을 반대로 바뀝니다. |
| st_setpoint(geo1Expr, indexExpr, geo2Expr) | 입력 라인스트링 GEOGRAPHY 또는 GEOMETRY 값의 n번째 지점을 설정합니다. |
기하 도형 유효성 검사
| Function | Description |
|---|---|
| st_isvalid(geoExpr) | 입력 GEOMETRY 값이 OGC 의미에서 유효한 기하 도형이면 true를 반환합니다. |
공간 참조 시스템 함수
| Function | Description |
|---|---|
| st_setsrid(geo, srid) | 새로운 GEOMETRY 값을 반환하며 이 값은 지정된 SRID 값의 SRID를 가집니다. |
| st_srid(geoExpr) | 입력 GEOGRAPHY 또는 GEOMETRY 값의 SRID를 반환합니다. |
| st_transform(geo, srid) | 입력 GEOMETRY 의 X 및 Y 좌표를 현재 좌표 참조 시스템에서 제공된 SRID 값으로 설명된 좌표 참조 시스템으로 변환합니다. |
거리 관계
| Function | Description |
|---|---|
| st_dwithin(geoExpr1, geoExpr2, distanceExpr) | 두 입력 값 사이의 2D 카티시안 거리가 입력 GEOMETRY 거리 값보다 작거나 같으면 true를 반환합니다. |
토폴로지 관계
| Function | Description |
|---|---|
| st_contains(geo1, geo2) | 첫 번째 GEOMETRY 값에 두 번째 GEOMETRY 값이 포함된 경우 true를 반환합니다. |
| st_covers(geoExpr1, geoExpr2) | 첫 번째 GEOMETRY 값이 두 번째 GEOMETRY 값을 포함하는 경우 true를 반환합니다. |
| st_disjoint(geoExpr1, geoExpr2) | 두 입력 true 값이 서로 분리되어 있으면 GEOMETRY을 반환합니다. |
| st_equals(geoExpr1, geoExpr2) | 두 입력 GEOMETRY 값이 기하학적으로 같으면 true를 반환합니다. 즉, 동일한 점 집합에 해당합니다. |
| st_intersects(geoExpr1, geoExpr2) | 두 입력 GEOMETRY 값이 교차하면 true를 반환합니다. |
| st_touches(geo1, geo2) | 두 입력 GEOMETRY 값이 서로 닿으면 true를 반환합니다. |
| st_within(geo1, geo2) | 첫 번째 GEOMETRY 값이 두 번째 GEOMETRY 값 내에 있으면 true를 반환합니다. |
오버레이 함수
| Function | Description |
|---|---|
| st_difference(geoExpr1, geoExpr2) | 두 입력 GEOMETRY 값의 점 집합 차이를 2D GEOMETRY 값으로 반환합니다. |
| st_intersection(geoExpr1, geoExpr2) | 두 입력 GEOMETRY 값의 점 집합 교집합을 2D GEOMETRY 값으로 반환합니다. |
| st_union(geo1, geo2) | 두 입력 GEOMETRY 값의 점 집합 결합을 2D 기하 도형으로 반환합니다. |
| st_union_agg(geoCol) | 열에 있는 모든 기하 도형의 점 단위 결합을 반환하거나 NULL 열에 행이 0이거나 값만 NULL 포함된 경우 반환합니다. |
아핀 변환
| Function | Description |
|---|---|
| st_rotate(geoExpr, rotationAngle) | 지정된 회전 각도(라디안)로 Z 축 주위의 입력 GEOMETRY 값을 회전합니다. |
| st_scale(geoExpr, xfactor, yfactor[, zfactor]) | X, Y 및 지정된 경우 제공된 배율 인수를 사용하여 Z 방향의 입력 GEOMETRY 값 크기를 조정합니다. |
| st_translate(geoExpr, xoffset, yoffset[, zoffset]) | X, Y의 입력 GEOMETRY 값을 변환하고 지정된 경우 제공된 오프셋을 사용하여 Z 방향을 변환합니다. |
기하 도형 처리
| Function | Description |
|---|---|
| st_buffer(geoExpr, radiusExpr) | 지정된 반지름을 사용하여 입력 GEOMETRY 값의 버퍼를 반환합니다. |
| st_centroid(geoExpr) | 입력 GEOMETRY 값의 중심을 2D 포인트 GEOMETRY 값으로 반환합니다. |
| st_concavehull(geoExpr, lengthRatioExpr[, allowHolesExpr]) | 지정된 길이 비율을 사용하여 입력 GEOMETRY 값의 오목한 헐을 GEOMETRY 값으로 반환합니다. |
| st_convexhull(geoExpr) | 입력 GEOMETRY 값의 볼록 껍질을 GEOMETRY 값으로 반환합니다. |
| st_simplify(지역, 허용 오차) | Douglas-Peucker 알고리즘을 사용하여 입력 GEOMETRY 값을 간소화합니다. |