Download public table data to DataFrame from the sandbox

Use the BigQuery Storage API to download query results to DataFrame.

Code sample


Before trying this sample, follow the Python setup instructions in the BigQuery quickstart using client libraries. For more information, see the BigQuery Python API reference documentation.

To authenticate to BigQuery, set up Application Default Credentials. For more information, see Set up authentication for a local development environment.

from import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# `SELECT *` is an anti-pattern in BigQuery because it is cheaper and
# faster to use the BigQuery Storage API directly, but BigQuery Sandbox
# users can only use the BigQuery Storage API to download query results.
query_string = "SELECT * FROM `bigquery-public-data.usa_names.usa_1910_current`"

# Use the BigQuery Storage API to speed-up downloads of large tables.
dataframe = client.query_and_wait(query_string).to_dataframe(


What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser.