st_nrings-Funktion

Gilt für:markiert als ja Databricks SQL markiert als ja Databricks Runtime 18.1 und höher

Von Bedeutung

Dieses Feature befindet sich in der Public Preview.

Note

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

Gibt die Gesamtanzahl der Ringe des Eingabepolygons oder Multipolygons zurück, einschließlich Außen- und Innenringen. Gibt für ein Multipolygon die Summe aller Ringe über alle Polygone zurück.

Syntax

st_nrings ( geoExpr )

Argumente

  • geoExpr: Ein GEOGRAPHY- oder GEOMETRY-Wert.

Rückkehr

Ein INTEGER Wert, der die Gesamtanzahl der Ringe im Eingabepolygon oder Multipolygon darstellt.

Hinweise

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

Fehlerbedingungen

Beispiele

-- Example taking an empty 2D polygon GEOMETRY.
> SELECT st_nrings(st_geomfromtext('POLYGON EMPTY'));
  0
-- Example taking a 4D polygon GEOGRAPHY with two rings (one exterior, one interior).
> SELECT st_nrings(st_geogfromtext('POLYGON ZM ((0 0 111 -11,10 0 222 -22,0 10 333 -33,0 0 444 -44),(1 1 555 -55,4 1 666 -66,1 4 777 -77,1 1 888 -88))'));
  2
-- Example taking an empty 3DZ multipolygon GEOMETRY.
> SELECT st_nrings(st_geomfromtext('MULTIPOLYGON Z EMPTY', 4326));
  0
-- Example taking a multipolygon GEOGRAPHY with four rings across two polygons.
> SELECT st_nrings(st_geogfromtext('MULTIPOLYGON (((0 0,10 0,10 10,0 10,0 0),(1 1,4 1,4 4,1 4,1 1),(5 5,6 5,6 6,5 6,5 5)),((20 20,30 20,30 30,20 30,20 20)))'));
  4