update docs to show pyarrow as the only dependency of load_table_from_dataframe() (googleapis#5582)

alixhami · web-flow · commit dd330d6da892 · 2018-07-10T16:10:28.000-07:00
diff --git a/bigquery/google/cloud/bigquery/client.py b/bigquery/google/cloud/bigquery/client.py
@@ -892,8 +892,7 @@ def load_table_from_dataframe(self, dataframe, destination,
         Raises:
             ImportError:
                 If a usable parquet engine cannot be found. This method
-                requires one of :mod:`pyarrow` or :mod:`fastparquet` to be
-                installed.
+                requires :mod:`pyarrow` to be installed.
         """
         buffer = six.BytesIO()
         dataframe.to_parquet(buffer)
diff --git a/docs/bigquery/usage.rst b/docs/bigquery/usage.rst
@@ -391,6 +391,9 @@ Jobs describe actions performed on data in BigQuery tables:
 Using BigQuery with Pandas
 --------------------------
 
+Retrieve BigQuery data as a Pandas DataFrame
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 As of version 0.29.0, you can use the
 :func:`~google.cloud.bigquery.table.RowIterator.to_dataframe` function to
 retrieve query results or table rows as a :class:`pandas.DataFrame`.
@@ -424,10 +427,20 @@ To retrieve table rows as a :class:`pandas.DataFrame`:
    :start-after: [START bigquery_list_rows_dataframe]
    :end-before: [END bigquery_list_rows_dataframe]
 
+Load a Pandas DataFrame to a BigQuery Table
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 As of version 1.3.0, you can use the
 :func:`~google.cloud.bigquery.client.Client.load_table_from_dataframe` function
 to load data from a :class:`pandas.DataFrame` to a
-:class:`~google.cloud.bigquery.table.Table`.
+:class:`~google.cloud.bigquery.table.Table`. To use this function, in addition
+to :mod:`pandas`, you will need to install the :mod:`pyarrow` library. You can
+install the BigQuery python client library with :mod:`pandas` and
+:mod:`pyarrow` by running:
+
+.. code-block:: bash
+
+   pip install --upgrade google-cloud-bigquery[pandas,pyarrow]
 
 The following example demonstrates how to create a :class:`pandas.DataFrame`
 and load it into a new table:
