st_nrings Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 18.1 and above

Importante

Esse recurso está em Visualização Pública.

Note

Esse recurso não está disponível em databricks SQL Classic warehouses. Para saber mais sobre os sql warehouses do Databricks, consulte os tipos de sql warehouse.

Retorna o número total de anéis do polígono de entrada ou multipolígono, incluindo anéis externos e interiores. Para um multipolígono, retorna 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.

Observações

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

Condições de erro

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
  • Last updated on