st_pointn-Funktion

Gilt für: Databricks SQL Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

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

• Wenn der Wert geoExpr keine Linienzeichenfolge ist, gibt die Funktion ST_INVALID_ARGUMENT.INVALID_TYPE zurück.
• Wenn es sich bei dem Wert geoExpr um eine leere Linienzeichenfolge handelt, gibt die Funktion ST_INVALID_ARGUMENT zurück. EMPTY_LINESTRING.
• Wenn der absolute Wert des Werts indexExpr 0 oder größer als die Anzahl der Punkte in der Linienzeichenfolge ist, gibt die Funktion ST_INVALID_ARGUMENT zurück. 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)

Zugehörige Funktionen

• st_addpoint Funktion
• st_removepoint Funktion
• st_setpoint Funktion