Téléchargement/intégration du pilote JDBC¶

Exigences¶

Pour obtenir la liste des systèmes d’exploitation pris en charge par les clients Snowflake, voir Prise en charge par les systèmes d’exploitation.

Téléchargement du type de pilote souhaité¶

Pour télécharger le pilote, suivez les étapes correspondant au type de pilote souhaité.

Facultatif : vérifiez la signature du paquet de pilotes¶

Pour vérifier la signature du pack du pilote JDBC :

1. Depuis le serveur de clés publiques, téléchargez et importez la clé publique Snowflake GPG pour la version du pilote JDBC que vous utilisez :

   • Pour les versions 3.22.0 et supérieures :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 2A3149C82551A34A

   • Pour les versions 3.19.1 à 3.21.0 :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 5A125630709DD64B

   • Pour les versions 3.13.23 à 3.19.0 :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3

   • Pour les versions 3.12.13 à 3.13.22 :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 37C7086698CB005C

   • Pour les versions 3.6.26 à 3.12.12 :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys EC218558EABB25A1

   • Pour les versions 3.6.25 et inférieures :

     $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 93DB296A69BE019A

   Note

   Si cette commande échoue avec l’erreur suivante :

   gpg: keyserver receive failed: Server indicated a failure
   

   Copy

   alors spécifiez que vous voulez utiliser le port 80 pour le serveur de clés :

   gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
   

   Copy

2. Exécutez la commande gpg --verify pour vérifier la signature du pack.

   Pour l’indicateur de ligne de commande --verify, spécifiez le fichier .asc que vous avez téléchargé précédemment comme fichier de signature et le fichier JAR comme fichier contenant les données signées.

   Par exemple :

   $ gpg --verify snowflake-jdbc-3.22.0.jar.asc snowflake-jdbc-3.22.0.jar
   gpg: Signature made Wed 22 Feb 2017 04:31:58 PM UTC using RSA key ID <gpg_key_id>
   gpg: Good signature from "Snowflake Computing <snowflake_gpg@snowflake.net>"

   Assurez-vous d’indiquer les numéros de version corrects du pack du pilote JDBC que vous vérifiez. La version 3.22.0 est utilisée dans cet exemple à des fins d’illustration uniquement. La dernière version disponible du pilote peut être supérieure.

   Note

   La vérification de la signature crée un avertissement similaire à celui qui suit :

   gpg: Signature made Mon 24 Sep 2018 03:03:45 AM UTC using RSA key ID <gpg_key_id>
   gpg: Good signature from "Snowflake Computing <snowflake_gpg@snowflake.net>" unknown
   gpg: WARNING: This key is not certified with a trusted signature!
   gpg: There is no indication that the signature belongs to the owner.
   

   Copy

   Pour éviter l’avertissement, vous pouvez accorder la confiance implicite à la clé publique GPG Snowflake.

3. Votre environnement local peut contenir plusieurs clés GPG. Cependant, pour des raisons de sécurité, Snowflake fait tourner périodiquement la clé publique GPG. Nous recommandons de supprimer la clé publique existante après avoir confirmé que la dernière clé fonctionne avec le dernier pack signé :

   $ gpg --delete-key "Snowflake Computing"
   

   Copy

Intégrer le pilote dans un projet Maven¶

Pour intégrer le pilote dans un projet Maven :

• Ajoutez le pilote en tant que dépendance à votre fichier pom.xml.

Par exemple :

• Pilote standard

  <dependencies>
    ...
    <dependency>
      <groupId>net.snowflake</groupId>
      <artifactId>snowflake-jdbc</artifactId>
      <version>3.22.0</version>
    </dependency>
    ...
  </dependencies>

• Pilote conforme à FIPS

  <dependencies>
    ...
    <dependency>
      <groupId>net.snowflake</groupId>
      <artifactId>snowflake-jdbc-fips</artifactId>
      <version>3.22.0</version>
    </dependency>
    ...
  </dependencies>

• Pilote Thin-jar

  <dependencies>
    ...
    <dependency>
      <groupId>net.snowflake</groupId>
      <artifactId>snowflake-jdbc-thin</artifactId>
      <version>3.22.0</version>
    </dependency>
    ...
  </dependencies>

où la balise <version> spécifie la version du pilote que vous souhaitez intégrer. Notez que la version 3.22.0 est utilisée dans cet exemple uniquement à des fins d’illustration. Une version plus récente du pilote peut être disponible.

Les notes du développeur sont hébergées avec le code source sur GitHub.

Ajouter les classes JNA à votre classpath¶

La mise en cache de la connexion pour le SSO basé sur le navigateur et la mise en cache des jetons pour l’authentification multifactorielle (MFA) nécessitent l’utilisation des classes Java Native Access (JNA) pour enregistrer les données en toute sécurité dans le système de fichiers.

A partir de la version 3.12.18 du pilote JDBC , les classes JNA ne sont plus empaquetées dans le fichier JAR du pilote JDBC. Dans le fichier pom.xml du pilote JDBC, les dépendances de ces classes sont marquées comme facultatives.

Si vous devez utiliser la mise en cache des connexions ou des jetons, vous devez ajouter les bibliothèques suivantes à votre classpath :

• Pour Mac et Linux :

  • JNA

• Pour Windows :

  • JNA

  • Plate-forme JNA

Le fichier pom.xml pour le pilote JDBC spécifie la version des classes JNA qui ont été testées avec le pilote JDBC. Snowflake recommande d’utiliser cette version (ou la même version majeure) des classes JNA.

Pour plus d’informations, consultez la page Pilote JDBC dans le Maven Central Repository.