Exigences Java pour le pilote JDBC

Le pilote JDBC de Snowflake nécessite Java 1.8 ou supérieur. Si la version minimale requise de Java n’est pas installée sur les machines client sur lesquelles le pilote JDBC est installé, vous devez installer soit Oracle Java soit OpenJDK.

Dans ce chapitre :

Oracle Java

Oracle Java prend actuellement en charge Java 8. Pour les instructions de téléchargement et d’installation, cliquez sur le lien suivant :

OpenJDK

OpenJDK est une implémentation libre de Java qui fournit 8 packs JDK pour divers environnements Linux. Les packs pour les environnements hors Linux ou les versions Java supérieures ne sont disponibles que par l’intermédiaire de tiers. Pour plus d’informations, consultez le lien suivant :

Exigences en matière de chiffrement des données côté client

Le pilote JDBC utilise la spécification AES pour chiffrer les fichiers téléchargés vers les zones de préparation Snowflake (en utilisant PUT) et pour déchiffrer les fichiers téléchargés (via GET). Le pilote chiffre automatiquement les fichiers préparés à l’aide de clés de 128 bits, mais prend également en charge le chiffrement des fichiers à l’aide de clés de 256 bits pour un niveau de chiffrement AES supérieur.

Pour utiliser des clés 256 bits à la place des clés 128 bits par défaut pour chiffrer des fichiers préparés, votre administrateur doit définir le paramètre de compte CLIENT_ENCRYPTION_KEY_SIZE. Pour plus d’informations sur le paramétrage de votre compte, voir Gestion des paramètres.

Cependant, pour chiffrer des fichiers préparés à l’aide de clés 256 bits, le Java Runtime Environment (JRE) utilisé par le pilote JDBC nécessite Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files sur chaque machine où le pilote JDBC est installé :

  • Oracle Java n’inclut pas les fichiers de politique, ils doivent être téléchargés et installés séparément (voir ci-dessous).

  • OpenJDK inclut automatiquement les fichiers de politique. Aucune tâche supplémentaire n’est nécessaire.

La section suivante fournit des instructions pour installer les fichiers de politique pour Oracle Java.

Installation des « Unlimited Strength Jurisdiction Policy Files » JCE pour Oracle Java.

Attention

Chaque fois que vous installez une nouvelle version d’Oracle Java sur votre machine client, vous devrez peut-être réinstaller les fichiers de politique comme décrit ci-dessous.

Pour installer les fichiers de politique pour Oracle Java :

  1. Téléchargez les fichiers de politique pour votre version d’Oracle Java :

    Le fichier zip contient un fichier README.txt et deux fichiers .jar.

  2. Installez les fichiers. Il existe 3 façons possibles d’installer les fichiers, selon votre environnement :

    • Si la version 2.4.26 (ou supérieure) du pilote Snowflake JDBC est installée, vous pouvez vous connecter à Snowflake et essayer d’exécuter une commande PUT ou GET.

      Si les fichiers de politique ne sont pas installés ou incorrectement installés (c’est-à-dire si JRE ne peut pas localiser les fichiers), le système renvoie une erreur qui inclut le répertoire où JRE s’attendait à trouver les fichiers de politique. Vous pouvez ensuite copier les fichiers dans le répertoire spécifié dans l’erreur.

      Pour obtenir la dernière version du pilote, téléchargez-la à partir du Maven Central Repository. Pour plus d’informations, voir Téléchargement/intégration du pilote JDBC.

    • Si une seule version de Java est installée sur votre machine client, placez les deux fichiers .jar dans le sous-répertoire jre/lib/security de votre installation Java, comme décrit dans le fichier README.txt inclus avec les fichiers de politique.

      Par exemple, sur macOS avec Java 8 installé, le répertoire serait le suivant :

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

    • Si plusieurs versions de Java sont installées, le pilote JDBC localisera automatiquement une installation Java à utiliser. Cependant, nous recommandons d’utiliser JAVA_HOME pour spécifier explicitement la version à utiliser dans votre environnement :

      • Si JAVA_HOME est défini, placez les fichiers .jar dans le répertoire jre/lib/security de l’installation Java référencée dans JAVA_HOME.

      • Si JAVA_HOME n’est pas défini, nous recommandons de mettre les fichiers .jar dans le répertoire lib/security pour chaque JRE installé.

  3. Après avoir installé les fichiers, vous devrez peut-être vous déconnecter de votre client et vous reconnecter.