docs: Add manual test notebook for job_history()

Author: shuoweil

notebooks/dataframes/job_history.ipynb

@@ -0,0 +1,148 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Job History Manual Test\\n",
+    "\\n",
+    "This notebook demonstrates and manually tests the `bigframes.pandas.job_history()` functionality."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import pandas as pd\\n",
+    "import bigframes.pandas as bpd\\n",
+    "\\n",
+    "# Set options if needed, e.g. project/location\\n",
+    "# bpd.options.bigquery.project = \"YOUR_PROJECT\"\\n",
+    "# bpd.options.bigquery.location = \"US\""
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 1. Trigger a Query Job (read_gbq)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "df = bpd.read_gbq(\"SELECT 1 as a, 2 as b\")\\n",
+    "df.head()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 2. Trigger a Load Job (read_pandas)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "local_df = pd.DataFrame({'col1': [1, 2, 3], 'col2': ['a', 'b', 'c']})\\n",
+    "bf_df = bpd.read_pandas(local_df)\\n",
+    "bf_df.head()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 3. Trigger a Computation (Computation Job)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Perform a simple aggregation to trigger a computation\\n",
+    "agg_df = bf_df.groupby('col2').sum()\\n",
+    "agg_df.head()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 4. Check Job History"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "history = bpd.job_history()\\n",
+    "history"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Verify Specific Columns"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Display key columns to verify data population\\n",
+    "cols_to_check = [\\n",
+    "    'job_id', \\n",
+    "    'job_type', \\n",
+    "    'creation_time', \\n",
+    "    'duration_seconds', \\n",
+    "    'total_bytes_processed', \\n",
+    "    'query', \\n",
+    "    'input_files',  # Should be populated for Load Job\\n",
+    "    'destination_table'\\n",
+    "]\\n",
+    "\\n",
+    "# Filter columns that exist in the history DataFrame\\n",
+    "existing_cols = [col for col in cols_to_check if col in history.columns]\\n",
+    "history[existing_cols]"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.8.5"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}