Configuration d’autres environnements de développement pour Snowpark

Si vous utilisez un environnement de développement non couvert précédemment (voir Configuration de votre environnement de développement pour Snowpark), consultez les instructions de cette rubrique pour configurer votre environnement afin d’utiliser Snowpark.

Dans ce chapitre :

Utilisation de la bibliothèque Snowpark dans un fichier de construction sbt

Pour intégrer la bibliothèque Snowpark dans un projet qui utilise un fichier de construction sbt, ajoutez la bibliothèque comme dépendance.

Dans le fichier build.sbt de votre projet, apportez les modifications suivantes :

  1. Si le paramètre scalaVersion ne correspond pas à la version que vous prévoyez d’utiliser, mettez-le à jour. Par exemple :

    scalaVersion := "2.12.13"
    

    Notez que vous devez utiliser une version de Scala qui est prise en charge pour l’utilisation de la bibliothèque Snowpark.

  2. Ajoutez le référentiel de la version OSGEO à la liste des résolveurs, et ajoutez la bibliothèque Snowpark à la liste des dépendances. Par exemple :

    resolvers += "OSGeo Release Repository" at "https://repo.osgeo.org/repository/release/"
    libraryDependencies += "com.snowflake" % "snowpark" % "0.6.0"

Utilisation de la bibliothèque Snowpark dans un projet Maven

Pour intégrer la bibliothèque Snowpark dans un projet Maven, ajoutez la bibliothèque comme dépendance à votre fichier pom.xml. Par exemple :

<repositories>
  <repository>
    <id>OSGeo Release Repository</id>
    <url>https://repo.osgeo.org/repository/release/</url>
  </repository>
</repositories>
...
<dependencies>
  ...
  <dependency>
    <groupId>com.snowflake</groupId>
    <artifactId>snowpark</artifactId>
    <version>0.6.0</version>
  </dependency>
  ...
</dependencies>

Définissez la balise <version> comme la version de la bibliothèque que vous souhaitez utiliser. Notez que la version 0.6.0 est utilisée dans cet exemple uniquement à des fins d’illustration. La dernière version disponible du pilote peut être supérieure.

Téléchargement de la bibliothèque Snowpark et de ses dépendances

Si vous n’utilisez pas sbt ou Maven pour gérer les dépendances de votre application et que vous avez besoin d’une copie de la bibliothèque Snowpark et de ses dépendances, vous pouvez télécharger un fichier d’archive TAR ou un fichier zip qui contient les fichiers JAR de la bibliothèque et de toutes ses dépendances. L’archive TAR/ZIP comprend la documentation de référence de l’API au format scaladoc.

Pour télécharger la bibliothèque Snowpark :

  1. Allez dans le répertoire de la bibliothèque Snowpark dans Snowflake Client Repository :

    https://sfc-repo.snowflakecomputing.com/snowpark/java/index.html

  2. Naviguez jusqu’au répertoire de la version que vous voulez utiliser. Le reste des étapes utilise 0.6.0 comme exemple.

  3. Téléchargez le fichier snowpark-0.6.0-bundle.tar.gz (ou .zip).

  4. Si vous voulez vérifier la signature du fichier :

    1. Téléchargez le fichier snowpark-0.6.0-bundle.tar.gz.asc.

    2. Téléchargez et importez la dernière clé publique GPG de Snowflake à partir du serveur de clés publiques :

      $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys <GPG_KEY_ID>
      

      Pour <GPG_KEY_ID>, indiquez l’un des IDs de clés suivants :

      Version Snowpark

      ID de clé GPG

      0.6.0 et supérieur

      37C7086698CB005C

      Note

      Si cette commande échoue avec l’erreur suivante :

      gpg: keyserver receive failed: Server indicated a failure
      

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

      gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
      
    3. Exécutez la commande suivante pour vérifier la signature. Par exemple :

      gpg --verify snowpark-0.6.0-bundle.tar.gz.asc snowpark-0.6.0-bundle.tar.gz

      La sortie de la commande devrait indiquer que le fichier d’archive a été signé avec cette clé :

      gpg: Signature made Fri Oct 30 11:37:18 2020 PDT
      gpg:                using RSA key 37C7086698CB005C
      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.
  5. Extrayez le contenu du fichier d’archive.

    Le fichier README.txt du fichier d’archive décrit le contenu de chaque répertoire.

  6. Ajoutez le fichier et le répertoire extraits suivants au classpath pour construire et exécuter votre application :

    • le fichier snowpark-0.6.0.jar

    • le répertoire lib