Add examples to docstrings for new register/read methods

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: timsaucer

python/datafusion/context.py

@@ -900,6 +900,11 @@ def register_batch(self, name: str, batch: pa.RecordBatch) -> None:
         Args:
             name: Name of the resultant table.
             batch: Record batch to register as a table.
+
+        Examples:
+            >>> batch = pa.RecordBatch.from_pydict({"a": [1, 2, 3]})
+            >>> ctx.register_batch("my_table", batch)
+            >>> ctx.sql("SELECT * FROM my_table").show()
         """
         self.ctx.register_batch(name, batch)
 
@@ -1120,6 +1125,10 @@ def register_arrow(
             schema: The data source schema.
             file_extension: File extension to select.
             table_partition_cols: Partition columns.
+
+        Examples:
+            >>> ctx.register_arrow("my_table", "data.arrow")
+            >>> ctx.sql("SELECT * FROM my_table").show()
         """
         if table_partition_cols is None:
             table_partition_cols = []
@@ -1381,6 +1390,10 @@ def read_arrow(
 
         Returns:
             DataFrame representation of the read Arrow IPC file.
+
+        Examples:
+            >>> df = ctx.read_arrow("data.arrow")
+            >>> df.show()
         """
         if file_partition_cols is None:
             file_partition_cols = []
@@ -1396,6 +1409,11 @@ def read_empty(self) -> DataFrame:
 
         Returns:
             An empty DataFrame.
+
+        Examples:
+            >>> df = ctx.read_empty()
+            >>> df.collect()
+            [pyarrow.RecordBatch]
         """
         return self.empty_table()