st_pointn Funkce

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

Important

Podpora hodnot GEOGRAPHY je ve verzi Public Preview. Podpora hodnot GEOMETRY je obecně dostupná.

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.

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

Syntax

st_pointn ( geoExpr, indexExpr )

Arguments

• geoExpr: Hodnota typu GEOGRAPHY nebo GEOMETRY představující liniový řetězec.
• indexExpr INTEGER: Hodnota označující pozici založenou na jedničce v řetězci linií pro bod, který by měl být vrácen.

Returns

Hodnota typu GEOGRAPHY nebo GEOMETRY, představující bod na pozici indexExpr v vstupním řetězci čar.

Hodnota SRID výstupního bodu se rovná hodnotě vstupu GEOGRAPHY nebo GEOMETRY hodnoty.

Dimenze výstupního bodu je stejná jako dimenze vstupu GEOGRAPHY nebo GEOMETRY hodnoty.

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

Chybové podmínky

• Pokud hodnota geoExpr není linestring, vrátí funkce ST_INVALID_ARGUMENT. INVALID_TYPE.
• Pokud je hodnota geoExpr prázdný řetězec linií, funkce vrátí ST_INVALID_ARGUMENT.EMPTY_LINESTRING.
• 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 third point of the linestring counting from the left.
> SELECT st_astext(st_pointn(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 3));
  POINT(5 6)
-- Returns the third point of the linestring counting from the right.
> SELECT st_astext(st_pointn(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -3));
  POINT(1 2)

Související funkce

• st_addpoint funkce
• st_removepoint funkce
• st_setpoint funkce