如何使用Python从Tableau Server删除闲置工作簿？

嘿，我之前刚好解决过类似的需求——用Python批量清理Tableau Server上的临时工作簿。官方的tableau-server-client（TSC）库是最佳选择，下面给你一步步讲怎么实现：

准备工作 #

首先得把基础环境搭好：

• 安装TSC库：运行 pip install tableau-server-client
• 确认权限：你的账号需要有删除目标工作簿的权限（站点管理员权限最稳妥，或者对应项目的编辑/删除权限）
• 准备认证信息：推荐用个人访问令牌（PAT），比明文密码更安全；如果用密码也可以，但不推荐生产环境用

核心实现步骤 #

1. 连接Tableau Server #

先写连接逻辑，这里用PAT做认证示例（密码认证的话可以用TSC.TableauAuth类）：

import tableau_server_client as TSC
from datetime import datetime, timedelta

# 配置你的服务器参数
SERVER_URL = "https://your-tableau-server-domain"
SITE_ID = "your-site-id"  # 默认站点填""或者"default"
PAT_NAME = "your-pat-display-name"
PAT_SECRET = "your-pat-secret-key"

# 初始化服务器对象，自动适配服务器版本
server = TSC.Server(SERVER_URL, use_server_version=True)

# 用PAT登录
with server.auth.sign_in(TSC.PersonalAccessTokenAuth(PAT_NAME, PAT_SECRET, SITE_ID)):
    # 后续操作都写在这个上下文管理器里
    pass

2. 筛选要删除的工作簿 #

接下来要把“不再使用的临时工作簿”筛选出来，你可以根据自己的规则来：

• 按名称筛选：比如临时工作簿都带temp_前缀
• 按更新时间筛选：比如超过30天没更新的
• 按项目筛选：比如都放在名为临时项目的项目下

举个结合名称和时间的筛选示例：

# 获取当前站点所有工作簿（注意：默认分页，数量多的话要处理分页）
all_workbooks, pagination_info = server.workbooks.get()

# 筛选规则：名称含temp_ 且 30天内未更新
cutoff_date = datetime.now() - timedelta(days=30)
workbooks_to_delete = [
    wb for wb in all_workbooks
    if "temp_" in wb.name.lower() and wb.updated_at < cutoff_date
]

# 打印待删除列表，先确认！
print(f"找到{len(workbooks_to_delete)}个待删除工作簿：")
for wb in workbooks_to_delete:
    print(f"- {wb.name} | 最后更新：{wb.updated_at} | ID：{wb.id}")

3. 执行删除操作 #

确认筛选列表没问题后，就可以执行删除了——注意：删除是不可逆的，一定要先确认！

for workbook in workbooks_to_delete:
    try:
        server.workbooks.delete(workbook.id)
        print(f"✅ 成功删除：{workbook.name}")
    except Exception as e:
        print(f"❌ 删除失败 {workbook.name}：{str(e)}")

重要注意事项 #

• 分页处理：如果服务器上工作簿数量超过100个（TSC默认每页返回100条），需要循环获取所有页码的数据，比如：

  all_workbooks = []
  page_num = 1
  while True:
      wb_page, pagination = server.workbooks.get(page_number=page_num)
      all_workbooks.extend(wb_page)
      if page_num >= pagination.total_pages:
          break
      page_num += 1
  

• 测试优先：先注释掉删除代码，只打印待删除列表，确保筛选逻辑完全符合你的预期，避免误删重要工作簿
• 权限排查：如果删除时报错，先检查账号权限，或者确认工作簿是否被其他用户锁定
• 回收站？：TSC目前没有直接将工作簿移到回收站的API，调用delete()就是彻底删除，所以一定要谨慎！

内容的提问来源于stack exchange，提问作者code.dev.world