st_removepoint Funkce

Platí pro: Kontrola SQL Databricks Databricks Runtime 17.1 a vyšší

Important

Tato funkce je ve verzi Public Preview.

Poznámka:

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Odebere n-tý bod ze vstupního řetězce GEOGRAPHY nebo GEOMETRY hodnoty.

Syntax

st_removepoint ( geoExpr, indexExpr )

Arguments

• geoExpr: Hodnota typu GEOGRAPHY nebo GEOMETRY představující liniový řetězec.
• indexExpr: Hodnota INTEGER označující pozici založenou na jedničce v geometrickém řetězci, kde má být bod odstraněn.

Returns

Hodnota typu GEOGRAPHY nebo GEOMETRY, která představuje spojnicový řetězec po odebrání bodu na pozici indexExpr.

Hodnota SRID výstupního řetězce se rovná hodnotě vstupní GEOGRAPHY nebo GEOMETRY.

Dimenze výstupního řádku je stejná jako u vstupního GEOGRAPHY řetězce nebo GEOMETRY hodnoty.

Funkce vrátí NULL , pokud je některý ze vstupů NULL.

Chybové podmínky

• Pokud hodnota geoExpr není cokoli jiného než linestring nebo je prázdný linestring, vrátí funkce ST_INVALID_ARGUMENT.INVALID_TYPE.
• Pokud je absolutní hodnota hodnoty indexExpr 0 nebo větší než počet bodů v řádku, vrátí funkce 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)

Související funkce

• st_addpoint funkce
• st_pointn funkce
• st_setpoint funkce