Teilen über


st_within-Funktion

Gilt für:check marked yes Databricks SQL check marked yes 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 true zurück, wenn sich der erste GEOMETRY Wert innerhalb des zweiten GEOMETRY Werts befindet.

Syntax

st_within ( geo1, geo2 )

Arguments

  • geo1: Der erste GEOMETRY Wert.
  • geo2: Der zweite GEOMETRY Wert.

Returns

Ein Wert vom Typ BOOLEAN, der angibt, ob sich der erste GEOMETRY Wert innerhalb des zweiten GEOMETRY Werts befindet.

Die Funktion unterstützt keine Geometrieauflistungen.

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

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

Fehlerbedingungen

Examples

-- Returns true when point is within polygon.
> SELECT st_within(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  true
-- Returns false when point is on boundary.
> SELECT st_within(st_geomfromtext('POINT(5 0)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false
-- Returns false when point is outside polygon.
> SELECT st_within(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
  false