st_difference functie

Van toepassing op: Databricks Databricks Runtime 17.1 en hoger

Important

Deze functie bevindt zich in openbare preview-versie.

Opmerking

Deze functie is niet beschikbaar in Databricks SQL Classic Warehouses. Zie SQL Warehouse-typen voor meer informatie over Databricks SQL-warehouses.

Retourneert het puntsetverschil van de twee invoerwaarden GEOMETRY als een 2D-waarde GEOMETRY .

Syntax

st_difference ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: De eerste GEOMETRY waarde.
• geoExpr2: De tweede GEOMETRY waarde.

Returns

Een waarde van het type GEOMETRY, die het puntsetverschil van de twee invoergeometrieën aangeeft.

De SRID van de geretourneerde GEOMETRY waarde is de gemeenschappelijke SRID van de invoergeometrieën.

De functie retourneert NULL als een van de invoerwaarden is NULL.

Foutvoorwaarden

• Als een van de twee invoergeometrieën een geometrieverzameling is, retourneert de functie ST_INVALID_ARGUMENT. INVALID_TYPE.
• Als de twee invoergeometrieën verschillende SRID-waarden hebben, retourneert de functie 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))

Gerelateerde functies

• st_union Functie
• st_intersection Functie