Configuration d’autres environnements de développement pour Snowpark Scala

Si vous utilisez un environnement de développement non couvert précédemment (voir Configuration de votre environnement de développement pour Snowpark Scala), 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"
    
    Copy

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

  2. Ajoutez la bibliothèque Snowpark à la liste des dépendances. Par exemple :

    libraryDependencies += "com.snowflake" % "snowpark" % "1.9.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 :

<dependencies>
  ...
  <dependency>
    <groupId>com.snowflake</groupId>
    <artifactId>snowpark</artifactId>
    <version>1.9.0</version>
  </dependency>
  ...
</dependencies>

Définissez la balise <version> comme la version de la bibliothèque que vous souhaitez utiliser. Notez que la version 1.9.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 sur la page Téléchargement du client Snowpark, et trouvez la version que vous voulez utiliser.

    Le reste des étapes utilise 1.9.0 comme exemple.

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

    Note

    À partir de Snowpark 0.9.0, plutôt que de télécharger un fichier d’archive qui contient la bibliothèque Snowpark et ses dépendances dans des fichiers JAR séparés, vous pouvez choisir de télécharger un seul fichier JAR qui contient la bibliothèque Snowpark et ses dépendances. Ce fichier JAR est nommé snowpark-1.9.0-with-dependencies.jar.

    Si vous téléchargez ce fichier JAR, ignorez le reste des étapes. (Les étapes s’appliquent au fichier d’archive).

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

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

    2. Depuis le serveur de clés publiques, téléchargez et importez la clé publique GPG Snowflake pour la version de la bibliothèque que vous utilisez :

      • Pour les versions 1.6.1 et supérieures :

        $ gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 630D9F3CAB551AF3
      • Pour les versions 0.6.0 à 1.6.0 :

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

      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
    3. Exécutez la commande suivante pour vérifier la signature. Par exemple :

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

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

      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.

  4. Extrayez le contenu du fichier d’archive.

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

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

    • le fichier snowpark-1.9.0.jar

    • le répertoire lib