Функция st_removepoint

Применяется к:check помеченный да флажок Databricks SQL помечен да Databricks Runtime 17.1 и более поздних версий

Important

Поддержка значений GEOGRAPHY доступна в общедоступной предварительной версии. Общедоступная поддержка значений GEOMETRY.

Замечание

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

Удаляет n-ю точку из входной линии GEOGRAPHY или GEOMETRY.

Syntax

st_removepoint ( geoExpr, indexExpr )

Arguments

  • geoExpr: значение GEOGRAPHY или GEOMETRY, представляющее линейную строку.
  • indexExpr INTEGER: значение, указывающее позицию, начиная с 1, в строке линий точки, которая должна быть удалена.

Returns

Значение типа GEOGRAPHY или GEOMETRY, представляющее линию после удаления точки из indexExpr-й позиции.

Значение SRID выходной строки равно значению входных GEOGRAPHY или GEOMETRY значений.

Измерение выходной линии совпадает с измерением входных GEOGRAPHY или GEOMETRY значений.

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

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

  • Если значение geoExpr не является строкой или пустой строкой, функция возвращает ST_INVALID_ARGUMENT. INVALID_TYPE.
  • Если абсолютное значение значения indexExpr равно 0 или больше числа точек в строке, функция возвращает ST_INVALID_ARGUMENT. INVALID_INDEX_VALUE.

Examples

-- Returns the linestring after removing the second point counting from the left.
> SELECT st_astext(st_removepoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 2));
  LINESTRING(1 2,5 6)
-- Returns the linestring after removing the first point counting from the right.
> SELECT st_asewkt(st_removepoint(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -1));
  SRID=4326;LINESTRING(1 2,3 4)
  • Last updated on