Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à :
Databricks SQL Databricks Runtime 18.1 et versions ultérieures
Important
La prise en charge des valeurs GEOGRAPHY est disponible en préversion publique. La prise en charge des valeurs GEOMETRY est généralement disponible.
Note
Cette fonctionnalité n’est pas disponible sur les entrepôts Databricks SQL Classic. Pour en savoir plus sur les entrepôts SQL Databricks, consultez les types d’entrepôts SQL.
Retourne le nombre total d’anneaux du polygone d’entrée ou multipolygon, y compris les anneaux extérieurs et intérieurs. Pour un multipolygon, retourne la somme de tous les anneaux sur tous les polygones.
Syntaxe
st_nrings ( geoExpr )
Arguments
-
geoExpr: Une valeurGEOGRAPHYouGEOMETRY.
Retours
Valeur INTEGER qui représente le nombre total d’anneaux dans le polygone d’entrée ou le multipolygon.
Remarques
La fonction retourne NULL si l’entrée est NULL.
Conditions de l’erreur
- Si
geoExprce n’est pas un polygone ou un multipolygon, la fonction retourne ST_INVALID_ARGUMENT. INVALID_TYPE.
Exemples
-- 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