Download public table data to DataFrame from the sandbox
Stay organized with collections
Save and categorize content based on your preferences.
Use the BigQuery Storage API to download query results to DataFrame.
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis guide demonstrates how to use the BigQuery Storage API to download query results directly to a DataFrame in Python.\u003c/p\u003e\n"],["\u003cp\u003eThe provided Python code sample utilizes the \u003ccode\u003egoogle.cloud.bigquery\u003c/code\u003e library to execute a query and retrieve the results.\u003c/p\u003e\n"],["\u003cp\u003eThe BigQuery Storage API enables faster downloads of large tables compared to standard methods.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to BigQuery is required and can be set up using Application Default Credentials.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the provided Google Cloud sample browser to find additional code samples for Google Cloud products.\u003c/p\u003e\n"]]],[],null,["# Download public table data to DataFrame from the sandbox\n\nUse the BigQuery Storage API to download query results to DataFrame.\n\nCode sample\n-----------\n\n### Python\n\n\nBefore trying this sample, follow the Python setup instructions in the\n[BigQuery quickstart using\nclient libraries](/bigquery/docs/quickstarts/quickstart-client-libraries).\n\n\nFor more information, see the\n[BigQuery Python API\nreference documentation](/python/docs/reference/bigquery/latest).\n\n\nTo authenticate to BigQuery, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for client libraries](/bigquery/docs/authentication#client-libs).\n\n\n from google.cloud import https://cloud.google.com/python/docs/reference/bigquery/latest/\n\n # Construct a BigQuery client object.\n client = https://cloud.google.com/python/docs/reference/bigquery/latest/.https://cloud.google.com/python/docs/reference/bigquery/latest/google.cloud.bigquery.client.Client.html()\n\n # `SELECT *` is an anti-pattern in BigQuery because it is cheaper and\n # faster to use the BigQuery Storage API directly, but BigQuery Sandbox\n # users can only use the BigQuery Storage API to download query results.\n query_string = \"SELECT * FROM `bigquery-public-data.usa_names.usa_1910_current`\"\n\n # Use the BigQuery Storage API to speed-up downloads of large tables.\n dataframe = client.https://cloud.google.com/python/docs/reference/bigquery/latest/google.cloud.bigquery.client.Client.html#google_cloud_bigquery_client_Client_query_and_wait(query_string).to_dataframe(\n create_bqstorage_client=True\n )\n\n print(dataframe.info())\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=bigquery)."]]
