Java-Anforderungen an den JDBC-Treiber

Der Snowflake-JDBC-Treiber benötigt Java LTS (Long-Term Support), Version 1.8 oder höher. Wenn die minimal erforderliche Version von Java nicht auf den Clientcomputern installiert ist, auf denen auch der JDBC-Treiber installiert ist, müssen Sie entweder Oracle Java oder OpenJDK installieren.

Bemerkung

Wenn Sie das JDK 1.8 u91 oder früher verwenden, oder wenn Sie einen kundenspezifischen Truststore verwenden, sollten Sie vorher den Knowledge Base-Artikel DigiCert Global Root G2 certificate authority (CA) TLS certificate updates mit Informationen zur Aktualisierung des Truststore mit dem erforderlichen Zertifikat lesen.

Unter diesem Thema:

Oracle Java

Oracle Java unterstützt derzeit Java 8. Anweisungen zum Herunterladen und zur Installation finden Sie unter:

OpenJDK

OpenJDK ist eine Open-Source-Implementierung von Java, die JDK 8-Pakete für verschiedene Linux-Umgebungen bereitstellt. Pakete für Nicht-Linux-Umgebungen oder höhere Java-Versionen sind nur über Drittanbieter erhältlich. Weitere Informationen dazu finden Sie unter

Anforderungen an die clientseitige Datenverschlüsselung

Der JDBC-Treiber verwendet die AES-Spezifikation, um Dateien zu verschlüsseln, die in Snowflake-Stagingbereiche hochgeladen wurden (mit PUT), und um Dateien zu entschlüsseln, die heruntergeladen wurden (mit Hilfe von GET). Der Treiber verschlüsselt Stagingdateien automatisch mit 128-Bit-Schlüsseln, unterstützt aber auch die Verschlüsselung von Dateien mit 256-Bit-Schlüsseln für eine höhere Stufe der AES-Verschlüsselung.

Um 256-Bit-Schlüssel anstelle der standardmäßigen 128-Bit-Schlüssel für die Verschlüsselung von bereitgestellten Dateien zu verwenden, muss Ihr Kontoadministrator den Kontoparameter CLIENT_ENCRYPTION_KEY_SIZE einstellen. Weitere Informationen zum Einrichten der Parameter für Ihr Konto finden Sie unter Parameterverwaltung

Um jedoch Stagingdateien mit 256-Bit-Schlüsseln zu verschlüsseln, benötigt die vom JDBC-Treiber verwendete Java Runtime Environment (JRE) die Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files auf jedem Computer, auf dem der JDBC-Treiber installiert ist:

  • Oracle Java enthält keine Richtliniendateien. Diese müssen separat heruntergeladen und installiert werden (siehe unten).

  • OpenJDK fügt die Richtliniendateien automatisch ein, sodass keine zusätzlichen Aufgaben erforderlich sind.

Im nächsten Abschnitt finden Sie Anweisungen zur Installation der Richtliniendateien für Oracle Java.

Installieren der JCE Unlimited Strength Jurisdiction Policy Files für Oracle Java

Achtung

Jedes Mal, wenn Sie eine neue Version von Oracle Java auf Ihrem Clientcomputer installieren, müssen Sie die Richtliniendateien möglicherweise wie unten beschrieben neu installieren.

So installieren Sie die Richtliniendateien für Oracle Java:

  1. Laden Sie die Richtliniendateien für Ihre Oracle Java-Version herunter:

    Die ZIP-Datei enthält eine README.txt-Datei und zwei .jar-Dateien.

  2. Installieren Sie die Dateien. Je nach Umgebung gibt es drei Möglichkeiten, die Dateien zu installieren:

    • Wenn Version 2.4.26 (oder höher) des Snowflake JDBC-Treibers installiert ist, können Sie sich mit Snowflake verbinden und versuchen, einen PUT- oder GET-Befehl auszuführen.

      Wenn die Richtliniendateien nicht oder nicht korrekt installiert sind (d. h. die JRE kann die Dateien nicht finden), gibt das System einen Fehler zurück, einschließlich der Angabe des Verzeichnisses, in dem die JRE die Richtliniendateien erwartet hat. Sie können die Dateien dann in das im Fehler angegebene Verzeichnis kopieren.

      Um die neueste Version des Treibers zu erhalten, laden Sie diese aus dem Maven Central Repository herunter. Weitere Informationen dazu finden Sie unter Herunterladen und Integrieren des JDBC-Treibers.

    • Wenn auf Ihrem Clientcomputer eine Einzelversion von Java installiert ist, speichern Sie die beiden .jar-Dateien im Unterverzeichnis jre/lib/security Ihrer Java-Installation, wie in der README.txt-Datei (in Richtliniendateien enthalten) beschrieben.

      Unter macOS mit installiertem Java 8 wäre das Verzeichnis beispielsweise:

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

    • Wenn mehrere Versionen von Java installiert sind, sucht der JDBC-Treiber automatisch nach einer zu verwendenden Java-Installation. Wir empfehlen jedoch die Verwendung von JAVA_HOME, um explizit die Version anzugeben, die in Ihrer Umgebung verwendet werden soll:

      • Wenn JAVA_HOME gesetzt ist, speichern Sie die .jar-Dateien in das Verzeichnis jre/lib/security der in JAVA_HOME angegebenen Java-Installation.

      • Wenn JAVA_HOME nicht gesetzt ist, empfehlen wir, die .jar-Dateien in das Verzeichnis lib/security jeder installierten JRE zu speichern.

  3. Nach der Installation der Dateien müssen Sie sich möglicherweise von Ihrem Client ab- und wieder anmelden.