st_intersection Fonction

S’applique à : Databricks SQL Databricks Runtime 17.1 et versions ultérieures

Important

Cette fonctionnalité est disponible en préversion publique.

Note

Cette fonctionnalité n’est pas disponible sur les entrepôts Databricks SQL Classic. Pour en savoir plus sur les entrepôts SQL Databricks, consultez les types d’entrepôts SQL.

Retourne l’intersection point-set des deux valeurs d’entrée GEOMETRY sous la forme d’une valeur 2D GEOMETRY .

Syntax

st_intersection ( geoExpr1, geoExpr2 )

Arguments

• geoExpr1: première GEOMETRY valeur.
• geoExpr2: la deuxième GEOMETRY valeur.

Returns

Valeur de type GEOMETRY, représentant l’intersection point-set des deux géométries d’entrée.

Le SRID de la valeur retournée GEOMETRY est le SRID commun des géométries d’entrée.

La fonction retourne NULL si l’une des entrées est NULL.

Conditions d'erreur

• Si l’une des deux géométries fournies est une collection de géométries, la fonction retourne ST_INVALID_ARGUMENT.INVALID_TYPE.
• Si les deux géométries d’entrée ont des valeurs SRID différentes, la fonction retourne ST_DIFFERENT_SRID_VALUES.

Examples

-- Returns the intersection of a multipoint and a polygon.
> SELECT st_astext(st_intersection(st_geomfromtext('MULTIPOINT(EMPTY,4 3,5 6,-1 8)'),st_geomfromtext('POLYGON((0 0,10 0,0 10,0 0))')));
  POINT(4 3)
-- Returns the intersection of two overlapping polygons.
> SELECT st_astext(st_intersection(st_geomfromtext('POLYGON((0 0,10 0,10 10,0 10,0 0))'),st_geomfromtext('POLYGON((5 5,15 5,15 15,5 15,5 5))')));
  POLYGON((5 5,10 5,10 10,5 10,5 5))

Fonctions connexes

• Fonction st_union
• Fonction st_difference
• Fonction st_intersects