https://github.com/googleapis/python-bigquery-pandas

Google BigQuery connector for pandas
https://github.com/googleapis/python-bigquery-pandas

bigquery data pandas

Last synced: 22 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 (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-05-29T19:41:07.000Z (5 months ago)
• Last Synced: 2024-05-30T00:27:01.233Z (5 months ago)
• Topics: bigquery, data, pandas
• Language: Python
• Homepage: https://googleapis.dev/python/pandas-gbq/latest/index.html
• Size: 1.34 MB
• Stars: 424
• Watchers: 61
• Forks: 119
• Open Issues: 37
• 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 - 10% open · ⏱️ 04.06.2024): (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.