客户端版本和支持策略

Snowflake 提供 CLI（命令行界面），以及其他客户端软件（驱动程序、连接器等），用于连接 Snowflake 并使用某些 Snowflake 功能（例如用于加载数据的 Apache Kafka，以及用于外部表的 Apache Hive 元数据）。客户端必须安装在要连接的每个本地工作站或系统上。

如果需要，我们会发布新版本的客户端以修复错误，并推出增强功能和新功能。新版本向后兼容现有 Snowflake 功能，但我们不保证向前兼容早期版本。因此，我们建议您积极监控和维护已安装客户端的版本；如果它们与当前版本的 Snowflake 不同步，则在连接和使用 Snowflake 时可能会遇到问题。

注意

对于关键或重要的客户端更改（尤其是所需的安全更新），Snowflake 可能会要求您升级到最新版本。请务必查看您正在使用的客户端驱动程序的 版本说明，以查看特定版本中是否有重要的安全补丁，并相应地计划驱动程序升级。

有关确定客户端或驱动程序当前版本的更多信息，请参阅以下内容：

本页面上的所有下载均被视为您使用 Snowflake 服务的协议中定义的“客户端软件”。

注意

由于 Google 即将对签名请求标头和有效负载进行变更，因此使用 GCP (Google Cloud Platform) 进行身份验证的客户必须将其客户端和驱动程序更新到新的最低版本。Snowflake 建议受影响的客户阅读 FAQ：2023 年 GCP 客户驱动程序弃用 (https://community.snowflake.com/s/article/faq-2023-client-driver-deprecation-for-GCP-customers) 知识库文章，了解更多信息。

最低客户端版本

客户端的最低版本标识了支持的 最早 版本的客户端。任何低于规定的最低版本的客户端版本都不再受我们的支持策略（见下文）的保护，并且在连接到 Snowflake 时可能会遇到问题。

注意

如 客户端支持策略 所述，Snowflake 仅修复最新客户端版本的问题。因此，最低版本可能包含已在更高版本中修复的问题。因此，不 建议您安装最低版本。

上表中记录的版本仅作为管理与支持策略相关的已安装客户端的指南。

客户端支持策略

Snowflake 为 Snowflake 提供的所有客户端维护以下支持策略：

  • 对于本页列出的所有客户端，Snowflake 通常为每个客户端版本提供至少两年的正式支持，除非更新的版本推出了关键修复（例如针对安全或性能问题的修复）。

    低于最低支持版本的客户端版本可能会被阻止连接到 Snowflake。请注意，Snowflake 将在阻止访问特定客户端版本之前提前发送通知。

  • 不支持的版本可能会从发行版中移除（即这些版本可能不再可供下载/安装）。

  • Snowflake 仅在 最新 客户端版本上提供错误修复、新功能和所需的安全更新。同样，在排查客户端问题时，Snowflake 仅针对最新客户端版本进行验证。

  • Snowflake 确保在所有支持的客户端版本 APIs 中向后兼容。

备注

本策略不涵盖第三方合作伙伴（Informatica、Tableau 等）提供的客户端连接器；有关其支持策略的信息，请直接咨询提供连接器的合作伙伴。

有关 Snowflake 第三方合作伙伴的更多详细信息，请参阅 Snowflake 生态系统。

操作系统支持

注意

自 2026 年 4 月 1 日开始，Snowflake 计划对所有客户端停止支持以下操作系统：

  • CentOS 7

  • macOS 11、12 和 13

  • Ubuntu 16.04

此外，Snowflake 还计划针对 x86 架构的 ODBC 驱动程序，专门停止对 Ubuntu 18.04 的支持。

以下操作系统支持大多数 Snowflake 客户端的最新版本：

操作系统

支持的版本

AIX

AIX 7.2（仅限 JDBC）

Linux

CentOS 7、8

Red Hat Enterprise Linux (RHEL) 7、8，以及针对选定客户端的版本 9

Ubuntu 16.04、18.04、20.04 或更高版本

macOS

10.14 或更高版本

Microsoft Windows

Microsoft Windows 8 或更高版本

Microsoft Windows Server 2012、2016、2019、2022

备注

支持的版本号会随着时间的推移而变化，这主要取决于操作系统供应商不断演化的支持策略。

下表显示了哪些客户端在哪些操作系统上可用：

Linux

macOS

Microsoft Windows

备注

.NET 驱动程序

✔

✔

✔

从 5.4.0 版本开始支持 Red Hat Enterprise Linux (RHEL) 9。

Go Snowflake 驱动程序

✔

✔

✔

从版本 1.17.1 开始，支持 Red Hat Enterprise Linux (RHEL) 9。

引入 Java SDK

✔

✔

✔

引入 Python SDK

✔

✔

✔

Snowpipe Streaming SDK（用于高性能架构）

✔

✔

✔

支持的架构：ARM64 Mac、Windows、ARM64-Linux 和 x86_64-Linux。Linux 需要 glibc 2.26 或更高版本。

Node.js 驱动程序

✔

✔

✔

从 2.3.2 版本开始支持 Red Hat Enterprise Linux (RHEL) 9。

JDBC 驱动程序

✔

✔

✔

从版本 3.27.1 开始，支持 Red Hat Enterprise Linux (RHEL) 9。

ODBC 驱动程序

✔

✔

✔

Linux 支持基于以下架构：

  • x86：

    • Red Hat Enterprise Linux (RHEL) 7、8 和 9（从 3.14.0 版本开始）

    • CentOS 7

    • Ubuntu 版本 16.04 [4]、18.04 和 20.04 或更高版本

  • ARM64 (aarch64)

    • Red Hat Enterprise Linux (RHEL) 8 和 9（从 3.14.0 版本开始）

    • CentOS 8

    • Ubuntu 20.04

ODBC 支持 macOS 11.0 [4] 及更高版本。

ODBC 不支持 Windows 的 ARM64 架构。

对于 Linux，ODBC v3.15.0 及更高版本需要 glibc 2.28 或更高版本，因此与使用旧版 glibc 的 OS 不兼容，例如 Ubuntu 18.04 及更早版本、RHEL 7 及更早版本。在升级到 ODBC 驱动程序 v3.15.0 或更高版本之前，请参阅操作系统文档，确认其是否支持 glibc 版本 2.25 或更高版本。

PHP PDO 驱动程序

✔

✔

✔

从 3.5.0 版本开始支持 Red Hat Enterprise Linux (RHEL) 9。

Snowflake Connector for Kafka

✔

✔

✔

Snowflake Connector for Python

✔

✔

✔

从版本 4.0.0 开始，支持 Red Hat Enterprise Linux (RHEL) 9。

Snowflake Connector for Spark

✔

✔

✔

Snowflake Library for Java

✔

✔

✔

Snowflake Library for Python

✔

✔

✔

Snowflake Library for Scala

✔

✔

✔

Snowflake ML

✔

✔

✔

SnowSQL

✔

✔

✔

版本 1.3.3 及更高版本在 Linux 上至少需要 glibc 版本 2.25，该版本在较老的操作系统上可能不可用，例如 RHEL7。请参阅操作系统文档，确认其是否支持 glibc 版本 2.25 或更高版本。

操作系统支持策略

Snowflake 通常会根据操作系统供应商规定的支持时间表放弃对操作系统版本的支持。

Snowflake 通常会在取消对特定操作系统版本的支持之前提前 3 个月发出通知。