Bokeh Server DataTable无法渲染经Pandas转换的Oracle SQL结果

我之前也碰到过类似的情况——用透视后的DataFrame做Bokeh表格，结果加载出来空表格，原始数据却能正常显示。结合你的场景，给你几个排查和解决的方向：

1. 先检查透视后DataFrame的结构 #

Bokeh的ColumnDataSource对数据格式挺挑剔的，透视操作很容易踩坑：

• 如果你透视后把User设成了索引，那Bokeh是认不到这个列的，得把它转成普通列：

  # 重置索引，把User从索引移回列
  pivoted_df = pivoted_df.reset_index()
  

• 要是透视产生了多级列名（比如年份和指标嵌套），ColumnDataSource也没法直接识别，得先扁平化：

  # 把多级列名拼成单个字符串，比如("2023", "Entry")变成"2023_Entry"
  pivoted_df.columns = ['_'.join(str(c) for c in col).strip() for col in pivoted_df.columns.values]
  

2. 确保ColumnDataSource转换正确 #

别直接把透视后的df丢给ColumnDataSource，最好用官方的转换方法：

from bokeh.models import ColumnDataSource

# 用from_df方法确保格式兼容
source = ColumnDataSource.from_df(pivoted_df)
# 或者先重置索引再传
source = ColumnDataSource(pivoted_df.reset_index())

3. 滑块回调的坑要注意 #

如果是滑块交互导致的空数据，大概率是回调逻辑有问题：

• 回调里更新数据源时，要完整替换source.data，不能只改部分字段：

  def update_table(attr, old, new):
      # 根据滑块值过滤数据，这里假设滑块是筛选YEARLY_TOTAL的范围
      filtered = pivoted_df[pivoted_df['YEARLY_TOTAL'] >= new]
      # 用from_df重新生成数据源数据，确保格式正确
      source.data = ColumnDataSource.from_df(filtered)
  
  # 绑定滑块的value变化事件
  slider.on_change('value', update_table)
  

• 另外要确认回调函数在Bokeh Server中是正确注册的，比如有没有用对应装饰器（如果是函数式写法的话）。

4. 表格列定义要和数据源匹配 #

你定义TableColumn的时候，field参数必须和source里的列名完全一致，大小写、下划线都不能错：

from bokeh.models import DataTable, TableColumn

# 动态生成列，避免手动写列名出错
columns = [TableColumn(field=col, title=col.replace('_', ' ')) for col in pivoted_df.columns]
data_table = DataTable(source=source, columns=columns, width=800, height=500)

最后给个调试小技巧 #

打开Bokeh Server的终端窗口，看看有没有报错信息——很多时候空表格都是因为隐性错误，比如列名不存在、数据类型不兼容（比如YEARLY_TOTAL是字符串类型）。另外可以先去掉滑块，直接渲染透视后的表格，确认数据能正常显示后再加交互逻辑，这样能快速定位问题出在数据还是交互上。

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