Run a query with pandas-gbq
Stay organized with collections
Save and categorize content based on your preferences.
Use the pandas-gbq package to run a simple query.
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 page demonstrates how to use the pandas-gbq package to execute a query in BigQuery.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to BigQuery requires setting up Application Default Credentials.\u003c/p\u003e\n"],["\u003cp\u003eA code sample is provided that shows how to query country names and alpha-2 codes from a public BigQuery dataset.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Cloud sample browser can be used to find code samples for other Google Cloud products.\u003c/p\u003e\n"]]],[],null,["# Run a query with pandas-gbq\n\nUse the pandas-gbq package to run a simple query.\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 import pandas_gbq\n\n # TODO: Set project_id to your Google Cloud Platform project ID.\n # project_id = \"my-project\"\n\n sql = \"\"\"\n SELECT country_name, alpha_2_code\n FROM `bigquery-public-data.utility_us.country_code_iso`\n WHERE alpha_2_code LIKE 'A%'\n \"\"\"\n df = pandas_gbq.read_gbq(sql, project_id=project_id)\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)."]]