st_difference-Funktion

Gilt für: Databricks SQL Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt die Punktsatzdifferenz der beiden Eingabewerte GEOMETRY als 2D-Wert GEOMETRY zurück.

Syntax

st_difference ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: Der erste GEOMETRY Wert.
• geoExpr2: Der zweite GEOMETRY Wert.

Returns

Ein Wert vom Typ GEOMETRY, der den Punktsatzunterschied der beiden Eingabegeometrien darstellt.

Der SRID des zurückgegebenen GEOMETRY Werts ist die gängige SRID der Eingabegeometrien.

Die Funktion gibt zurück NULL , wenn eine der Eingaben lautet NULL.

Fehlerbedingungen

• Wenn einer der beiden Eingabegeometrien eine Geometriesammlung ist, gibt die Funktion ST_INVALID_ARGUMENT.INVALID_TYPE zurück.
• Wenn die beiden Eingabegeometrien unterschiedliche SRID-Werte aufweisen, gibt die Funktion ST_DIFFERENT_SRID_VALUES zurück.

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))

Zugehörige Funktionen

• st_union Funktion
• st_intersection Funktion