st_startpoint 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í první bod hodnoty vstupu GEOGRAPHY nebo GEOMETRY, pokud je vstupní geoprostorová hodnota neprázdný liniový řetězec.

Syntax

st_startpoint ( geoExpr )

Arguments

• geoExpr: Hodnota typu GEOGRAPHY nebo GEOMETRY představující liniový řetězec.

Returns

Hodnota typu GEOGRAPHY nebo GEOMETRY, představující první bod linie.

Hodnota SRID výstupního bodu je stejná jako hodnota vstupní hodnoty.

Rozměr výstupního bodu je stejný jako u vstupního řetězce.

Funkce vrátí NULL , pokud je NULLvstup .

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.

Examples

-- Returns first point of linestring with SRID.
> SELECT st_asewkt(st_startpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
  SRID=4326;POINT(1 2)
-- Returns first point with ZM coordinates.
> SELECT st_asewkt(st_startpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
  SRID=4326;POINT ZM (1 2 3 4)

Související funkce

• st_endpoint funkce
• st_geometryn funkce