Tests if a geometry value spatially contains another geometry value.
SELECT NEW ST_Polygon( 'Polygon(( 0 0, 2 0, 1 2, 0 0 ))' ) .ST_Contains( NEW ST_Point( 1, 1 ) )
The following example tests if a polygon contains a line. The polygon completely contains the line, but the interior of the line and the interior of the polygon do not intersect (the line only intersects the polygon on the polygon's boundary, and the boundary is not part of the interior), so the example returns 0. If ST_Covers was used in place of ST_Contains, ST_Covers would return 1.
SELECT NEW ST_Polygon( 'Polygon(( 0 0, 2 0, 1 2, 0 0 ))' ) .ST_Contains( NEW ST_LineString( 'LineString( 0 0, 1 0 )' ) )
The following example lists the ShapeIDs where the given polygon contains each Shape geometry. This example returns the result 16,17,19. Note that ShapeID 1 is not listed because the polygon intersects that row's Shape point at the polygon's boundary.
SELECT LIST( ShapeID ORDER BY ShapeID ) FROM SpatialShapes WHERE NEW ST_Polygon( NEW ST_Point( 0, 0 ), NEW ST_Point( 8, 2 ) ).ST_Contains( Shape ) = 1
SQL/MM (ISO/IEC 13249-3: 2006) 5.1.31