Partilhar via


st_exteriorring função

Aplica-se a:marcado como sim Databricks SQL marcado como sim Databricks Runtime 17.2 e superior

Importante

Este recurso está no Public Preview.

Observação

Esse recurso não está disponível nos armazéns Databricks SQL Classic. Para saber mais sobre os armazéns SQL do Databricks, consulte Tipos de armazém SQL.

Retorna o anel externo do polígono de entrada como uma cadeia de linha.

Sintaxe

st_exteriorring ( geoExpr )

Arguments

  • geoExpr: A GEOGRAPHY ou GEOMETRY valor.

Devoluções

Um valor do mesmo tipo que geoExpr. A função retorna uma cadeia de caracteres de linha vazia se a entrada for um polígono vazio. Caso contrário, a função retorna o anel externo do polígono como uma cadeia de linha (fechada). O SRID do valor de saída é igual ao do valor de entrada.

Observações

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

Condições de erro

Examples

-- Example taking an empty 2D polygon GEOMETRY.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON EMPTY')));
  LINESTRING EMPTY

-- Example taking an empty 2D polygon GEOMETRY with one empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON(EMPTY)')));
  LINESTRING EMPTY

-- Example taking a 2D polygon GEOMETRY with one non-empty ring.
> SELECT st_asewkt(st_exteriorring(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))', 3857)));
  SRID=3857;LINESTRING(0 0,10 0,0 10,0 0)

-- Example taking a 3DZ polygon GEOGRAPHY with two rings.
> SELECT st_asewkt(st_exteriorring(st_geogfromtext('POLYGON Z ((0 0 -1,10 0 -2,0 10 -3,0 0 -1),(1 1 -5,4 1 -6,1 4 -7,1 1 -5))')));
  SRID=4326;LINESTRING Z (0 0 -1,10 0 -2,0 10 -3,0 0 -1)

-- Example taking a NULL input.
> SELECT st_exteriorring(NULL);
  NULL