summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2024-09-27 21:08:20 +0200
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2024-10-25 07:55:55 +0200
commit0b7edb9fcdd33d47ec5701b4f9b9553e27a88e95 (patch)
tree020f127c8c1fbd81a4a53861ef67d3a23f7081c9 /docs
parent6dcab75d5d8c2ef18de15323930057e6fa9ec00f (diff)
Refs #35803 -- Added support for __coveredby GIS lookup on MySQL and MariaDB 11.7+.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/contrib/gis/db-api.txt70
-rw-r--r--docs/ref/contrib/gis/geoquerysets.txt8
-rw-r--r--docs/releases/5.2.txt4
3 files changed, 46 insertions, 36 deletions
diff --git a/docs/ref/contrib/gis/db-api.txt b/docs/ref/contrib/gis/db-api.txt
index bce6f2efcc..8afc29869e 100644
--- a/docs/ref/contrib/gis/db-api.txt
+++ b/docs/ref/contrib/gis/db-api.txt
@@ -339,42 +339,42 @@ divided into the three categories described in the :ref:`raster lookup details
<spatial-lookup-raster>`: native support ``N``, bilateral native support ``B``,
and geometry conversion support ``C``.
-================================= ========= ======== ========= ============ ========== ========
-Lookup Type PostGIS Oracle MariaDB MySQL [#]_ SpatiaLite PGRaster
-================================= ========= ======== ========= ============ ========== ========
-:lookup:`bbcontains` X X X X N
-:lookup:`bboverlaps` X X X X N
-:lookup:`contained` X X X X N
-:lookup:`contains <gis-contains>` X X X X X B
-:lookup:`contains_properly` X B
-:lookup:`coveredby` X X X B
-:lookup:`covers` X X X B
-:lookup:`crosses` X X X X C
-:lookup:`disjoint` X X X X X B
-:lookup:`distance_gt` X X X X X N
-:lookup:`distance_gte` X X X X X N
-:lookup:`distance_lt` X X X X X N
-:lookup:`distance_lte` X X X X X N
-:lookup:`dwithin` X X X B
-:lookup:`equals` X X X X X C
-:lookup:`exact <same_as>` X X X X X B
-:lookup:`intersects` X X X X X B
+================================= ========= ======== ========== ============ ========== ========
+Lookup Type PostGIS Oracle MariaDB MySQL [#]_ SpatiaLite PGRaster
+================================= ========= ======== ========== ============ ========== ========
+:lookup:`bbcontains` X X X X N
+:lookup:`bboverlaps` X X X X N
+:lookup:`contained` X X X X N
+:lookup:`contains <gis-contains>` X X X X X B
+:lookup:`contains_properly` X B
+:lookup:`coveredby` X X X (≥ 11.7) X X B
+:lookup:`covers` X X X B
+:lookup:`crosses` X X X X C
+:lookup:`disjoint` X X X X X B
+:lookup:`distance_gt` X X X X X N
+:lookup:`distance_gte` X X X X X N
+:lookup:`distance_lt` X X X X X N
+:lookup:`distance_lte` X X X X X N
+:lookup:`dwithin` X X X B
+:lookup:`equals` X X X X X C
+:lookup:`exact <same_as>` X X X X X B
+:lookup:`intersects` X X X X X B
:lookup:`isempty` X
-:lookup:`isvalid` X X X X
-:lookup:`overlaps` X X X X X B
-:lookup:`relate` X X X X C
-:lookup:`same_as` X X X X X B
-:lookup:`touches` X X X X X B
-:lookup:`within` X X X X X B
-:lookup:`left` X C
-:lookup:`right` X C
-:lookup:`overlaps_left` X B
-:lookup:`overlaps_right` X B
-:lookup:`overlaps_above` X C
-:lookup:`overlaps_below` X C
-:lookup:`strictly_above` X C
-:lookup:`strictly_below` X C
-================================= ========= ======== ========= ============ ========== ========
+:lookup:`isvalid` X X X X
+:lookup:`overlaps` X X X X X B
+:lookup:`relate` X X X X C
+:lookup:`same_as` X X X X X B
+:lookup:`touches` X X X X X B
+:lookup:`within` X X X X X B
+:lookup:`left` X C
+:lookup:`right` X C
+:lookup:`overlaps_left` X B
+:lookup:`overlaps_right` X B
+:lookup:`overlaps_above` X C
+:lookup:`overlaps_below` X C
+:lookup:`strictly_above` X C
+:lookup:`strictly_below` X C
+================================= ========= ======== ========== ============ ========== ========
.. _database-functions-compatibility:
diff --git a/docs/ref/contrib/gis/geoquerysets.txt b/docs/ref/contrib/gis/geoquerysets.txt
index b639c5271e..2bafa8eb43 100644
--- a/docs/ref/contrib/gis/geoquerysets.txt
+++ b/docs/ref/contrib/gis/geoquerysets.txt
@@ -183,7 +183,7 @@ PostGIS ``ST_ContainsProperly(poly, geom)``
-------------
*Availability*: `PostGIS <https://postgis.net/docs/ST_CoveredBy.html>`__,
-Oracle, PGRaster (Bilateral), SpatiaLite
+Oracle, MariaDB 11.7+, MySQL, PGRaster (Bilateral), SpatiaLite
Tests if no point in the geometry field is outside the lookup geometry.
[#fncovers]_
@@ -197,9 +197,15 @@ Backend SQL Equivalent
========== =============================
PostGIS ``ST_CoveredBy(poly, geom)``
Oracle ``SDO_COVEREDBY(poly, geom)``
+MariaDB ``MBRCoveredBy(poly, geom)``
+MySQL ``MBRCoveredBy(poly, geom)``
SpatiaLite ``CoveredBy(poly, geom)``
========== =============================
+.. versionchanged:: 5.2
+
+ MySQL and MariaDB 11.7+ support was added.
+
.. fieldlookup:: covers
``covers``
diff --git a/docs/releases/5.2.txt b/docs/releases/5.2.txt
index 507676d998..faee74548e 100644
--- a/docs/releases/5.2.txt
+++ b/docs/releases/5.2.txt
@@ -100,6 +100,10 @@ Minor features
:meth:`.OGRGeometry.get_linear_geometry` and
:meth:`.OGRGeometry.get_curve_geometry` methods.
+* :lookup:`coveredby` lookup is now supported on MySQL.
+
+* :lookup:`coveredby` lookup is now supported on MariaDB 11.7+.
+
:mod:`django.contrib.messages`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~