TabPy 10.13.2版本遇TypeError报错及数据库连接异常求助

刚上手TabPy遇到这种问题很常见，我帮你拆解下问题根源和解决步骤：

1. 先搞定那个TypeError：%d format a number is required, not str #

这个错误几乎肯定是MySQL连接参数里的port传成字符串了。pymysql的connect()方法要求port必须是整数类型，如果你写的是port='3306'（带引号的字符串），就会触发这个格式错误。

给你一个正确的连接示例代码，直接用在TabPy的函数里：

import pymysql

def fetch_mysql_data():
    # 重点：port是整数，不要加引号！
    conn = pymysql.connect(
        host="你的数据库IP/域名",
        user="数据库用户名",
        password="数据库密码",
        database="要连接的库名",
        port=3306,  # 这里必须是整数
        charset="utf8mb4"
    )
    
    cursor = conn.cursor()
    # 先写个简单查询测试，比如取前100行
    cursor.execute("SELECT * FROM 你的表名 LIMIT 100")
    raw_results = cursor.fetchall()
    
    # 关闭连接，避免资源泄漏
    cursor.close()
    conn.close()
    
    # 转成Tableau能识别的二维列表格式（元组转列表）
    return [list(row) for row in raw_results]

把port改成整数后，那个TypeError应该就消失了。

2. 确保pymysql在TabPy的conda环境里正确加载 #

你直接把包放到site-packages的方式容易出路径问题，更稳妥的是在TabPy依赖的conda环境里直接安装：

• 先找到TabPy用的conda环境（比如你Anaconda里的tabpy环境，或者默认base环境）
• 激活环境：conda activate 你的环境名称
• 安装指定版本的pymysql：pip install pymysql==0.8.0

这样TabPy启动时能直接找到pymysql模块，不会出现找不到依赖的隐性问题。

3. 解决返回内容截断的问题 #

返回截断一般有两个原因：

• 数据量过大：Tableau对TabPy返回的结果有默认大小限制，先加LIMIT语句限制返回行数（比如上面代码里的LIMIT 100），测试能正常返回后再处理大数据量（比如分批查询或者优化SQL）
• 结果格式不兼容：Tableau要求TabPy返回的是二维数组（列表的列表），如果你的查询结果是元组的元组，必须转成列表（就像代码里的[list(row) for row in raw_results]），否则Tableau可能解析失败或者截断内容。

4. Tableau计算字段的正确配置 #

在Tableau里创建计算字段时，调用TabPy函数的格式要注意：

SCRIPT_REAL("return fetch_mysql_data();", 1)

这里的1是占位符，因为Tableau的SCRIPT类函数必须至少传入一个参数，你可以随便选一个常量字段或者维度字段就行。

测试建议 #

先在TabPy的Web测试页面（默认是http://localhost:9004/）测试你的函数，确认能正常返回数据且无报错，再去Tableau里调用，这样能快速定位是TabPy函数的问题还是Tableau配置的问题。

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