Teilen über

st_geometryn-Funktion

Gilt für:check marked yes Databricks SQL check marked yes 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 das 1-basierte n-th-Element des Eingabewerts GEOMETRY als Wert zurück GEOMETRY .

Syntax

st_geometryn ( geoExpr, nExpr )

Arguments

  • geoExpr: Ein GEOMETRY Wert.
  • nExpr: Der 1-basierte Index des abzurufenden Elements.

Returns

Ein Wert vom Typ GEOMETRY, der das n-th-Element der Eingabegeometrie darstellt.

Wenn es sich bei der Eingabe um einen Multipoint, eine mehrteilige Zeichenfolge, ein Multipolygon oder eine Geometrieauflistung handelt, gibt die Funktion das n-th-Element zurück oder gibt einen Fehler zurück, wenn das Element nicht vorhanden ist.

Wenn es sich bei der Eingabe um einen nicht leeren Punkt, eine Linienzeichenfolge oder ein Polygon handelt und der Wert des Indexes gleich 1 ist, gibt die Funktion die Eingabe als GEOMETRY Wert zurück, andernfalls wird ein Fehler zurückgegeben.

Der SRID-Wert der Ausgabegeometrie entspricht dem des Eingabewerts.

Beachten Sie, dass Indizes, die kleiner als 1 sind, nicht unterstützt werden und zu einem Fehler führen.

Die Funktion gibt zurück NULL , wenn die Eingabe lautet NULL.

Fehlerbedingungen

Examples

-- Returns the second element of a geometry collection.
> SELECT st_astext(st_geometryn(st_geomfromtext('GEOMETRYCOLLECTION(POINT(4 5),LINESTRING(10 3,24 37,44 85))'), 2));
  LINESTRING(10 3,24 37,44 85)
-- Returns the first element of a multipoint.
> SELECT st_astext(st_geometryn(st_geomfromtext('MULTIPOINT((1 2),(3 4),(5 6))'), 1));
  POINT(1 2)
  • Last updated on