Como configurar outros ambientes de desenvolvimento para o Snowpark Java¶

Como usar a biblioteca do Snowpark em um projeto do Maven¶

Para integrar a biblioteca do Snowpark em um projeto do Maven, adicione a biblioteca como uma dependência ao seu arquivo pom.xml. Por exemplo:

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

Defina a tag de <versão> como a versão da biblioteca que você deseja usar. Observe que a versão 1.10.0 é usada neste exemplo apenas para fins ilustrativos. A última versão disponível do driver pode ser mais alta.

Download da biblioteca do Snowpark e de suas dependências¶

Se você não estiver usando Maven para gerenciar as dependências de seu aplicativo e precisar de uma cópia da biblioteca do Snowpark e de suas dependências, você pode baixar um arquivo TAR ou um arquivo zip que contenha os arquivos JAR para a biblioteca e todas as suas dependências. O arquivo TAR/ZIP inclui a documentação de referência da API no formato javadoc.

Para baixar a biblioteca do Snowpark:

1. Vá para a página Download do cliente Snowpark e encontre a versão que você deseja usar.

   As demais etapas usam a 1.10.0 como exemplo.

2. Navegue até o diretório da versão que você deseja usar. As demais etapas usam a 1.10.0 como exemplo.

3. Baixe o arquivo snowpark-1.10.0-bundle.tar.gz (ou .zip).

   Nota

   A partir do Snowpark 0.9.0, em vez de baixar um arquivo morto que contém a biblioteca do Snowpark e suas dependências em arquivos JAR separados, você pode optar por baixar um único arquivo JAR que contém a biblioteca do Snowpark e suas dependências. Esse arquivo JAR é chamado snowpark-1.10.0-with-dependencies.jar.

   Se você baixar este arquivo JAR, pule o restante das etapas. (As etapas se aplicam ao arquivo compactado.)

4. Se você deseja verificar a assinatura do arquivo:

   1. Baixe o arquivo snowpark-1.10.0-bundle.tar.gz.asc.

   2. A partir do servidor de chaves públicas, baixe e importe a chave pública do Snowflake GPG para a versão da biblioteca que você está usando:

      • Para a versão 1.6.1 e superior:

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

      • Para a versão 0.6.0 a 1.6.0:

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

      Nota

      Se esse comando falhar com o seguinte erro:

      gpg: keyserver receive failed: Server indicated a failure
      

      Copy

      depois especifique que você deseja usar a porta 80 para o servidor de chaves:

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

      Copy

   3. Execute o seguinte comando para verificar a assinatura. Por exemplo:

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

      A saída do comando deve indicar que o arquivo morto foi assinado com essa chave.

      Nota

      A verificação da assinatura produz um aviso semelhante ao seguinte:

      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

      Para evitar o aviso, você pode conceder confiança implícita à chave pública GPG do Snowflake.

5. Extraia o conteúdo do arquivo morto.

   O arquivo README.txt no arquivo morto descreve o conteúdo de cada diretório.

6. Adicione o seguinte arquivo e diretório extraído ao classpath para construir e executar seu aplicativo:

   • o arquivo snowpark-1.10.0.jar

   • o diretório lib