Requisitos Java para o driver JDBC

O driver Snowflake JDBC requer Java LTS (Long-Term Support) versão 1.8 ou superior. Se a versão mínima requerida do Java não estiver instalada nas máquinas clientes onde o driver JDBC estiver instalado, será necessário instalar ou Oracle Java ou OpenJDK.

Nota

Se você usar JDK 1.8 u91 ou anterior, ou se usar um armazenamento confiável personalizado, leia o artigo da base de conhecimento Atualizações do certificadoTLS da autoridade de certificação DigiCert Global Root G2 (CA) para obter informações sobre como atualizar o armazenamento confiável com o certificado necessário.

Neste tópico:

Oracle Java

O Oracle Java suporta atualmente o Java 8. Para instruções de download e instalação, vá para:

OpenJDK

OpenJDK é uma implementação de código aberto do Java que fornece pacotes JDK 8 para vários ambientes Linux. Pacotes para ambientes não-Linux ou versões Java superiores só estão disponíveis através de terceiros. Para mais informações, vá para:

Requisitos de criptografia de dados do lado do cliente

O driver JDBC usa a especificação AES para criptografar os arquivos carregados nos estágios do Snowflake (usando PUT) e decodificar os arquivos baixados (via GET). O driver criptografa automaticamente os arquivos preparados usando chaves de 128 bits, mas também suporta a criptografia de arquivos usando chaves de 256 bits para um nível superior de criptografia AES.

Para usar chaves de 256 bits em vez das chaves de 128 bits padrão para criptografia de arquivos preparados, seu administrador de conta deve definir o parâmetro de conta CLIENT_ENCRYPTION_KEY_SIZE. Para obter mais informações sobre a definição de parâmetros para sua conta, consulte Gerenciamento de parâmetros.

Entretanto, para criptografar arquivos de estágio usando chaves de 256 bits, o Java Runtime Environment (JRE) usado pelo driver JDBC requer arquivos de política de jurisdição de força ilimitada do Java Cryptography Extension (JCE) em cada máquina onde o driver JDBC está instalado:

  • O Oracle Java não inclui os arquivos de política; eles devem ser baixados e instalados separadamente (consulte abaixo).

  • O OpenJDK inclui os arquivos de política automaticamente; não são necessárias tarefas adicionais.

A próxima seção fornece instruções para a instalação dos arquivos de política para Oracle Java.

Instalação de arquivos de política de jurisdição de força ilimitada do JCE para Oracle Java

Atenção

Cada vez que você instala uma nova versão do Oracle Java em sua máquina cliente pode ser necessário reinstalar os arquivos de política como descrito abaixo.

Para instalar os arquivos de política para Oracle Java:

  1. Baixe os arquivos de política para sua versão do Oracle Java:

    O arquivo zip contém um arquivo README.txt e dois arquivos .jar.

  2. Instale os arquivos. Existem 3 maneiras possíveis de instalar os arquivos, dependendo de seu ambiente:

    • Se a versão 2.4.26 (ou superior) do driver Snowflake JDBC estiver instalada, você pode se conectar ao Snowflake e tentar executar um comando PUT ou GET.

      Se os arquivos de política não forem instalados ou se estiverem instalados incorretamente (isto é, o JRE não pode localizar os arquivos), o sistema retorna um erro, que inclui o diretório onde o JRE esperava encontrar os arquivos de política. Você pode então copiar os arquivos para o diretório especificado no erro.

      Para obter a última versão do driver, baixe-o no Repositório Central Maven. Para obter mais informações, consulte Download/integração do driver JDBC.

    • Se uma única versão do Java for instalada em sua máquina cliente, coloque os dois .jar arquivos no subdiretório jre/lib/security de sua instalação Java, conforme descrito no README.txt arquivo incluído com os arquivos de política.

      Por exemplo, no macOS com Java 8 instalado, o diretório seria:

      /Library/Java/JavaVirtualMachines/jdk1.8.0_45.jdk/Contents/Home/jre/lib/security

    • Se várias versões do Java estiverem instaladas, o driver JDBC localizará automaticamente uma instalação Java a ser usada; entretanto, recomendamos usar JAVA_HOME para especificar explicitamente a versão a ser usada em seu ambiente:

      • Se JAVA_HOME estiver definido, coloque os arquivos .jar no diretório jre/lib/security para a instalação Java referenciada em JAVA_HOME.

      • Se JAVA_HOME não estiver definido, recomendamos colocar os arquivos .jar no diretório lib/security para cada JRE instalado.

  3. Após instalar os arquivos, talvez seja necessário sair de seu cliente e voltar a entrar no sistema.

Linguagem: Português