docs: add limitation note for loading REPEATED fields (#35)

googleapis · Feb 10, 2020 · 3d77a75 · 3d77a75
1 parent 344c00f
commit 3d77a75
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/google/cloud/bigquery/client.py b/google/cloud/bigquery/client.py
@@ -1712,6 +1712,14 @@ def load_table_from_dataframe(
         Similar to :meth:`load_table_from_uri`, this method creates, starts and
         returns a :class:`~google.cloud.bigquery.job.LoadJob`.
 
+        .. note::
+
+            Due to the way REPEATED fields are encoded in the ``parquet`` file
+            format, a mismatch with the existing table schema can occur, and
+            100% compatibility cannot be guaranteed for REPEATED fields.
+
+            https://github.com/googleapis/python-bigquery/issues/17
+
         Arguments:
             dataframe (pandas.DataFrame):
                 A :class:`~pandas.DataFrame` containing the data to load.