JDBC 驱动程序的 Java 要求

Snowflake JDBC 驱动程序需要 Java LTS（长期支持）版本 1.8 或更高版本。如果客户端计算机上未安装所需的最低 Java 版本，则 JDBC 驱动程序安装后，必须安装 Oracle Java 或 OpenJDK。

备注

如果您使用 JDK 1.8 u91 或更早版本，或使用自定义信任存储，请阅读 DigiCert Global Root G2 证书颁发机构 (CA) TLS 证书更新 (https://community.snowflake.com/s/article/check-impact-from-digicert-g2-certificate-update) 知识库文章，了解有关使用所需证书更新信任库的信息。

本主题内容：

Oracle Java

Oracle Java 目前支持 Java 8。

OpenJDK

OpenJDK 是 Java 的开源实现，可为各种 Linux 环境提供 JDK 8 包。非 Linux 环境或更高 Java 版本的软件包只能通过第三方获得。

客户端数据加密要求

JDBC 驱动程序使用 AES 规范来加密上传到 Snowflake 暂存区的文件（使用 PUT）并解密下载的文件（通过 GET）。该驱动程序会使用 128 位密钥自动加密暂存文件，但也支持使用 256 位密钥加密文件，以实现更高级别的 AES 加密。

要使用 256 位密钥（而不是默认的 128 位密钥）来对暂存文件进行加密，您的账户管理员必须设置 CLIENT_ENCRYPTION_KEY_SIZE 账户参数。有关设置账户参数的更多信息，请参阅 参数管理。

但是，要使用 256 位密钥加密暂存文件，JDBC 驱动程序使用的 Java 运行时环境 (JRE) 需要在安装 JDBC 驱动程序的每台计算机上安装 Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files：

  • Oracle Java 不包含策略文件；必须单独下载和安装（见下文）。

  • OpenJDK 自动包含策略文件；无需执行其他任务。

下一部分将提供有关安装 Oracle Java 策略文件的说明。

为 Oracle Java 安装 JCE Unlimited Strength Jurisdiction Policy Files

注意

每次在客户端计算机上安装新版本的 Oracle Java 时，都可能需要重新安装策略文件，如下所述。

要安装 Oracle Java 的策略文件，请执行以下操作：

  1. 下载适合您的 Oracle Java 版本的策略文件。

  2. 安装文件。根据您的环境，您可通过以下方式安装文件：

    • 如果已安装 Snowflake JDBC 驱动程序的 2.4.26 版本（或更高版本），则可以连接到 Snowflake并尝试执行 PUT 或者 GET 命令。

      如果策略文件未安装或安装不正确（即 JRE 无法找到文件），系统将返回错误，其中包括 JRE 期望找到策略文件的目录。然后您可以将文件复制到错误中指定的目录。

      要获取驱动程序的最新版本，请从 Maven Central Repository 下载。有关更多信息，请参阅 下载/集成 JDBC 驱动程序。

    • 如果客户端计算机上安装的是单一版本的 Java，请按照策略文件随附的 README.txt 文件中的说明，将两个 .jar 文件放入 Java 安装的 jre/lib/security 子目录中。

      例如，在安装了 Java 8 的 macOS 上，目录应为：

      /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/jre/lib/security

    • 如果安装了多个版本的 Java，JDBC 驱动程序会自动查找要使用的 Java 安装；不过，我们建议使用 JAVA_HOME 明确指定在环境中要使用的版本：

      • 如果设置了 JAVA_HOME，请将 .jar 文件放到 JAVA_HOME 中引用的 Java 安装的 jre/lib/security 目录中。

      • 如果未设置 JAVA_HOME，我们建议将 .jar 文件放到每个已安装 JRE 的 lib/security 目录中。

  3. 安装文件后，您可能需要退出客户端并重新登录。

语言: 中文