Skip to main content

st_disjoint function

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Preview

This feature is in Public Preview.

note

This feature is not available on Databricks SQL Classic warehouses. To learn more about Databricks SQL warehouses, see SQL warehouse types

Returns true if the two geometries are disjoint.

Syntax

st_disjoint ( geoExpr1, geoExpr2 )

Arguments

  • geoExpr1: The first GEOMETRY value.
  • geoExpr2: The second GEOMETRY value.

Returns

A value of type BOOLEAN.

For more details on what it means for two geometries to be disjoint, see the Disjoint predicate in the DE-9IM matrix definition.

The function returns NULL if any of the inputs is NULL.

Error conditions

Examples

SQL
-- Returns false if geometries are not disjoint.
> SELECT st_disjoint(st_geomfromtext('POINT(1 1)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
false
-- Returns true if geometries are disjoint.
> SELECT st_disjoint(st_geomfromtext('POINT(5 6)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))'));
true