st_removepoint-Funktion

Gilt für: Databricks SQL Databricks Runtime 17.1 and above

Entfernt den n-ten Punkt aus dem Eingabe-Linienstring GEOGRAPHY oder dem Wert GEOMETRY.

Syntax

st_removepoint ( geoExpr, indexExpr )

Arguments

• geoExpr: Ein GEOGRAPHY- oder GEOMETRY-Wert, der einen Linienzug darstellt.
• indexExpr: Ein INTEGER Wert, der die 1-basierte Position in der Linienzeichenfolge des Punkts angibt, der entfernt werden soll.

Returns

Ein Wert vom Typ GEOGRAPHY oder GEOMETRY, der die Linienzeichenfolge nach dem Punkt an der indexExpr-th-Position darstellt, wurde entfernt.

Der SRID-Wert der Ausgabezeilenzeichenfolge entspricht dem der Eingabe GEOGRAPHY oder GEOMETRY.

Die Dimension des Ausgabe-Linienzugs entspricht der des EingabeGEOGRAPHY oder GEOMETRY-Werts.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Fehlerbedingungen

• Wenn der Wert von geoExpr keine Linienzeichenfolge ist oder eine leere Linienzeichenfolge ist, gibt die Funktion ST_INVALID_ARGUMENT.INVALID_TYPE zurück.
• Wenn der absolute Wert des Werts indexExpr 0 oder größer als die Anzahl der Punkte in der Linienzeichenfolge ist, gibt die Funktion ST_INVALID_ARGUMENT zurück. 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)

Zugehörige Funktionen

• st_addpoint Funktion
• st_pointn Funktion
• st_setpoint Funktion