Databricks列名含空格与连字符建表报错求助

问题根源 #

报错核心是列名包含了SQL引擎默认禁止的特殊字符（空格、连字符），即便用反引号转义，部分引擎（如Spark SQL、部分数据仓库）默认也不支持这类列名，或需额外配置才能启用。

可行解决方案 #

方案1：修改列名（最稳妥兼容） #

直接将列名中的空格、连字符替换为下划线，彻底规避特殊字符带来的兼容性问题，修改后的建表语句：

CREATE TABLE dev.base_header(
Hdr_Template_Version string,
Excel_Unstructured string, 
Hdr_LossDataExcessCurrency string)

方案2：适配引擎的转义规则 #

若必须保留原列名，需根据你使用的SQL引擎调整转义方式或配置：

• Hive/Impala：确认反引号是英文半角（`），而非中文全角（｀）；若仍报错，检查集群是否禁用了特殊字符列名的相关配置
• Spark SQL：先执行配置开启特殊字符支持，再用反引号转义：

  -- 开启特殊字符列名支持
  SET spark.sql.identifier.delim = ' ';
  -- 执行建表
  CREATE TABLE dev.base_header(
  Hdr_Template_Version string,
  `Excel - Unstructured` string, 
  Hdr_LossDataExcessCurrency string)
  

• Trino等引擎：尝试将反引号替换为双引号：

  CREATE TABLE dev.base_header(
  Hdr_Template_Version string,
  "Excel - Unstructured" string, 
  Hdr_LossDataExcessCurrency string)
  

方案3：排查输入错误 #

仔细检查反引号是否为英文半角符号，中文全角反引号会被引擎判定为无效字符，这是容易忽略的细节。

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