DeltaSharing读取CDF时报表未启用，Delta Lake读取正常求助

问题背景 #

Spark 3.2.3，本地运行Delta Sharing测试服务器，Delta Lake表已启用CDF（直接读取CDF数据正常），但通过Delta Sharing读取该表CDF时，报错：

io.delta.sharing.spark.util.UnexpectedHttpStatus: HTTP request failed with status: HTTP/1.1 400 Bad Request {"errorCode":"INVALID_PARAMETER_VALUE","message":"cdf is not enabled on table PM.catalog.transactions"}

无CDF的Delta Sharing功能正常。

排查步骤 #

1. 刷新Delta Sharing服务器元数据 #

Delta Sharing服务器会缓存表元数据，即使Delta Lake端已启用CDF，服务器未同步的话仍会判定CDF未开启：

• 直接重启本地Delta Sharing服务器，强制刷新元数据
• 若使用配置文件管理共享表，检查配置文件是否需要更新（部分场景需显式声明CDF支持）

2. 验证Delta表CDF属性有效性 #

虽然直接读CDF正常，仍需确认表属性已正确写入：

spark.sql("DESCRIBE EXTENDED retail").show(truncate=False)

检查输出中是否存在delta.enableChangeDataFeed = true，同时确认启用CDF后有新的数据变更（比如追加数据操作生成的版本需在CDF启用之后）

3. 核对Delta Sharing版本兼容性 #

CDF功能对版本有要求，需确保客户端与服务器版本匹配：

• 确认Delta Sharing客户端版本与Spark 3.2.3兼容（建议使用0.6.0及以上版本）
• 本地Delta Sharing服务器版本也需支持CDF，避免版本不匹配导致功能失效

4. 确认共享表路径一致性 #

检查Delta Sharing配置文件（如delta-sharing-server.yaml）中PM.catalog.transactions对应的路径，是否与你执行CREATE TABLE/ALTER TABLE操作的s3a://BUCKET/s3folder/retail完全一致：

• 注意路径大小写、存储前缀（如s3a vs s3）差异
• 若服务器指向的是未启用CDF的其他路径，会触发该报错

5. 查看Delta Sharing服务器日志 #

本地服务器日志会记录元数据加载细节，重点排查：

• 是否无法读取表_delta_log中的CDF配置
• 是否存在权限问题导致无法获取最新表属性

6. 检查共享权限配置 #

部分场景下，即使表启用了CDF，仍需在Delta Sharing配置中显式开放CDF访问权限：

• 检查共享配置中该表的权限项，确认包含CDF读取权限

7. 重新注册共享表 #

若以上步骤无效，尝试重新注册表：

1. 从Delta Sharing配置中移除该表
2. 重启服务器
3. 重新添加该表到共享配置
4. 再次尝试读取CDF数据

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