https://github.com/googleapis/python-bigquery-pandas
Google BigQuery connector for pandas
https://github.com/googleapis/python-bigquery-pandas
bigquery data pandas
Last synced: 21 days ago
JSON representation
Google BigQuery connector for pandas
- Host: GitHub
- URL: https://github.com/googleapis/python-bigquery-pandas
- Owner: googleapis
- License: bsd-3-clause
- Created: 2017-02-08T13:07:19.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2025-04-23T21:19:26.000Z (7 months ago)
- Last Synced: 2025-04-28T00:34:45.553Z (7 months ago)
- Topics: bigquery, data, pandas
- Language: Python
- Homepage: https://googleapis.dev/python/pandas-gbq/latest/index.html
- Size: 1.63 MB
- Stars: 468
- Watchers: 66
- Forks: 125
- Open Issues: 38
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Roadmap: ROADMAP.md
- Authors: AUTHORS.md
Awesome Lists containing this project
- best-of-python - GitHub - 0% open · ⏱️ 04.11.2025): (Database Clients)
README
pandas-gbq
==========
|preview| |pypi| |versions|
**pandas-gbq** is a package providing an interface to the Google BigQuery API from pandas.
- `Library Documentation`_
- `Product Documentation`_
.. |preview| image:: https://img.shields.io/badge/support-preview-orange.svg
:target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#beta-support
.. |pypi| image:: https://img.shields.io/pypi/v/pandas-gbq.svg
:target: https://pypi.org/project/pandas-gbq/
.. |versions| image:: https://img.shields.io/pypi/pyversions/pandas-gbq.svg
:target: https://pypi.org/project/pandas-gbq/
.. _Library Documentation: https://googleapis.dev/python/pandas-gbq/latest/
.. _Product Documentation: https://cloud.google.com/bigquery/docs/reference/v2/
Installation
------------
Install latest release version via pip
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code-block:: shell
$ pip install pandas-gbq
Install latest development version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. code-block:: shell
$ pip install git+https://github.com/googleapis/python-bigquery-pandas.git
Usage
-----
Perform a query
~~~~~~~~~~~~~~~
.. code:: python
import pandas_gbq
result_dataframe = pandas_gbq.read_gbq("SELECT column FROM dataset.table WHERE value = 'something'")
Upload a dataframe
~~~~~~~~~~~~~~~~~~
.. code:: python
import pandas_gbq
pandas_gbq.to_gbq(dataframe, "dataset.table")
More samples
~~~~~~~~~~~~
See the `pandas-gbq documentation `_ for more details.