Metadata-Version: 2.1
Name: dask-bigquery
Version: 2021.10.1
Summary: Dask + BigQuery intergration
Home-page: UNKNOWN
License: BSD
Platform: UNKNOWN
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: dask
Requires-Dist: google-cloud-bigquery (>=2.11.0)
Requires-Dist: google-cloud-bigquery-storage
Requires-Dist: pandas
Requires-Dist: pyarrow
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pandas-gbq ; extra == 'test'
Requires-Dist: distributed ; extra == 'test'
Requires-Dist: google-auth (>=1.30.0) ; extra == 'test'

# Dask-BigQuery

[![Tests](https://github.com/coiled/dask-bigquery/actions/workflows/tests.yml/badge.svg)](https://github.com/coiled/dask-bigquery/actions/workflows/tests.yml) [![Linting](https://github.com/coiled/dask-bigquery/actions/workflows/pre-commit.yml/badge.svg)](https://github.com/coiled/dask-bigquery/actions/workflows/pre-commit.yml)

Read data from Google BigQuery with Dask

## Installation

`dask-bigquery` can be installed with `pip`:

```
pip install dask-bigquery
```

## Example

`dask-bigquery` assumes that you are already authenticated. 

```python
import dask_bigquery

ddf = dask_bigquery.read_gbq(
    project_id="your_project_id",
    dataset_id="your_dataset",
    table_id="your_table",
)

ddf.head()
```

## Run tests locally

To run the tests locally you need to be authenticated and have a project created on that account. If you're using a service account, when created you need to select the role of "BigQuery Admin" in the section "Grant this service account access to project". 

You can run the tests with

`$ pytest dask_bigquery`

if your default `gcloud` project is set, or manually specify the project ID with

`DASK_BIGQUERY_PROJECT_ID pytest dask_bigquery`

## History

This project stems from the discussion in
[this Dask issue](https://github.com/dask/dask/issues/3121) and
[this initial implementation](https://gist.github.com/bnaul/4819f045ccbee160b60a530b6cfc0c98#file-dask_bigquery-py)
developed by [Brett Naul](https://github.com/bnaul), [Jacob Hayes](https://github.com/JacobHayes),
and [Steven Soojin Kim](https://github.com/mikss).

## License 

[BSD-3](LICENSE)


