Setting Up Other Development Environments for Snowpark

If you are using a development environment not covered earlier (see Setting Up Your Development Environment for Snowpark), see the instructions in this topic for configuring your environment to use Snowpark.

In this Topic:

Using the Snowpark Library in an sbt Build File

To integrate the Snowpark library into a project that uses an sbt build file, add the library as a dependency.

In the build.sbt file for your project, make the following changes:

  1. If the scalaVersion setting does not match the version that you plan to use, update the setting. For example:

    scalaVersion := "2.12.13"
    

    Note that you must use a Scala version that is supported for use with the Snowpark library.

  2. Add the OSGEO release repository to the list of resolvers, and add the Snowpark library to the list of dependencies. For example:

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

Using the Snowpark Library in a Maven Project

To integrate the Snowpark library into a Maven project, add the library as a dependency to your pom.xml file. For example:

<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>

Set the <version> tag to the version of the library that you want to use. Note that version 0.6.0 is used in this example for illustration purposes only. The latest available version of the driver may be higher.

Downloading the Snowpark Library and its Dependencies

If you are not using sbt or Maven to manage the dependencies for your application and you need a copy of the Snowpark library and its dependencies, you can download a TAR archive file or a zip file that contains the JAR files for the library and all of its dependencies. The TAR/ZIP archive includes the API reference documentation in scaladoc format.

To download the Snowpark library:

  1. Go to the directory for the Snowpark library in the Snowflake Client Repository:

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

  2. Browse to the directory for the version that you want to use. The rest of the steps use 0.6.0 as an example.

  3. Download the snowpark-0.6.0-bundle.tar.gz (or .zip) file.

  4. If you want to verify the signature of the file:

    1. Download the snowpark-0.6.0-bundle.tar.gz.asc file.

    2. Download and import the latest Snowflake GPG public key from the public keyserver:

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

      For <GPG_KEY_ID>, specify one of the following key IDs:

      Snowpark Version

      GPG Key ID

      0.6.0 and higher

      37C7086698CB005C

      Note

      If this command fails with the following error:

      gpg: keyserver receive failed: Server indicated a failure
      

      then specify that you want to use port 80 for the keyserver:

      gpg --keyserver hkp://keyserver.ubuntu.com:80  ...
      
    3. Run the following command to verify the signature. For example:

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

      The output of the command should indicate that the archive file was signed with this key:

      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. Extract the contents of the archive file.

    The README.txt file in the archive file describes the contents of each directory.

  6. Add the following extracted file and directory to the classpath for building and running your application:

    • the snowpark-0.6.0.jar file

    • the lib directory