Send feedback
Stay organized with collections
Save and categorize content based on your preferences.
Version latestkeyboard_arrow_down
IPython Magics for BigQuery
To use these magics, you must first register them. Run the %load_ext
magic
in a Jupyter notebook cell.
%load_ext bigquery_magics
This makes the %%bigquery
magic available.
Code Samples
Running a query:
%%bigquery
SELECT name, SUM(number) as count
FROM `bigquery-public-data.usa_names.usa_1910_current`
GROUP BY name
ORDER BY count DESC
LIMIT 3
Running a parameterized query:
%%bigquery --params {"corpus_name": "hamlet", "limit": 10}
SELECT word, SUM(word_count) as count
FROM `bigquery-public-data.samples.shakespeare`
WHERE corpus = @corpus_name
GROUP BY word
ORDER BY count DESC
LIMIT @limit
BigQuery Magics Reference
Send feedback
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.
Last updated 2025-08-20 UTC.
Need to tell us more?
[[["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"]],["Last updated 2025-08-20 UTC."],[],[],null,["Version latestkeyboard_arrow_down\n\n- [3.36.0 (latest)](/python/docs/reference/bigquery/latest/magics)\n- [3.35.1](/python/docs/reference/bigquery/3.35.1/magics)\n- [3.34.0](/python/docs/reference/bigquery/3.34.0/magics)\n- [3.33.0](/python/docs/reference/bigquery/3.33.0/magics)\n- [3.31.0](/python/docs/reference/bigquery/3.31.0/magics)\n- [3.30.0](/python/docs/reference/bigquery/3.30.0/magics)\n- [3.29.0](/python/docs/reference/bigquery/3.29.0/magics)\n- [3.27.0](/python/docs/reference/bigquery/3.27.0/magics)\n- [3.26.0](/python/docs/reference/bigquery/3.26.0/magics)\n- [3.25.0](/python/docs/reference/bigquery/3.25.0/magics)\n- [3.24.0](/python/docs/reference/bigquery/3.24.0/magics)\n- [3.23.1](/python/docs/reference/bigquery/3.23.1/magics)\n- [3.22.0](/python/docs/reference/bigquery/3.22.0/magics)\n- [3.21.0](/python/docs/reference/bigquery/3.21.0/magics)\n- [3.20.1](/python/docs/reference/bigquery/3.20.1/magics)\n- [3.19.0](/python/docs/reference/bigquery/3.19.0/magics)\n- [3.18.0](/python/docs/reference/bigquery/3.18.0/magics)\n- [3.17.2](/python/docs/reference/bigquery/3.17.2/magics)\n- [3.16.0](/python/docs/reference/bigquery/3.16.0/magics)\n- [3.15.0](/python/docs/reference/bigquery/3.15.0/magics)\n- [3.14.1](/python/docs/reference/bigquery/3.14.1/magics)\n- [3.13.0](/python/docs/reference/bigquery/3.13.0/magics)\n- [3.12.0](/python/docs/reference/bigquery/3.12.0/magics)\n- [3.11.4](/python/docs/reference/bigquery/3.11.4/magics)\n- [3.4.0](/python/docs/reference/bigquery/3.4.0/magics)\n- [3.3.6](/python/docs/reference/bigquery/3.3.6/magics)\n- [3.2.0](/python/docs/reference/bigquery/3.2.0/magics)\n- [3.1.0](/python/docs/reference/bigquery/3.1.0/magics)\n- [3.0.1](/python/docs/reference/bigquery/3.0.1/magics)\n- [2.34.4](/python/docs/reference/bigquery/2.34.4/magics)\n- [2.33.0](/python/docs/reference/bigquery/2.33.0/magics)\n- [2.32.0](/python/docs/reference/bigquery/2.32.0/magics)\n- [2.31.0](/python/docs/reference/bigquery/2.31.0/magics)\n- [2.30.1](/python/docs/reference/bigquery/2.30.1/magics)\n- [2.29.0](/python/docs/reference/bigquery/2.29.0/magics)\n- [2.28.1](/python/docs/reference/bigquery/2.28.1/magics)\n- [2.27.1](/python/docs/reference/bigquery/2.27.1/magics)\n- [2.26.0](/python/docs/reference/bigquery/2.26.0/magics)\n- [2.25.2](/python/docs/reference/bigquery/2.25.2/magics)\n- [2.24.1](/python/docs/reference/bigquery/2.24.1/magics)\n- [2.23.3](/python/docs/reference/bigquery/2.23.3/magics)\n- [2.22.1](/python/docs/reference/bigquery/2.22.1/magics)\n- [2.21.0](/python/docs/reference/bigquery/2.21.0/magics)\n- [2.20.0](/python/docs/reference/bigquery/2.20.0/magics)\n- [2.19.0](/python/docs/reference/bigquery/2.19.0/magics)\n- [2.18.0](/python/docs/reference/bigquery/2.18.0/magics)\n- [2.17.0](/python/docs/reference/bigquery/2.17.0/magics)\n- [2.16.1](/python/docs/reference/bigquery/2.16.1/magics)\n- [2.15.0](/python/docs/reference/bigquery/2.15.0/magics)\n- [2.14.0](/python/docs/reference/bigquery/2.14.0/magics)\n- [2.13.1](/python/docs/reference/bigquery/2.13.1/magics)\n- [2.12.0](/python/docs/reference/bigquery/2.12.0/magics)\n- [2.11.0](/python/docs/reference/bigquery/2.11.0/magics)\n- [2.10.0](/python/docs/reference/bigquery/2.10.0/magics)\n- [2.9.0](/python/docs/reference/bigquery/2.9.0/magics)\n- [2.8.0](/python/docs/reference/bigquery/2.8.0/magics)\n- [2.7.0](/python/docs/reference/bigquery/2.7.0/magics)\n- [2.6.2](/python/docs/reference/bigquery/2.6.2/magics)\n- [2.5.0](/python/docs/reference/bigquery/2.5.0/magics)\n- [2.4.0](/python/docs/reference/bigquery/2.4.0/magics)\n- [2.3.1](/python/docs/reference/bigquery/2.3.1/magics)\n- [2.2.0](/python/docs/reference/bigquery/2.2.0/magics)\n- [2.1.0](/python/docs/reference/bigquery/2.1.0/magics)\n- [2.0.0](/python/docs/reference/bigquery/2.0.0/magics)\n- [1.28.2](/python/docs/reference/bigquery/1.28.2/magics)\n- [1.27.2](/python/docs/reference/bigquery/1.27.2/magics)\n- [1.26.1](/python/docs/reference/bigquery/1.26.1/magics)\n- [1.25.0](/python/docs/reference/bigquery/1.25.0/magics)\n- [1.24.0](/python/docs/reference/bigquery/1.24.0/magics)\n- [1.23.1](/python/docs/reference/bigquery/1.23.1/magics)\n- [1.22.0](/python/docs/reference/bigquery/1.22.0/magics)\n- [1.21.0](/python/docs/reference/bigquery/1.21.0/magics)\n- [1.20.0](/python/docs/reference/bigquery/1.20.0/magics)\n- [1.19.0](/python/docs/reference/bigquery/1.19.0/magics)\n- [1.18.0](/python/docs/reference/bigquery/1.18.0/magics)\n- [1.17.0](/python/docs/reference/bigquery/1.17.0/magics)\n- [1.16.0](/python/docs/reference/bigquery/1.16.0/magics) \n\nIPython Magics for BigQuery\n===========================\n\nTo use these magics, you must first register them. Run the `%load_ext` magic\nin a Jupyter notebook cell. \n\n %load_ext bigquery_magics\n\nThis makes the `%%bigquery` magic available.\n\nCode Samples\n------------\n\nRunning a query: \n\n %%bigquery\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 3\n\nRunning a parameterized query: \n\n %%bigquery --params {\"corpus_name\": \"hamlet\", \"limit\": 10}\n SELECT word, SUM(word_count) as count\n FROM `bigquery-public-data.samples.shakespeare`\n WHERE corpus = @corpus_name\n GROUP BY word\n ORDER BY count DESC\n LIMIT @limit\n\nBigQuery Magics Reference\n-------------------------\n\n- [BigQuery Magics Documentation](https://googleapis.dev/python/bigquery-magics/latest)"]]