Notas de lançamento de JDBC Driver para 2024

Este artigo contém as notas de versão do JDBC Driver, incluindo o seguinte, quando aplicável:

  • Mudanças de comportamento

  • Novos recursos

  • Correções de bugs voltados para o cliente

Snowflake usa controle de versão semântico para atualizações de JDBC Driver.

Consulte Driver JDBC para ver a documentação.

Versão 3.19.1 (25 de outubro de 2024)

Novos recursos e atualizações

  • Atualização da dependência protobuf-java para a versão 3.25.5.

  • Adição da mensagem de log para motivos de consulta cancelada.

  • Dependências do bouncy castle atualizadas.

  • Adição do link do guia de solução de problemas às mensagens para exceções SSL.

Correções de bugs

  • Unificação da representação da cadeia de caracteres de tipos estruturados.

  • Correção do download do fluxo do repositório Git.

  • Correção de um problema com o parâmetro de tempo limite de conexão.

  • Correção de problemas com o registro em log do Arrow.

  • O tratamento de metadados do cabeçalho de armazenamento em nuvem personalizado foi alterado para não diferenciar maiúsculas de minúsculas.

Versão 3.19.0 (29 de agosto de 2024)

Novos recursos e atualizações

  • Adição de suporte para desabilitar o cache de conexão.

  • Adição do parâmetro de conexão PRIVATE_KEY_BASE64 para oferecer suporte a chaves privadas codificadas em base64.

  • Adição das seguintes propriedades de conexão para oferecer suporte à configuração de tempos limite:

    • Propriedades de conexão HTTP_CLIENT_CONNECTION_TIMEOUT e HTTP_CLIENT_SOCKET_TIMEOUT.

    • Propriedade de conexão BROWSER_RESPONSE_TIMEOUT para especificar um tempo limite do navegador.

  • Atualização das seguintes dependências:

    • Arrow para a versão 17.0.0

    • threeten-bp para a versão 1.6.9

Correções de bugs

  • Correção de um problema em que o método getDate não continha um parâmetro esperado.

  • Correção de um problema com uma classe não encontrada relacionada ao LoggerFactory.

Versão 3.18.0 (24 de julho de 2024)

Novos recursos e atualizações

  • Atualização da biblioteca netty para a versão 4.1.111.Final.

  • Adição de setters de propriedade ausentes em SnowflakeBasicDataSource.

  • Adição dos seguintes parâmetros de conexão para oferecer suporte à compatibilidade com versões anteriores para manipulação de fusos horários:

    • JDBC_DEFAULT_FORMAT_DATE_WITH_TIMEZONE determina se deve-se usar o valor embutido em código anteriormente para o formatador (padrão: true).

    • JDBC_GET_DATE_USE_NULL_TIMEZONE determina se deve-se usar o valor de fuso horário anteriormente nulo para o método getDate (padrão: true).

  • Escolha de um domínio de nível superior para hosts Snowflake.

  • Definição do último ID de consulta para todas as instruções com falha.

Correções de bugs

  • Correção de um problema em que o tempo de espera da nova tentativa poderia ficar fora do intervalo mínimo e máximo.

  • Correção de um problema relacionado à conversão de metadados de campos aninhados em colunas OBJECT.

  • Correção de um problema em que os arquivos de data retornavam o dia errado ao usar o método getString ou getDate.

  • Adição de uma verificação de permissão de usuário para um arquivo de token.

Versão 3.17.0 (8 de julho de 2024)

Novos recursos e atualizações

  • Registro em log aprimorado.

  • Expôs a dimensão vetorial nos metadados da coluna.

  • Adição de suporte para getObject em colunas de vetor.

  • Adição de suporte para leitura de informações de conexão a partir de um arquivo.

  • Adição de suporte para Java versão 21.

  • Adição de suporte para tamanho de LOB máximo dinâmico em metadados.

  • Configuração de registro em log aprimorada.

  • Adição do modo de diagnóstico de conectividade JDBC.

Correções de bugs

  • Correção de um problema com a inserção e leitura de carimbos de data/hora de forma assimétrica se um lote insere um grande número de colunas.

  • Correção de um problema com retorno inconsistente de timestamps_ltz entre os conjuntos de resultados JSON e ARROW.

  • Correção de um problema em que o driver falhava na expansão do padrão de arquivo em um arquivo não encontrado em um padrão diferente.

Versão 3.16.1 (27 de maio de 2024)

Novos recursos e atualizações

  • Adicionado o parâmetro disableSamlURLCheck para desabilitar verificações de URL SAML.

Correções de bugs

  • Corrigido um problema com a escolha da base de domínio do URL da região S3 no nome da região.

  • Corrigido um problema relacionado a caminhos aninhados no Windows ao analisar configurações de cliente.

  • Corrigido um problema em que o método getObject para matrizes no JSON funcionava incorretamente nas versões 3.15.1 e 3.16.0.

  • Corrigido um problema de conversão com um MapVector.

Versão 3.16.0 (29 de abril de 2024)

Novos recursos e atualizações

  • Adicionado suporte para tipos estruturados.

  • Adicionado suporte para tipos de vetores.

  • Suporte aprimorado para chaves privadas criptografadas.

  • Aviso de política de segurança atualizado.

Correções de bugs

  • Corrigido um problema com lógica de nova tentativa OKTA nativa.

  • Corrigido um problema com palavras-chave reservadas não suportadas.

  • Corrigido um problema com tentativas de repetição para solicitações de metadados de consulta GET.

Versão 3.15.1 (05 de abril de 2024)

Novos recursos e atualizações

  • Adicionado suporte para parâmetros ausentes de proxy e senha de usuário JVM: http.proxyUser, http.proxyPassword, https.proxyUser, https.proxyPassword.

  • Alteração na dependência nimbus-jose-jwt da versão 9.37.3.

Correções de bugs

  • A lista de sufixos públicos foi movida para um pacote interno durante o sombreamento.

  • Corrigido um problema ao ignorar credenciais GCS padrão.

  • Corrigido um problema com o retorno de valores decimais ou inteiros em formato ARROW.

  • Corrigido um problema em que o driver retornava java.util.ConcurrentModificationException ao chamar SFAsyncResultSet.next.

  • Corrigido um problema InvalidPathException no Windows devido a caminhos de arquivo aninhados.

Versão 3.15.0 (20 de fevereiro de 2024)

Novos recursos e atualizações

  • Adicionada uma anotação de marcador para a API interna.

  • Adicionadas duas novas propriedades Java, net.snowflake.jdbc.http_client_connection_timeout_in_ms e net.snowflake.jdbc.http_client_socket_timeout_in_ms, para permitir que você configure os tempos limite de conexão e soquete.

  • Adicionado um novo parâmetro de conexão enablePatternSearch para ativar ou desativar a pesquisa de padrões para operações de metadados getCrossReference, getExportedKeys, getImportedKeys e getPrimaryKeys que não devem usar seus parâmetros como padrões. Padrão: true.

Correções de bugs

  • Corrigido um problema com entradas de jar de várias versões.

  • Tornou a dependência opcional em com.amazonaws.Protocol em HttpClientSettingsKey.

  • com.snowflake.client.jdbc.SnowflakeDriver obsoleto.

  • Corrigido um problema ao analisar respostas grandes (maiores que 16MB).

  • Atualizada a especificação JDBC para a versão 4.2.

Versão 3.14.5 (24 de janeiro de 2024)

Novos recursos e atualizações

  • Adicionado suporte para AIX 7.2.

  • Adição de suporte para múltiplas integrações SAML.

  • Atualizada a dependência grpc-netty-shaded para 1.60.0.

  • Criado um thin jar como um artefato maven separado snowflake-jdbc-thin (JDBC thin jar é um recurso experimental).

  • toString() implementado em SnowflakePreparedStatementV1.

  • Adicionado getQueryStatusV2 como substituto do getQueryStatus obsoleto.

Correções de bugs

  • Defina o último ID de consulta para instruções com falha.

  • Corrigida a inicialização de telemetria OOB ao usar o modo sem conexão.

  • Corrigido um problema ao lidar corretamente com a expiração do token do GCP ao usar o modo sem conexão.

  • Formato de arrow corrigido em AIX.