Partilhar via


st_buffer Função

Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

Important

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 buffer do valor de entrada GEOMETRY usando o raio especificado.

Syntax

st_buffer ( geoExpr, radiusExpr )

Arguments

  • geoExpr: Um GEOMETRY valor.
  • radiusExpr: Um valor DOUBLE para o raio do buffer. A unidade de medida do raio é a do sistema de referência de coordenadas da geometria.

Returns

Retorna o buffer do valor de entrada GEOMETRY usando o raio especificado. O buffer é a soma de Minkowski (se o raio não for negativo) ou a diferença de Minkowski (se o raio for negativo) desta geometria com um disco cujo raio é o raio radiusExprdado. O limite do resultado consiste, em teoria, em círculos ou arcos circulares. Aqui aproximamos esses arcos com polilinhas e retornamos o resultado como um valor de geometria. O resultado é sempre um polígono 2D ou multipolígono (as coordenadas Z e M na entrada são descartadas).

Examples

-- Expands a point into a circle-like polygon with a 1-unit radius.
> SELECT st_astext(st_envelope(st_buffer(st_geomfromtext('POINT(0 0)'), 1)));
  POLYGON((-1 -1,-1 1,1 1,1 -1,-1 -1))

-- Shrinks a small polygon so much that nothing is left
> SELECT st_astext(st_buffer(st_geomfromtext('POLYGON((0 0,2 0,2 2,0 2,0 0))'), -5));
  POLYGON EMPTY