Delta Live Tables中Change Data Feed无法正常工作的问题

以下是几个常见原因及对应解决方法：

• 开启CDF前的历史变更不被捕获
  Delta的Change Data Feed仅会记录开启属性之后发生的数据变更，开启前的INSERT/UPDATE/DELETE操作不会生成变更日志。如果是查询开启前的变更，必然会提示“没有变更”。
  验证方式：开启CDF后，执行一次数据修改（比如INSERT INTO your_table VALUES (...)或UPDATE your_table SET col = val WHERE ...），再用CDF查询语句查看。

• 查询语法或参数错误
  确保使用正确的CDF查询语法：

  • 基于版本范围：SELECT * FROM table_changes('your_table', start_version, end_version)
  • 基于时间范围：SELECT * FROM table_changes('your_table', timestamp('2024-01-01 00:00:00'), timestamp('2024-01-02 00:00:00'))
    注意：如果仅传入单个版本号，默认查询该版本到最新版本的变更；若该版本之后无任何数据操作，也会显示无变更。

• 开启CDF后无新数据变更
  用DESCRIBE HISTORY your_table查看表版本历史，确认开启CDF的版本（比如版本N）之后是否有新的版本（N+1及以上）。如果开启CDF后未执行任何数据修改操作，表版本停留在开启CDF的版本，自然没有变更数据。

• CDF属性未真正生效
  执行DESCRIBE EXTENDED your_table，在输出中查找delta.enableChangeDataFeed字段，确认值为true。如果显示false，说明之前的ALTER TABLE命令可能执行失败，重新执行ALTER TABLE your_table SET delta.enableChangeDataFeed = true并检查执行日志是否有报错。

• 存储目录权限问题
  CDF的变更日志存在表路径下的_change_data子目录中，如果当前用户没有该目录的读取权限，会导致无法读取变更数据，进而提示无变更。检查表存储路径的权限配置，确保用户能访问_change_data目录。

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