Поделиться через


st_boundary функция

Применяется к:помечено галочкой да Databricks SQL помечено галочкой да Databricks Runtime 18.0 и более поздних версий

Это важно

Эта функция доступна в общедоступной предварительной версии.

Замечание

Эта функция недоступна в классических хранилищах Databricks SQL. Дополнительные сведения о хранилищах SQL Databricks см. в разделе "Типы хранилища SQL".

Возвращает границу входного GEOMETRY значения в качестве GEOMETRY значения.

Синтаксис

st_boundary ( geoExpr )

Arguments

  • geoExpr: GEOMETRY значение.

Возвраты

GEOMETRY Возвращает значение, представляющее границу входного GEOMETRY значения. Точнее:

  • Если входные данные являются точкой, ее граница является соответствующей пустой точкой.
  • Если входные данные являются мультипоинтом, его граница - соответствующий пустой мультипоинт.
  • Если входные данные представляют собой линию, её граница является пустым мультипунктом, если она замкнута, или непустым мультипунктом, состоящим из двух конечных точек, если она не замкнута.
  • Если входные данные являются мультилайнстрокой, ее граница — это, возможно пустой, мультипойнт, который состоит из всех точек границ всех незамкнутых линейных строк с нечетной кратностью (по правилу mod-2).
  • Если входные данные являются пустым многоугольником, его граница является соответствующей пустой многолинейной строкой.
  • Если входные данные являются непустыми многоугольниками с одним внешним кольцом, его граница — это линия, представляющая внешнее кольцо.
  • Если входные данные являются непустыми многоугольниками как с внешним, так и по крайней мере одним внутренним кольцом, его граница является многострокой, содержащей кольца, представленные как линии.
  • Если входные данные являются пустым мультиполигоном, его граница является соответствующей пустой мультилинии.
  • Если входные данные являются непустым многополигоном с одной внешней границей, то его граница представляет собой линию, которая обозначает эту одну внешнюю границу.
  • Если входные данные являются непустыми многополигонами с по крайней мере двумя кольцами многоугольников, их граница — это многолинейный набор, содержащий линейные строки, представляющие кольца многоугольников.
  • Для коллекций граница может быть многоточкой, линейной строкой, многострокой или коллекцией, содержащей многоточие и линейную строку/многостроку.

Значение SRID возвращаемого GEOMETRY значения равно значению входного значения.

Примеры

> SELECT st_boundary(st_geomfromewkt('SRID=3857;POLYGON((0 0,10 0,10 10,0 10,0 0),(2 2,8 2,8 8,2 8,2 2))'));
  SRID=3857;MULTILINESTRING((0 0,10 0,10 10,0 10,0 0),(2 2,8 2,8 8,2 8,2 2))