From 623db21f1687e06f519aef5e4d46ffccf90c64b9 Mon Sep 17 00:00:00 2001
From: Peter Lamut <inbox@peterlamut.com>
Date: Mon, 10 Feb 2020 17:04:06 +0000
Subject: [PATCH] docs: add limitation note for loading REPEATED fields

---
 google/cloud/bigquery/client.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/google/cloud/bigquery/client.py b/google/cloud/bigquery/client.py
index 5da12990b..188fb19cb 100644
--- 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.