st_exteriorring функция

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

Возвращает внешнее кольцо входного многоугольника в виде линии.

Синтаксис

st_exteriorring ( geoExpr )

Arguments

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

Возвраты

Значение того же типа, что geoExprи . Функция возвращает пустую строку, если входные данные являются пустым многоугольником. В противном случае функция возвращает внешнее кольцо многоугольника в виде (закрытой) линии. SRID выходного значения равен значению входного значения.

Примечания.

Функция возвращается NULL , если входные данные являются NULL.

Условия ошибки

• Если geoExpr это не многоугольник, функция возвращает ST_INVALID_ARGUMENT. INVALID_TYPE.

Примеры

-- Example taking an empty 2D polygon GEOMETRY.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON EMPTY')));
  LINESTRING EMPTY

-- Example taking an empty 2D polygon GEOMETRY with one empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON(EMPTY)')));
  LINESTRING EMPTY

-- Example taking a 2D polygon GEOMETRY with one non-empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))', 3857)));
  SRID=3857;LINESTRING(0 0,10 0,0 10,0 0)

-- Example taking a 3DZ polygon GEOGRAPHY with two rings.
> SELECT st_asewkt(st_exteriorring(st_geogfromtext('POLYGON Z ((0 0 -1,10 0 -2,0 10 -3,0 0 -1),(1 1 -5,4 1 -6,1 4 -7,1 1 -5))')));
  SRID=4326;LINESTRING Z (0 0 -1,10 0 -2,0 10 -3,0 0 -1)

-- Example taking a NULL input.
> SELECT st_exteriorring(NULL);
  NULL

Связанные функции

• st_interiorringn функция
• st_makepolygon функция
• st_numinteriorrings функция