docs: document deprecations for register_table_provider in favor of register_table

Author: kosiew

dev/changelog/49.0.0.md

@@ -25,6 +25,10 @@ This release consists of 16 commits from 7 contributors. See credits at the end
 
 - fix(build): Include build.rs in published crates [#1199](https://github.com/apache/datafusion-python/pull/1199) (colinmarc)
 
+**Deprecations:**
+
+- Document that `SessionContext.register_table_provider` is deprecated in favor of `SessionContext.register_table`.
+
 **Other:**
 
 - 48.0.0 Release [#1175](https://github.com/apache/datafusion-python/pull/1175) (timsaucer)

docs/source/user-guide/data-sources.rst

@@ -160,7 +160,14 @@ as Delta Lake. This will require a recent version of
     df = ctx.table("my_delta_table")
     df.show()
 
-On older versions of ``deltalake`` (prior to 0.22) you can use the 
+.. note::
+
+   :py:meth:`~datafusion.context.SessionContext.register_table_provider` is
+   deprecated. Use
+   :py:meth:`~datafusion.context.SessionContext.register_table` with a
+   :py:class:`~datafusion.TableProvider` instead.
+
+On older versions of ``deltalake`` (prior to 0.22) you can use the
 `Arrow DataSet <https://arrow.apache.org/docs/python/generated/pyarrow.dataset.Dataset.html>`_
 interface to import to DataFusion, but this does not support features such as filter push down
 which can lead to a significant performance difference.

docs/source/user-guide/io/table_provider.rst

@@ -54,6 +54,13 @@ Call the provider's ``__datafusion_table_provider__()`` method to obtain the cap
 before constructing a ``TableProvider``. The ``TableProvider.from_view()`` helper is
 deprecated; instead use ``TableProvider.from_dataframe()`` or ``DataFrame.into_view()``.
 
+.. note::
+
+   :py:meth:`~datafusion.context.SessionContext.register_table_provider` is
+   deprecated. Use
+   :py:meth:`~datafusion.context.SessionContext.register_table` with the
+   resulting :py:class:`~datafusion.TableProvider` instead.
+
 .. code-block:: python
 
     from datafusion import SessionContext, TableProvider