如何通过Git CI/CD在LookML中配置常量实现分支自动切换BigQuery库

一、分支切换自动切换BigQuery数据库 #

利用Looker的项目常量+分支环境配置实现自动切换，步骤如下：

1. 在LookML模型中用常量定义数据库
   在模型文件（如model.lkml）里将数据库引用替换为常量，示例：

   constant: database_name {
     type: string
     default: "company.stg.db" # 开发分支默认使用测试库
   }
   
   # 提前配置好可访问两个库的BigQuery连接
   connection: "bigquery_shared_connection"
   include: "views/*.lkml"
   
   # 所有explore都通过常量引用数据库
   explore: users {
     view_name: users
     from: `${database_name}.users`
   }
   

2. 配置分支环境的常量值
   进入Looker项目的「设置」→「部署」→「分支环境设置」：

   • 给主（生产）分支设置database_name的常量值为company.prod.db
   • 个人协作分支保持默认值company.stg.db，或按需单独配置

切换分支时，Looker会自动加载对应分支的常量配置，实现数据源自动切换。

二、通过Git CI/CD设置LookML常量 #

以下两种方案可实现CI/CD流程中动态配置常量：

方案1：CI/CD动态修改LookML常量文件 #

1. 集中管理常量文件
   在项目中创建单独的constants.lkml，统一存放所有常量：

   constant: database_name {
     type: string
     default: "company.stg.db"
   }
   constant: query_timeout {
     type: number
     default: 30
   }
   

2. CI/CD脚本替换常量
   在GitHub Actions、GitLab CI等流水线中，根据当前分支判断并替换常量值。示例shell脚本：

   # 判断当前分支为主分支时，替换数据库为生产库
   if [ "$CI_COMMIT_BRANCH" = "main" ]; then
     sed -i 's/default: "company.stg.db"/default: "company.prod.db"/g' constants.lkml
   fi
   

   执行替换后，将修改后的文件提交或直接部署到Looker。

方案2：通过Looker API设置环境常量 #

1. 生成Looker API密钥
   在Looker用户设置中创建API密钥（需具备项目编辑权限）。

2. CI/CD中调用API修改常量
   在流水线中调用Looker API，为指定环境设置常量值。示例curl命令：

   curl -X PATCH "https://your-looker-domain/api/3.0/projects/your-project/environments/production" \
     -H "Authorization: Token token=API_KEY:API_SECRET" \
     -H "Content-Type: application/json" \
     -d '{"constants": {"database_name": "company.prod.db"}}'
   

   注意：API密钥需存入CI/CD的保密变量，避免硬编码。

注意事项 #

• 确保BigQuery连接的服务账号拥有company.prod.db和company.stg.db的访问权限
• 分支环境的常量优先级高于项目默认常量
• CI/CD流程中需严格判断分支，避免误切换生产数据源

内容的提问来源于stack exchange，提问作者Mohammad Athar