st_intersection Função

Aplica-se a: Databricks SQL 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 a interseção do conjunto de pontos dos dois valores de entrada GEOMETRY como um valor 2D GEOMETRY.

Syntax

st_intersection ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: Valor primeiro de GEOMETRY.
• geoExpr2: o segundo valor GEOMETRY.

Returns

Um valor de tipo GEOMETRY, representando a interseção de conjunto de pontos das duas geometrias de entrada.

O SRID do valor retornado GEOMETRY é o SRID comum das geometrias de entrada.

A função retornará NULL se qualquer uma das entradas for NULL.

Condições de erro

• Se qualquer uma das duas geometrias de entrada for uma coleção de geometria, a função retornará ST_INVALID_ARGUMENT. INVALID_TYPE.
• Se as duas geometrias de entrada tiverem valores SRID diferentes, a função retornará ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns the intersection of a multipoint and a polygon.
> SELECT st_astext(st_intersection(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
  POINT(4 3)
-- Returns the intersection of two overlapping polygons.
> SELECT st_astext(st_intersection(st_geomfromtext('POLYGON((0 0,10 0,10 10,0 10,0 0))'),st_geomfromtext('POLYGON((5 5,15 5,15 15,5 15,5 5))')));
  POLYGON((5 5,10 5,10 10,5 10,5 5))

Funções relacionadas

• st_union função
• st_difference função
• st_intersects função