如何从Tableau Server提取各报表对应的SQL查询语句？

一、通过日志文件获取 #

Tableau Server的日志里确实包含SQL查询语句，但有几个限制：

• 关键日志文件是vizqlserver.log（处理可视化查询）和dataserver.log（处理数据源连接），默认路径：
  • Windows：C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs
  • Linux：/var/opt/tableau/tableau_server/data/tabsvc/logs
• 日志中的SQL会和报表（工作簿/视图）的会话ID、视图ID关联，需要手动匹配对应关系，检索起来比较麻烦；而且日志会定期滚动清理，得确保目标查询的记录还没被删。
• 如果报表用的是自定义SQL数据源，日志里会保留原始语句；如果是拖放字段生成的可视化，日志里的是Tableau自动解析生成的查询语句。

二、通过Python调用Tableau Server REST API获取 #

这是更高效、结构化的方式，步骤如下：

准备工作 #

• 要有Tableau Server的管理员权限（至少能查看所有工作簿和数据源）
• 安装Python库：pip install tableau-server-client

核心代码示例 #

import tableauserver_client as TSC

# 连接并认证服务器
server = TSC.Server('https://你的Tableau Server地址', use_server_version=True)
auth = TSC.TableauAuth('用户名', '密码', site_id='你的站点ID')

with server.auth.sign_in(auth):
    # 获取所有工作簿
    all_workbooks, _ = server.workbooks.get()
    for workbook in all_workbooks:
        # 填充工作簿的连接信息
        server.workbooks.populate_connections(workbook)
        for conn in workbook.connections:
            # 过滤SQL类数据源（根据实际类型调整）
            sql_types = ['postgres', 'mysql', 'sqlserver', 'oracle', 'redshift']
            if conn.connection_type.lower() in sql_types:
                # 获取自定义SQL（如果存在）
                if hasattr(conn, 'custom_sql') and conn.custom_sql:
                    print(f"工作簿: {workbook.name} | 自定义SQL: {conn.custom_sql}")
                # 对于已发布的数据源，可进一步获取其元数据
                if conn.datasource_id:
                    datasource = server.datasources.get(conn.datasource_id)
                    server.datasources.populate_connections(datasource)
                    # 若数据源有自定义SQL，同样可以提取
                    for ds_conn in datasource.connections:
                        if hasattr(ds_conn, 'custom_sql') and ds_conn.custom_sql:
                            print(f"关联数据源: {datasource.name} | 自定义SQL: {ds_conn.custom_sql}")

注意点 #

• 只有自定义SQL的数据源能直接拿到原始SQL；如果是拖放生成的可视化，Tableau不会存储自动生成的查询语句，这种情况要么结合日志提取，要么通过API触发临时查询获取。
• 非SQL类数据源（如Excel、CSV）没有SQL查询，需要过滤掉这类连接。

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