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 Snowpark library to the list of dependencies. For example:

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

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

Set the <version> tag to the version of the library that you want to use. Note that version 0.9.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.9.0 as an example.

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

    Note

    As of Snowpark 0.9.0, rather than downloading an archive file that contains the Snowpark library and its dependencies in separate JAR files, you can choose to download a single JAR file that contains the Snowpark library and its dependencies. This JAR file is named snowpark-0.9.0-with-dependencies.jar.

    If you download this JAR file, skip the rest of the steps. (The steps apply to the archive file.)

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

    1. Download the snowpark-0.9.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.9.0-bundle.tar.gz.asc snowpark-0.9.0-bundle.tar.gz

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

      Note

      Verifying the signature produces a warning similar to the following:

      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.
      

      To avoid the warning, you can grant the Snowflake GPG public key implicit trust.

  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.9.0.jar file

    • the lib directory