st_nrings Função

Aplica-se a: Databricks SQL, Databricks Runtime 18.1 ou superiores

Devolve o número total de anéis do polígono de entrada ou multipolígono, incluindo anéis exteriores e interiores. Para um multipolígono, devolve a soma de todos os anéis em todos os polígonos.

Sintaxe

st_nrings ( geoExpr )

Argumentos

• geoExpr: um valor GEOGRAPHY ou GEOMETRY.

Devoluções

Um INTEGER valor que representa o número total de anéis no polígono de entrada ou multipolígono.

Notes

A função retorna NULL se a entrada for NULL.

Condições de erro

• Se geoExpr não for um polígono ou multipolígono, a função devolve ST_INVALID_ARGUMENT. INVALID_TYPE.

Exemplos

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

Funções relacionadas

• st_exteriorring Função
• st_interiorringn Função
• st_numinteriorrings Função
• st_makepolygon Função