ENH: Move database error to error/__init__.py per GH27656 (#47674)

* ENH: Move error to error/__init__.py per GH27656

* ENH: apply feedback

* ENH: remove import

Author: dataxerik

doc/source/reference/testing.rst

@@ -29,6 +29,7 @@ Exceptions and warnings
    errors.AttributeConflictWarning
    errors.ClosedFileError
    errors.CSSWarning
+   errors.DatabaseError
    errors.DataError
    errors.DtypeWarning
    errors.DuplicateLabelError

pandas/errors/__init__.py

@@ -456,12 +456,26 @@ class AttributeConflictWarning(Warning):
     """
 
 
+class DatabaseError(OSError):
+    """
+    Error is raised when executing sql with bad syntax or sql that throws an error.
+
+    Examples
+    --------
+    >>> from sqlite3 import connect
+    >>> conn = connect(':memory:')
+    >>> pd.read_sql('select * test', conn) # doctest: +SKIP
+    ... # DatabaseError: Execution failed on sql 'test': near "test": syntax error
+    """
+
+
 __all__ = [
     "AbstractMethodError",
     "AccessorRegistrationWarning",
     "AttributeConflictWarning",
     "ClosedFileError",
     "CSSWarning",
+    "DatabaseError",
     "DataError",
     "DtypeWarning",
     "DuplicateLabelError",

pandas/io/sql.py

@@ -31,7 +31,10 @@
     DtypeArg,
 )
 from pandas.compat._optional import import_optional_dependency
-from pandas.errors import AbstractMethodError
+from pandas.errors import (
+    AbstractMethodError,
+    DatabaseError,
+)
 from pandas.util._exceptions import find_stack_level
 
 from pandas.core.dtypes.common import (
@@ -56,10 +59,6 @@
     from sqlalchemy import Table
 
 
-class DatabaseError(OSError):
-    pass
-
-
 # -----------------------------------------------------------------------------
 # -- Helper functions
 

pandas/tests/test_errors.py

@@ -34,6 +34,7 @@
         "PossibleDataLossError",
         "IncompatibilityWarning",
         "AttributeConflictWarning",
+        "DatabaseError",
     ],
 )
 def test_exception_importable(exc):