st_contains-Funktion

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

Gibt true zurück, wenn der erste GEOMETRY Wert den zweiten GEOMETRY Wert enthält.

Syntax

st_contains ( geoExpr1, geoExpr2 )

Arguments

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

Returns

Ein Wert vom Typ BOOLEAN, der angibt, ob der erste GEOMETRY Wert den zweiten GEOMETRY Wert enthält.

Die Funktion unterstützt keine Geometrieauflistungen.

Weitere Details und die formale Definition finden Sie im Contains-Prädikat in der DE-9IM-Matrixdefinition.

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_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(1 1)'));
  true

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 0)'));
  false

> SELECT st_contains(st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'),st_geomfromtext('POINT(5 6)'));
  false

Zugehörige Funktionen

• st_covers Funktion
• st_disjoint Funktion
• st_equals Funktion
• st_intersects Funktion
• st_touches Funktion
• st_within Funktion