Skip to main content

Python idiomatic client for Google BigQuery

Quick Start

$ pip install --upgrade google-cloud-bigquery

Authentication

With google-cloud-python we try to make authentication as painless as possible. Check out the Authentication section in our documentation to learn more. You may also find the authentication document shared by all the google-cloud-* libraries to be helpful.

Using the API

Querying massive datasets can be time consuming and expensive without the right hardware and infrastructure. Google BigQuery (BigQuery API docs) solves this problem by enabling super-fast, SQL-like queries against append-only tables, using the processing power of Google’s infrastructure.

Load data from CSV

import csv

from google.cloud import bigquery
from google.cloud.bigquery import SchemaField

client = bigquery.Client()

dataset = client.dataset('dataset_name')
dataset.create()  # API request

SCHEMA = [
    SchemaField('full_name', 'STRING', mode='required'),
    SchemaField('age', 'INTEGER', mode='required'),
]
table = dataset.table('table_name', SCHEMA)
table.create()

with open('csv_file', 'rb') as readable:
    table.upload_from_file(
        readable, source_format='CSV', skip_leading_rows=1)

Perform a synchronous query

# Perform a synchronous query.
QUERY = (
    'SELECT name FROM [bigquery-public-data:usa_names.usa_1910_2013] '
    'WHERE state = "TX"')
query = client.run_sync_query('%s LIMIT 100' % QUERY)
query.timeout_ms = TIMEOUT_MS
query.run()

for row in query.rows:
    print(row)

See the google-cloud-python API BigQuery documentation to learn how to connect to BigQuery using this Client Library.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

google-cloud-bigquery-0.20.0.tar.gz (50.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

google_cloud_bigquery-0.20.0-py2.py3-none-any.whl (68.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file google-cloud-bigquery-0.20.0.tar.gz.

File metadata

File hashes

Hashes for google-cloud-bigquery-0.20.0.tar.gz
Algorithm Hash digest
SHA256 7941b632c7850104df65833e165b7ca4f6bce4fba5f2202e657b3f5148e73d72
MD5 0cacc02e000e6505bf45cacaa85878b6
BLAKE2b-256 ba597b4587b4098aa58b74ee7e2ff19d252f9862516bbe6d79227586365e967f

See more details on using hashes here.

File details

Details for the file google_cloud_bigquery-0.20.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for google_cloud_bigquery-0.20.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 a7c06a317ab592cd3956da46debc762cfc5b82dde5dbeb4f83455dfdcc93b571
MD5 0ae4672b4fd6e4c473edf3f55a762ea2
BLAKE2b-256 36e55582b8accfc5bbc191db79c7351946a45e0750afaa0efe7279751624feb0

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page