st_difference Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Devolve a diferença do conjunto de pontos dos dois valores de entrada GEOMETRY como um valor 2D GEOMETRY .

Syntax

st_difference ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: O primeiro GEOMETRY valor.
• geoExpr2: O segundo GEOMETRY valor.

Returns

Um valor do tipo GEOMETRY, que representa a diferença do conjunto de pontos das duas geometrias de entrada.

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

A função retorna 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

> SELECT st_astext(st_difference(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
  MULTIPOINT((-1 8),(5 6))

Funções relacionadas

• st_union Função
• st_intersection Função