如何将BigQuery查询保存为本地.sql文件并上传至GitHub？

一、导出BigQuery查询到本地.sql文件 #

1. 用BigQuery网页控制台操作 #

• 打开BigQuery控制台，找到目标查询：
  • 如果是编辑器里的临时查询：全选代码，右键复制，本地新建一个后缀为.sql的文件（比如user_analytics_query.sql），粘贴代码后保存即可。
  • 如果是已保存的查询：点击查询名称进入详情页，全选里面的代码，复制后粘贴到本地.sql文件保存。

2. 用bq命令行工具操作 #

• 确保已经配置好bq工具（完成gcloud身份验证）：
  • 导出已保存的查询：

    bq show --format=prettyjson your-project-id:your-dataset-id.your-saved-query | jq -r '.query' > output_query.sql
    

    替换命令里的项目ID、数据集ID和已保存查询的名称，jq用来提取JSON中的查询内容；如果没装jq，可以直接从命令输出的JSON结果里复制query字段的内容到本地文件。
  • 直接写入自定义查询：

    echo "SELECT user_id, COUNT(*) FROM `your-project.your-dataset.user_logs` GROUP BY user_id" > user_count_query.sql
    

二、把.sql文件上传到GitHub #

1. 准备仓库 #

• 打开GitHub，新建一个仓库（比如bigquery-sql-collections），或者用已有的仓库。

2. 用Git命令行推送 #

• 打开终端，进入.sql文件所在的本地目录：
  • 初始化Git（如果这个目录还没关联Git）：

    git init
    

  • 添加文件到暂存区：

    git add your-query-file.sql
    

  • 提交更改：

    git commit -m "Add user analytics query file"
    

  • 关联远程仓库（替换为你的仓库HTTPS/SSH地址）：

    git remote add origin https://github.com/your-username/your-repo-name.git
    

  • 推送到GitHub：

    git push -u origin main
    

3. 用GitHub网页上传（不用命令行） #

• 打开你的GitHub仓库页面，点击「Add file」→「Upload files」；
• 把本地的.sql文件拖到上传区域，或者点击「choose your files」选择文件；
• 填写提交信息（比如Add user count query），点击「Commit changes」就完成上传了。

内容的提问来源于stack exchange，提问作者Kai Xiong