Python 成功安装 Impyla 及 Thrift SASL 补丁完整指南

沈亦白

发布时间：2026-10-13| 6人浏览过

原创

本文详细讲解在 Python 中安装 Impyla 连接 Impala 数据库的完整步骤。直接 pip install impyla 往往失败，需按顺序安装 six、bit_array、thriftpy、thrift_sasl 等依赖。重点包含 thrift_sasl 模块中 _send_message 函数的代码修改补丁，解决 Python 3 兼容性问题，确保连接稳定。

Impyla 安装前置依赖与主包安装

直接执行 pip install impyla 命令通常无法成功安装，请遵循以下具体步骤进行操作即可顺利完成安装。

按照后续列出的依赖顺序依次执行安装命令即可。

第一步，执行命令：pip install six

第二步，执行命令：pip install bit_array

第三步，执行命令：pip install thriftpy

第四步，执行命令：pip install thrift_sasl

第五步，执行命令：pip install impyla

安装验证与 Python 3 兼容性补丁

安装完成后，进行以下代码测试：

>>> from impala.dbapi import connect >>>

若执行上述导入语句未抛出异常或报错信息，即表示安装成功。

补充说明：针对 Python 3 环境安装 Impala 相关包时的特定注意事项。

需严格按照上述依赖包的顺序进行安装。


pip3 install six bit_array bitarray
pip3 install thriftpy==0.3.8 pure-sasl
pip3 install thrift-sasl==0.2.1 --no-deps
pip3 install impyla==0.14.1

随后，需要修改 thrift_sasl 模块下的 __init__.py 文件。

该文件通常位于 /usr/local/lib/python3.6/site-packages/ 目录下。

请定位并修改该文件中第 94 行附近的 _send_message 函数。


def _send_message(self, status, body):
 header = struct.pack(">BI",status, len(body))
 if (type(body) is str): # add
  body = body.encode() # add
 self._trans.write(header + body)
 self._trans.flush()

以上即为 Python 安装 Impyla 包的完整步骤与补丁说明，供参考使用。