更新时间:2026-11-05 GMT+08:00
分享

Aura DataFrame SDK获取与安装

您可以通过pip命令一键安装Aura DataFrame SDK,安装过程中会自动下载SDK依赖的第三方库。本节操作介绍如何获取并安装SDK的操作指导。

前提条件

已安装Python 3.11环境。具体操作,请参见Python环境配置。

获取SDK

下载SDK文件,并建议您同时下载.sha256文件,该文件可用于验证SDK包的完整性。验证方法请参考验证SDK包的完整性。

表1 获取SDK文件说明

SDK文件

说明

下载链接

huawei_aura_connectorapi-x.x.x-py3-none-any.whl

支持通过原生API或标准数据库接口(PEP249)执行SQL查询。

huawei_aura_frame-x.x.x.x-py3-none-any.whl

基于Ibis框架,支持用类Dataframe/Dataset语法编写数据处理作业并自动转换为SQL在Aura引擎执行。

验证SDK包的完整性

下载SDK安装包时,您需要同时下载.sha256文件,用于验证SDK包的完整性。本节介绍使用.sha256文件验证SDK包的完整性的操作步骤。

  1. 查询SDK安装包的SHA - 256哈希值
    • 在Windows系统中
      1. 在开始菜单中搜索“cmd”打开命令窗口。
      2. 使用cd命令切换到保存SDK安装包的文件夹目录。

        例如:SDK安装包保存在D盘的“SDK”文件夹中,输入cd D:\SDK。

      3. 执行以下命令
        certutil -hashfile SDK安装包文件名 SHA256

        将“SDK安装包文件名”替换为实际的SDK安装包文件名,如certutil -hashfile huawei_aura_connectorapi-x.x.x-py3-none-any.whl SHA256。

      4. 命令执行后,命令提示符会输出SDK安装包的SHA - 256哈希值。
    • 在Linux系统中
      1. 使用cd命令切换到保存SDK安装包的文件夹目录。

        例如,如果SDK安装包保存在用户主目录下的“SDK”文件夹中,输入cd ~/SDK。

      2. 输入查询命令:
        sha256sum SDK安装包文件名

        将“SDK安装包文件名”替换为实际的SDK安装包文件名,如sha256sum sdk - huawei_aura_connectorapi-x.x.x-py3-none-any.whl。

      3. 命令执行后,终端会输出SDK安装包的SHA - 256哈希值。
  2. 对比哈希值
    1. 使用文本编辑器打开下载的.sha256文件。
    2. 在.sha256文件中找到SDK安装包的SHA - 256哈希值。

      通常是一个长字符串,例如“a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6xxxxxxxxxxxxxxxxxxxxxxxx”。

    3. 将步骤1查询SDK安装包的SHA - 256哈希值得到的SDK安装包的SHA - 256哈希值与.sha256文件中的哈希值进行对比。
      • 如果两个哈希值完全一致,说明SDK安装包在下载过程中没有被篡改,文件是完整的。
      • 如果哈希值不一致,这可能意味着SDK安装包在下载过程中出现了错误,或者文件被恶意修改。

        此时,建议重新下载SDK安装包和对应的.sha256文件,然后再次进行验证。

安装SDK

  1. 打开命令行窗口,进入SDK文件所在目录。
  2. 执行如下命令安装SDK,安装过程中会自动下载第三方依赖库。

    pip install huawei_aura_connectorapi-x.x.x-py3-none-any.whl
    pip install huawei_aura_frame-x.x.x.x-py3-none-any.whl

    x.x.x.x和x.x.x为具体版本号,以实际为准。

  3. 执行以下命令,查看SDK版本。

    python -c "import aura_frame; print(aura_frame.__version__)"
    回显信息类似如下所示,表示安装SDK成功。
    3.9.0.1

相关文档