Add supported database version for internal dialects

Change-Id: I08d150f1780a0f3a848c0edcd40013b5593d18f0

diff --git a/doc/build/dialects/index.rst b/doc/build/dialects/index.rst
index e4a7e932f7ea9a1dc777704cd1a674c2ce6cdb26..741b00d2f889c151e1d836fe46bbca47947f69ee 100644 (file)
--- a/doc/build/dialects/index.rst
+++ b/doc/build/dialects/index.rst
@@ -22,6 +22,36 @@ Included Dialects
     oracle
     mssql
 
+Support Levels for Included Dialects
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The following table summarizes the support level for each included dialect.
+
+.. dialect-table:: **Supported database versions for included dialects**
+  :header-rows: 1
+
+Support Definitions
+^^^^^^^^^^^^^^^^^^^
+
+.. glossary::
+
+    Fully tested in CI
+        **Fully tested in CI** indicates a version that is tested in the sqlalchemy
+        CI system and passes all the tests in the test suite.
+
+    Normal support
+        **Normal support** indicates that most features should work,
+        but not all versions are tested in the ci configuration so there may
+        be some not supported edge cases. We will try to fix issues that affect
+        these versions.
+
+    Best effort
+        **Best effort** indicates that we try to support basic features on them,
+        but most likely there will be unsupported features or errors in some use cases.
+        Pull requests with associated issues may be accepted to continue supporting
+        older versions, which are reviewed on a case-by-case basis.
+
+
 Deprecated, no longer supported dialects
 ----------------------------------------
 

diff --git a/doc/build/glossary.rst b/doc/build/glossary.rst
index f5ebe0a7daa3187e1bdd99140eba8b9431ee743c..2939fdf34c6acccf7694a212f32f4b6aab443532 100644 (file)
--- a/doc/build/glossary.rst
+++ b/doc/build/glossary.rst
@@ -1496,3 +1496,4 @@ Glossary
         .. seealso::
 
             :ref:`session_object_states`
+

diff --git a/lib/sqlalchemy/dialects/mssql/base.py b/lib/sqlalchemy/dialects/mssql/base.py
index 81f66e2f09b16721bbd4fcdf19112a92dfaa62b1..1be3965b8f8247e5be824a7916367a898dafa307 100644 (file)
--- a/lib/sqlalchemy/dialects/mssql/base.py
+++ b/lib/sqlalchemy/dialects/mssql/base.py
@@ -7,7 +7,9 @@
 """
 .. dialect:: mssql
     :name: Microsoft SQL Server
-
+    :full_support: 2017
+    :normal_support: 2012+
+    :best_effort: 2005+
 
 .. _mssql_external_dialects:
 

diff --git a/lib/sqlalchemy/dialects/mysql/base.py b/lib/sqlalchemy/dialects/mysql/base.py
index af35b3279b3d1eb0c142259552a0dbb396c1f734..e6052f69f7e81be06d7cac8883aa57fa51cebdea 100644 (file)
--- a/lib/sqlalchemy/dialects/mysql/base.py
+++ b/lib/sqlalchemy/dialects/mysql/base.py
@@ -9,6 +9,9 @@ r"""
 
 .. dialect:: mysql
     :name: MySQL / MariaDB
+    :full_support: 5.6, 5.7, 8.0 / 10.4, 10.5
+    :normal_support: 5.6+ / 10+
+    :best_effort: 5.0.2+ / 5.0.2+
 
 Supported Versions and Features
 -------------------------------

diff --git a/lib/sqlalchemy/dialects/oracle/base.py b/lib/sqlalchemy/dialects/oracle/base.py
index f9805abeb2bd70fbcd3f9d36fb1f47e6501a8bb4..88b1018113c6243d55f7d460d77c6386a5e22b83 100644 (file)
--- a/lib/sqlalchemy/dialects/oracle/base.py
+++ b/lib/sqlalchemy/dialects/oracle/base.py
@@ -8,9 +8,9 @@
 r"""
 .. dialect:: oracle
     :name: Oracle
-
-    Oracle version 8 through current (11g at the time of this writing) are
-    supported.
+    :full_support: 11.2, 18c
+    :normal_support: 11+
+    :best_effort: 8+
 
 
 Auto Increment Behavior

diff --git a/lib/sqlalchemy/dialects/postgresql/base.py b/lib/sqlalchemy/dialects/postgresql/base.py
index d34d8dd17b2aeef83b356b04bde37c50fdf6e42a..aea5ca17caea3f8d4381537f9e68dfa6ba43fe43 100644 (file)
--- a/lib/sqlalchemy/dialects/postgresql/base.py
+++ b/lib/sqlalchemy/dialects/postgresql/base.py
@@ -8,6 +8,9 @@
 r"""
 .. dialect:: postgresql
     :name: PostgreSQL
+    :full_support: 9.6, 10, 11, 12
+    :normal_support: 9.6+
+    :best_effort: 8+
 
 .. _postgresql_sequences:
 

diff --git a/lib/sqlalchemy/dialects/sqlite/base.py b/lib/sqlalchemy/dialects/sqlite/base.py
index 8582c1f14e0551a1f95bd14f51264412f4a33f3f..691ca642d1521926c9001bef23c2aa094c90c4fc 100644 (file)
--- a/lib/sqlalchemy/dialects/sqlite/base.py
+++ b/lib/sqlalchemy/dialects/sqlite/base.py
@@ -8,6 +8,9 @@
 r"""
 .. dialect:: sqlite
     :name: SQLite
+    :full_support: 3.21, 3.28+
+    :normal_support: 3.12+
+    :best_effort: 3.7.16+
 
 .. _sqlite_datetime: