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.21.0 (11 de dezembro de 2024)

Novos recursos e atualizações

  • Adição de suporte para pontos de extremidade regionais do Google Cloud Storage.

  • Adição da opção SKIP_TOKEN_FILE_PERMISSIONS_VERIFICATION para ignorar a verificação de permissão do arquivo do token.

  • Adição da opção JAVA_LOGGING_CONSOLE_STD_OUT para substituir java.util.logging.ConsoleHandler padrão para gravar em stderr ou stdout com um limite específico.

  • Adição de um log compatível com vinculação de matriz para instruções preparadas.

  • Removido o rótulo experimental de snowflake-jdbc-thin artifact.

  • Alteração dos níveis de algumas mensagens de log.

  • Atualização das dependências do Google e do Netty.

  • Atualização da documentação javadoc.

Correções de bugs

  • Substituição das afirmações brutas por exceções.

  • Alteração do comprimento do IV para 12 bytes para GCM.

  • Alteração da inicialização do SecureRandom para usar um gerador de números aleatórios JVM padrão.

  • Correção de um problema com a fusão de io.netty.versions.properties durante o shade.

  • Correção do registro não controlado da biblioteca Arrow.

  • Correção da realocação de bibliotecas nativas para o Netty e Conscrypt durante o shade.

  • Correção do suporte para obter objeto e obter bytes para o tipo estruturado do arrow nativo.

Versão 3.20.0 (30 de outubro de 2024)

Novos recursos e atualizações

  • Adição de suporte para descompressão do ZSTD.

  • Elevada a dependência do commons IO para a versão 2.17.0.

Correções de bugs

  • Correção de um problema que afetava os drivers JDBC em que os arquivos enviados para os estágios do Azure e GCP eram carregados sem criptografia do lado do cliente quando o parâmetro CLIENT_ENCRYPTION_KEY_SIZE era definido como 256 bits em vez do padrão de 128 bits. Para obter mais informações, consulte o Conselhos de segurança do JDBC do Snowflake.

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.