superset连接hive需pyhive驱动、正确uri及kerberos认证配置；mysql连接须指定charset=utf8mb4和connect_timeout参数，避免乱码与超时。
Superset 能直接连 Hive，但必须用 PyHive 驱动 + 正确的 URL 格式 + Kerberos 认证配置；MySQL 则更简单，但字符集和驱动选错会报 UnicodeEncodeError 或连接超时。
Superset 连接 Hive 前必须确认三件事
很多连接失败不是 URL 写错了，而是底层环境没准备好：
- PyHive 已安装（
pip install PyHive），且版本兼容当前 Python（3.8+ 推荐PyHive>=0.7.0） - HiveServer2 端口（默认
10000）在 Superset 所在机器上可通（用telnet hostname 10000测试） - Kerberos 认证已生效：执行
kinit -kt /path/to/keytab user@REALM后，klist能看到有效 ticket；否则 URL 中加?auth=KERBEROS会直接报Ticket expired
URL 示例（Kerberos 场景）：hive://hive@bigdata1:10000/default?auth=KERBEROS&kerberos_service_name=hive
注意：kerberos_service_name 必须和 krb5.conf 中 [realms] 下定义的服务名一致，不是主机名。
MySQL 连接 URL 的两个关键参数不能漏
Superset 默认用 pymysql 驱动，但不显式声明字符集或连接参数时，中文字段可能乱码、长文本截断、甚至初始化元数据库失败：
- 必须加
?charset=utf8mb4（不是utf8），否则 emoji 和四字节 UTF-8 字符写入失败 - 建议加
&connect_timeout=30，避免网络抖动导致后台任务卡死 - 完整 URL 示例：
mysql+pymysql://superset_user:password@10.108.231.232:3306/superset_meta?charset=utf8mb4&connect_timeout=30
如果用 mysqlclient 驱动（C extension），需额外装 mysql-devel 和 gcc，生产环境性能略好，但调试难度高 —— 新手优先用 pymysql。
连接测试失败时先查这三处日志
Superset Web 界面只显示 “Connection failed”，真正原因藏在服务端日志里：
- 启动 Superset 时加
--debug参数（superset runserver --debug -p 8088），错误会直接打到终端 - 检查
superset db upgrade是否成功：若报ImportError: cannot import name 'soft_unicode' from 'markupsafe'，说明markupsafe版本太高，降级到markupsafe==2.0.1 - Hive 连接失败若含
SASL(-1): generic failure，90% 是 Kerberos ticket 过期或sasl_client.setAttr('host', ...)传了错误 host —— 某些集群要求固定填HADOOP而非实际 hostname
最易被忽略的是：Superset 初始化元数据库（superset db upgrade）必须在连接外部数据库（MySQL/Hive）之前完成，且该命令依赖的数据库驱动（如 pymysql）必须和后续数据源驱动一致。混用 mysqlclient 和 pymysql 可能导致初始化成功但数据源连接失败。
