st_pointn-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Unterstützung für GEOGRAFIE-Werte befindet sich in der öffentlichen Vorschau. Die Unterstützung für GEOMETRY-Werte ist allgemein verfügbar.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt den n-ten Punkt aus der Eingabe-Zeilenzeichenfolge GEOGRAPHY oder dem GEOMETRY Wert zurück.

Syntax

st_pointn ( 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 zurückgegeben werden soll.

Returns

Ein Wert vom Typ GEOGRAPHY oder GEOMETRY, der den Punkt an der indexExpr-th-Position der Eingabezeilenzeichenfolge darstellt.

Der SRID-Wert des Ausgabepunkts entspricht der des Eingabe- GEOGRAPHY oder GEOMETRY Werts.

Die Dimension des Ausgabepunkts entspricht der Dimension der Eingabe GEOGRAPHY oder GEOMETRY.

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

Fehlerbedingungen

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)