Teilen über

st_perimeter-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.

Rückgabe des Umfangs der Eingabe GEOGRAPHY oder GEOMETRY Wert.

Syntax

st_perimeter ( geoExpr )

Arguments

  • geoExpr: Ein GEOGRAPHY- oder GEOMETRY-Wert.

Returns

Ein Wert vom Typ DOUBLE, der den Umfang des Werts der Eingabe GEOGRAPHY oder GEOMETRY darstellt.

Wenn es sich bei der Eingabe um einen GEOGRAPHY Wert handelt, entspricht die Funktion dem geodätischen Umkreis des Eingabewerts GEOGRAPHY . Insbesondere gibt sie die Summe der geodätischen Längen der (2D-Projektionen) eines Polygons und die Summe der Umrandungen der Polygone in einem Multipolygon zurück. Für nicht-areale Regionen (Punkte, Linienzeichenfolgen, Multilinezeichenfolgen und mehrzeilige Zeichenfolgen) wird 0 zurückgegeben, während für Geometrieauflistungen die Summe der Umkreise der Elemente in der Auflistung zurückgegeben wird. Das Ergebnis wird berechnet, indem die inverse geodätische Berechnung auf Grundlage des WGS84-Ellipsoids durchgeführt wird. Die Einheiten des Ergebnisses sind Meter.

Wenn es sich bei der Eingabe um einen GEOMETRY Wert handelt, gibt die Funktion den kartesischen Umkreis des Eingabewerts GEOMETRY zurück. Insbesondere gibt sie die Summe der Längen der (2D-kartesischen Projektionen der Segmente) eines Polygons und die Summe der Umfänge der Polygone in einem Multipolygon zurück. Für nicht-areale Geometrien (Punkte, Linienzeichenfolgen, Multipoints und mehrzeilige Zeichenfolgen) wird 0 zurückgegeben, während für Geometrieauflistungen die Summe der Umrandungen der Elemente in der Auflistung zurückgegeben wird. Die Einheiten des Ergebnisses sind die Einheiten des Räumlichen Bezugssystems des Eingabewerts GEOMETRY .

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

Examples

-- Returns the perimeter of a 2D Cartesian polygon with a hole.
> SELECT round(st_perimeter(st_geomfromtext('POLYGON((0 0,50 0,50 50,0 50,0 0),(20 20,25 30,30 20,20 20))')), 2);
  232.36
  • Last updated on