Compartilhar via


st_buffer Função

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

Important

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

Observação

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

Syntax

st_buffer ( geoExpr, radiusExpr )

Arguments

  • geoExpr: valor de GEOMETRY.
  • radiusExpr: um valor de DOUBLE como raio do buffer. A unidade 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) dessa geometria com um disco cujo raio é o raio radiusExpr fornecido. 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