Run a legacy SQL query with pandas-gbq
Stay organized with collections
Save and categorize content based on your preferences.
Use the pandas-gbq package to run a query using legacy SQL syntax.
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\u003eThe \u003ccode\u003epandas-gbq\u003c/code\u003e package can be used to execute queries against BigQuery.\u003c/p\u003e\n"],["\u003cp\u003eThis example demonstrates running a query with legacy SQL syntax using \u003ccode\u003epandas-gbq\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eread_gbq\u003c/code\u003e function is used to execute the SQL query and retrieve the results.\u003c/p\u003e\n"],["\u003cp\u003eTo use legacy SQL syntax, set the \u003ccode\u003edialect\u003c/code\u003e parameter to \u003ccode\u003e"legacy"\u003c/code\u003e in the \u003ccode\u003eread_gbq\u003c/code\u003e function.\u003c/p\u003e\n"],["\u003cp\u003eAuthenticating with Bigquery requires setting up Application Default Credentials.\u003c/p\u003e\n"]]],[],null,["# Run a legacy SQL query with pandas-gbq\n\nUse the pandas-gbq package to run a query using legacy SQL syntax.\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 sql = \"\"\"\n SELECT country_name, alpha_2_code\n FROM [bigquery-public-data:utility_us.country_code_iso]\n WHERE alpha_2_code LIKE 'Z%'\n \"\"\"\n df = pandas_gbq.read_gbq(\n sql,\n project_id=project_id,\n # Set the dialect to \"legacy\" to use legacy SQL syntax. As of\n # pandas-gbq version 0.10.0, the default dialect is \"standard\".\n dialect=\"legacy\",\n )\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)."]]
