funktion st_removepoint

Gäller för: Databricks Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Tar bort den n:e punkten från indatalinjerna GEOGRAPHY eller GEOMETRY värdet.

Syntax

st_removepoint ( geoExpr, indexExpr )

Arguments

• geoExpr: Ett GEOGRAPHY eller GEOMETRY -värde som representerar en linjedragning.
• indexExpr: Ett INTEGER värde som anger den 1-baserade positionen i linjedragningen för punkten som ska tas bort.

Returns

Ett värde av typen GEOGRAPHY eller GEOMETRY, som representerar linjedragningen efter att punkten vid den indexExpr-th positionen har tagits bort.

SRID-värdet för utgångslinjen är lika med det för indata GEOGRAPHY eller GEOMETRY.

Dimensionen för utdatalinjesträngen är densamma som för indatavärdet GEOGRAPHY eller GEOMETRY.

Funktionen returnerar NULL om någon av indata är NULL.

Feltillstånd

• Om värdet för geoExpr inte är en linjedragning eller är en tom linje, returnerar funktionen ST_INVALID_ARGUMENT. INVALID_TYPE.
• Om det absoluta värdet för värdet indexExpr för är 0 eller större än antalet punkter i linjedragningen returnerar funktionen 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)

Relaterade funktioner

• st_addpoint funktion
• st_pointn funktion
• st_setpoint funktion