Search Shortcut cmd + k | ctrl + k
bigquery

Integrates DuckDB with Google BigQuery, allowing direct querying and management of BigQuery datasets

Installing and Loading

INSTALL bigquery FROM community;
LOAD bigquery;

Example

-- Attach to your BigQuery Project
D ATTACH 'project=my_gcp_project' AS bq (TYPE bigquery, READ_ONLY);

-- Show all tables in all datasets in the attached BigQuery project
D SHOW ALL TABLES;
┌──────────┬──────────────────┬──────────┬──────────────┬───────────────────┬───────────┐
 database       schema         name    column_names    column_types     temporary 
 varchar       varchar        varchar   varchar[]        varchar[]       boolean  
├──────────┼──────────────────┼──────────┼──────────────┼───────────────────┼───────────┤
 bq        quacking_dataset  duck_tbl  [i, s]        [BIGINT, VARCHAR]  false     
| bq       | barking_dataset  | dog_tbl  | [i, s]       | [BIGINT, VARCHAR]  false     |
└──────────┴──────────────────┴──────────┴──────────────┴───────────────────┴───────────┘

-- Select data from a specific table in BigQuery
D SELECT * FROM bq.quacking_dataset.duck_tbl;
┌───────┬────────────────┐
   i          s        
 int32     varchar     
├───────┼────────────────┤
    12  quack 🦆       
    13  quack quack 🦆 
└───────┴────────────────┘

About bigquery

The DuckDB BigQuery Extension integrates DuckDB with Google BigQuery, allowing direct querying and management of BigQuery datasets. For detailed setup and usage instructions, visit the extension repository.

Added Functions

function_name function_type description comment example
bigquery_attach table      
bigquery_clear_cache table      
bigquery_execute table      
bigquery_scan table      

Added Settings

name description input_type scope
bq_curl_ca_bundle_path Path to the CA bundle for curl VARCHAR GLOBAL
bq_debug_show_queries DEBUG SETTING: print all queries sent to BigQuery to stdout BOOLEAN GLOBAL
bq_experimental_filter_pushdown Whether to use filter pushdown (currently experimental) BOOLEAN GLOBAL