客户端版本和支持策略¶
Snowflake提供 CLI (命令行界面)以及其他客户端软件(驱动程序、连接器等),用于连接 Snowflake 和使用某些 Snowflake 功能(例如用于加载数据的 Apache Kafka、外部表的 Apache Hive 元数据)。客户端必须安装在要连接的每个本地工作站或系统上。
如果需要,我们会发布新版本的客户端以修复错误,并推出增强功能和新功能。新版本向后兼容现有 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 不承诺提供支持。
安装客户端后,您无需在每次发布新版本时都进行升级;但是,为了及时采用最新的修复、更新和功能,我们建议您监控新版本并定期升级(例如每月、每季度、每半年)。
类型 |
客户端 |
推荐版本 |
最低支持版本(截至 May 01, 2024)[1]_ [2] |
终止支持版本(截至 Aug 01, 2024) |
发行信息 |
在哪里下载安装程序 |
---|---|---|---|---|---|---|
CLI (命令行界面) |
1.3.0 (或更高版本) |
1.2.21 |
1.2.23 |
SnowSQL 下载 (https://developers.snowflake.com/snowsql/) 页面 |
||
连接器和驱动程序 |
3.1.0 (或更高版本) |
2.0.11 |
2.0.15 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
||
1.10.0 (或更高版本) |
1.6.9 |
1.6.12 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
3.16.0 (或更高版本) |
3.13.18 |
3.13.21 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
1.10.1 (或更高版本) |
1.6.9 |
1.6.12 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
3.3.1 (或更高版本) |
2.24.7 |
2.25.3 |
ODBC 下载 (https://developers.snowflake.com/odbc/) 页面 |
|||
2.0.3 (或更高版本) |
1.2.1 |
1.2.3 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
2.2.2 (或更高版本) |
1.6.6 |
1.8.0 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
3.10.0 (或更高版本) |
2.7.7 |
2.7.11 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
2.15.0 (或更高版本) |
2.10.0 |
2.10.0 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
1.5.3 (或更高版本) |
1.3.4 |
1.4.0 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
Snowpark |
1.12.1 (或更高版本) |
1.0.0 |
N/A |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
||
1.16.0 (或更高版本) |
1.0.0 |
N/A |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
1.12.1 (或更高版本) |
1.0.0 |
N/A |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
1.5.0 (或更高版本) |
1.1.1 |
1.5.0 |
驱动程序和库 (https://developers.snowflake.com/drivers-and-libraries/) 页面 |
|||
其他 |
最新版本 |
无(预览版) |
无(预览版) |
版本说明 (https://github.com/snowflakedb/snowflake-hive-metastore-connector/releases) (在 GitHub 中) |
小技巧
您还可以使用 SYSTEM$CLIENT_VERSION_INFO 系统函数,以编程方式检索该信息。
最低客户端版本¶
客户端的最低版本标识了支持的 最早 版本的客户端。任何低于规定的最低版本的客户端版本都不再受我们的支持策略(见下文)的保护,并且在连接到 Snowflake 时可能会遇到问题。
注意
如 客户端支持策略 所述,Snowflake 仅修复最新客户端版本的问题。因此,最低版本可能包含已在更高版本中修复的问题。因此,不 建议您安装最低版本。
上表中记录的版本仅作为管理与支持策略相关的已安装客户端的指南。
客户端支持策略¶
Snowflake 为 Snowflake 提供的所有客户端维护以下支持策略:
对于本页列出的所有客户端,Snowflake 通常为每个客户端版本提供至少两年的正式支持,除非更新的版本推出了关键修复(例如针对安全或性能问题的修复)。
低于最低支持版本的客户端版本可能会被阻止连接到 Snowflake。请注意,Snowflake 将在阻止访问特定客户端版本之前提前发送通知。
不支持的版本可能会从发行版中移除(即这些版本可能不再可供下载/安装)。
Snowflake 仅在 最新 客户端版本上提供错误修复、新功能和所需的安全更新。同样,在排查客户端问题时,Snowflake 仅针对最新客户端版本进行验证。
Snowflake 确保在所有支持的客户端版本 APIs 中向后兼容。
对于关键/重要的客户端变更(例如必要的安全更新),Snowflake 可能要求您升级到最新版本,或者至少升级到高于最低版本的版本(请参阅本主题中的表)。
备注
本策略不涵盖第三方合作伙伴(Informatica、Tableau 等)提供的客户端连接器;有关其支持策略的信息,请直接咨询提供连接器的合作伙伴。
有关 Snowflake 第三方合作伙伴的更多详细信息,请参阅 Snowflake 生态系统。
操作系统支持¶
以下操作系统支持大多数 Snowflake 客户端的最新版本:
操作系统 |
支持的版本 |
---|---|
AIX |
AIX 7.2(仅限 JDBC) |
Linux |
CentOS 7、8 |
Red Hat Enterprise Linux (RHEL) 7、8 |
|
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 |
||
---|---|---|---|---|
Go Snowflake 驱动程序 |
✔ |
✔ |
✔ |
|
.NET 驱动程序 |
✔ |
✔ |
✔ |
|
Node.js 驱动程序 |
✔ |
✔ |
✔ |
|
JDBC 驱动程序 |
✔ |
✔ |
✔ |
|
ODBC 驱动程序 |
✔ |
✔ |
✔ |
|
PHP PDO 驱动程序 |
✔ |
✔ |
✔ |
|
Snowflake Connector for Kafka |
✔ |
✔ |
✔ |
|
Snowflake Connector for Python |
✔ |
✔ |
✔ |
|
Snowflake Connector for Spark |
✔ |
✔ |
✔ |
|
Snowflake Library for Java |
✔ |
✔ |
✔ |
|
Snowflake Library for Python |
✔ |
✔ |
✔ |
|
Snowflake Library for Scala |
✔ |
✔ |
✔ |
|
Snowflake ML |
✔ |
✔ |
✔ |
操作系统支持策略¶
Snowflake 通常会根据操作系统供应商规定的支持时间表放弃对操作系统版本的支持。
Snowflake 通常会在取消对特定操作系统版本的支持之前提前 3 个月发出通知。