BigQuery执行INNER JOIN关联查询提示Unrecognized name错误

错误根因 #

报错由表名引用不规范直接触发，核心问题点如下：

• BigQuery对数据集、表、字段标识符默认大小写敏感，JOIN子句中声明的第二张表为employee_data.Department（首字母大写D），但ON关联条件中误将该表写为department（全小写d），查询引擎无法识别这个未被声明的表名，会将所有关联到错误表名的字段全部判定为无法识别的名称。
• 多表关联时未使用表别名，反复书写完整表名极易出现拼写、大小写错误，本次报错中涉及的Department.name、employees.department_id等字段识别失败，本质都是表名引用不一致导致引擎无法定位字段所属表。

修复方案 #

推荐给关联的两张表设置短别名，从根源避免表名书写错误，修正后可直接运行的SQL如下：

SELECT  
  e.name AS employees_name,
  e.role AS employees_role,
  d.name AS department_name
FROM `employee_data.employees` e
INNER JOIN `employee_data.Department` d
  ON e.department_id = d.department_id

代码说明 #

• 语句中给employee_data.employees表设置短别名e，给employee_data.Department表设置短别名d，后续字段选择、关联条件统一使用短别名引用，既精简代码量，也能避免长表名反复书写带来的拼写、大小写错误。
• INNER JOIN逻辑本身会自动保留两表中department_id完全匹配的记录，自动过滤无department_id、department_id在部门表中不存在的员工数据，无需额外添加WHERE筛选条件即可满足“获取员工及其对应部门名称列表，排除无department_id员工”的查询目标。

如果不使用别名，也可以直接修正ON子句中的表名大小写，保证全语句中Department表名的写法和表创建时的命名完全一致（首字母大写D），但这种写法冗余度高，后续查询字段增多时仍容易出现同类书写错误。

内容的提问来源于stack exchange，提问作者Olamide Olumide