Download query results to DataFrame
Stay organized with collections
Save and categorize content based on your preferences.
Get query results as a Pandas 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 retrieve query results from BigQuery and convert them into a Pandas DataFrame using the Python client library.\u003c/p\u003e\n"],["\u003cp\u003eThe sample code provided showcases a SQL query that aggregates and orders data from a public BigQuery dataset, limiting the results to the top 10 entries.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to BigQuery is achieved by setting up Application Default Credentials, as detailed in the provided authentication documentation link.\u003c/p\u003e\n"],["\u003cp\u003eUsers can explore more code samples for various Google Cloud products through the Google Cloud sample browser.\u003c/p\u003e\n"]]],[],null,["# Download query results to DataFrame\n\nGet query results as a Pandas 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 # from google.cloud import bigquery\n # client = bigquery.Client()\n\n sql = \"\"\"\n SELECT name, SUM(number) as count\n FROM `bigquery-public-data.usa_names.usa_1910_current`\n GROUP BY name\n ORDER BY count DESC\n LIMIT 10\n \"\"\"\n\n df = client.query_and_wait(sql).to_dataframe()\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)."]]
