Metadata-Version: 2.4
Name: pandas-gbq
Version: 0.34.0
Summary: Google BigQuery connector for pandas
Home-page: https://github.com/googleapis/python-bigquery-pandas
Author: pandas-gbq authors
Author-email: googleapis-packages@google.com
License: BSD-3-Clause
Platform: Posix; MacOS X; Windows
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.9
License-File: LICENSE.txt
License-File: AUTHORS.md
Requires-Dist: setuptools
Requires-Dist: db-dtypes<2.0.0,>=1.0.4
Requires-Dist: numpy>=1.18.1
Requires-Dist: pandas>=1.1.4
Requires-Dist: pyarrow>=4.0.0
Requires-Dist: pyarrow>=22.0.0; python_version >= "3.14"
Requires-Dist: pydata-google-auth>=1.5.0
Requires-Dist: psutil>=5.9.8
Requires-Dist: google-api-core<3.0.0,>=2.15.0
Requires-Dist: google-auth>=2.14.1
Requires-Dist: google-auth-oauthlib>=0.7.0
Requires-Dist: google-cloud-bigquery<4.0.0,>=3.20.0
Requires-Dist: packaging>=22.0.0
Provides-Extra: bqstorage
Requires-Dist: google-cloud-bigquery-storage<3.0.0,>=2.16.2; extra == "bqstorage"
Provides-Extra: tqdm
Requires-Dist: tqdm>=4.23.0; extra == "tqdm"
Provides-Extra: geopandas
Requires-Dist: geopandas>=0.9.0; extra == "geopandas"
Requires-Dist: Shapely>=1.8.4; extra == "geopandas"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: platform
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

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 <https://googleapis.dev/python/pandas-gbq/latest/>`_ for more details.
