安装 Snowflake Python APIs 库

您可以安装 Snowflake Python APIs 库，以便与 Conda 或虚拟环境一起使用。在开始之前，请务必查看 支持的 Python 版本。

要设置 Snowflake Python APIs 库，请完成以下步骤：

  1. 激活 Python 环境。

  2. 安装 库。

  3. 为 Python API 客户端 设置选项。

激活 Python 环境

要设置运行 Python 代码的环境，需要激活 Python 环境。例如，您可以使用 conda 或虚拟环境 (venv)。

备注

这些步骤仅作为示例显示，按照示例操作可能需要对非 Snowflake 拥有或提供的第三方数据、产品或服务具有额外权利。在继续操作前，请确保您对第三方数据、产品或服务拥有适当的权利。

您可使用 conda 创建用于运行 Python 代码的环境。如您没有 conda，可从 conda 网站安装它。

  1. 创建 conda 环境：

    conda create -n <env_name> python==3.10
    Copy

  2. 激活环境：

    conda activate <env_name>
    Copy

安装 Snowflake Python APIs 库

您可以从 Python Package Index (PyPI) 中安装 Snowflake Python APIs 库。

  • 在创建的 conda 或虚拟环境中，运行以下 pip 命令以安装库：

    pip install snowflake -U
    Copy

安装 snowflake 包会自动将其所有子包安装为依赖项，包括 Snowflake Python Connector、Snowpark Python Library 和 snowflake.core。

  • 若要同时安装 Snowpark ML Library 作为额外的包依赖项，您可以运行以下 pip 命令：

    pip install "snowflake[ml]" -U
    Copy

安装库后，须先创建与 Snowflake 的连接，然后才能使用 API。有关连接的更多信息，请参阅 使用 Snowflake Python APIs 连接到 Snowflake。

设置 Python API 客户端选项

可以设置以下环境变量来控制 Snowflake Python APIs 的客户端选项：

_SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE

指定在打印的错误消息中是否启用完整的堆栈跟踪。

可能的值如下：

  • 已启用：true、t、yes、y、on

  • 已禁用：任何其他值或未定义

默认：已禁用

禁用该选项后，API 客户端会在错误消息中打印减少的堆栈跟踪，而不是完整的堆栈跟踪。

要在 Python 笔记本环境中禁用该选项，还必须在笔记本中运行以下行。运行此行后，环境变量将自行控制堆栈跟踪行为：

%xmode minimal
Copy
_SNOWFLAKE_ENABLE_RETRY_REQUEST_QUERY

指定是否对具有特定状态码的查询请求启用自动重试。

可能的值如下：

  • 已启用：true、t、yes、y、on

  • 已禁用：任何其他值或未定义

默认：已启用

启用该选项后，API 客户端会在查询请求出现以下状态码时自动重试：

  • 202

  • 429

  • 503

  • 504

语言: 中文