diff --git a/docs/index.rst b/docs/index.rst index ec360de69..62a82e0e9 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,5 +1,14 @@ .. include:: README.rst +.. note:: + + Because the BigQuery client uses the third-party :mod:`requests` library + by default and the BigQuery-Storage client uses :mod:`grpcio` library, + both are safe to share instances across threads. In multiprocessing + scenarios, the best practice is to create client instances *after* + :class:`multiprocessing.Pool` or :class:`multiprocessing.Process` invokes + :func:`os.fork`. + More Examples ~~~~~~~~~~~~~