add-FutureWarning-pandas.io.sql.execute

Author: luke

doc/source/whatsnew/v2.0.0.rst

@@ -510,7 +510,7 @@ Other API changes
 Deprecations
 ~~~~~~~~~~~~
 - Deprecated argument ``infer_datetime_format`` in :func:`to_datetime` and :func:`read_csv`, as a strict version of it is now the default (:issue:`48621`)
-
+- Deprecated :func:`pandas.io.sql.execute`(:issue:`50185`)
 .. ---------------------------------------------------------------------------
 
 .. _whatsnew_200.prior_deprecations:

pandas/io/sql.py

@@ -201,6 +201,12 @@ def execute(sql, con, params=None):
     -------
     Results Iterable
     """
+    warnings.warn(
+        "`pandas.io.sql.execute` is deprecated and "
+        "will be removed in the future version.",
+        FutureWarning,
+        stacklevel=find_stack_level(),
+    )  # GH50185
     sqlalchemy = import_optional_dependency("sqlalchemy", errors="ignore")
 
     if sqlalchemy is not None and isinstance(con, (str, sqlalchemy.engine.Engine)):

pandas/tests/io/test_sql.py

@@ -668,6 +668,15 @@ def test_execute_typeerror(sqlite_iris_engine):
         sql.execute("select * from iris", sqlite_iris_engine)
 
 
+def test_execute_deprecated(sqlite_buildin_iris):
+    with tm.assert_produces_warning(
+        FutureWarning,
+        match="`pandas.io.sql.execute` is deprecated and "
+        "will be removed in the future version.",
+    ):
+        sql.execute("select * from iris", sqlite_buildin_iris)
+
+
 class MixInBase:
     def teardown_method(self):
         # if setup fails, there may not be a connection to close.