Notas de lançamento de ODBC Driver para 2023

Este artigo contém as notas de versão do ODBC 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 ODBC Driver.

Versão 3.1.4 (07 de dezembro de 2023)

Novos recursos e atualizações

  • Nenhum.

Correções de bugs

  • Adicionado o parâmetro de conexão BROWSER_RESPONSE_TIMEOUT para corrigir um problema de autenticação de navegador externo.

  • Adicionado o parâmetro de conexão allowEmptyProxy para corrigir um problema em que uma configuração de proxy vazia poderia substituir a definição de configuração.

  • Corrigido um problema que causava travamentos intermitentes ao enviar dados de telemetria.

  • Removidas as funções CRT banidas pela Microsoft devido a questões de segurança.

Versão 3.1.3 (13 de novembro de 2023)

Novos recursos e atualizações

  • Atualizadas as seguintes bibliotecas:

    • openssl de 3.0.9 para 3.0.11

    • curl de 8.1.2 para 8.4.0

  • SQLGetStmtAttr(SQL_SF_STMT_ATTR_LAST_QUERY_ID) atualizado para retornar o ID da consulta com falha.

  • Adicionado suporte para gerenciar a frequência de novas tentativas para solicitações de conexão malsucedidas:

    • Adicionado o parâmetro retryTimeout com um valor padrão de 300 segundos.

    • Atualizada a forma como o driver usa os parâmetros de conexão LOGIN_TIMEOUT e maxHttpRetries e alterado o valor padrão de LOGIN_TIMEOUT para 300 segundos.

Correções de bugs

  • Corrigido um problema em que o driver falhava ao buscar os resultados da consulta devido a um tempo limite na validação OSCP.

  • Corrigido um problema em que os comandos PUT e GET falhavam quando um caminho de arquivo continha caracteres diferentes de ASCII.

  • Corrigido um problema em que um comando PUT em GCP substituía arquivos existentes quando overwrite=true não era especificado.

  • Removidas as funções CRT banidas pela Microsoft devido a questões de segurança.

Versão 3.1.1 (29 de setembro de 2023)

Novos recursos e atualizações

  • Atualizado o pacote cacert usado para conexões SSL.

Correções de bugs

  • Mensagens de erro aprimoradas relacionadas a falhas de comando PUT/GET para fornecer erros específicos em vez de «exceção desconhecida».

  • Foi corrigido um problema em que o driver ODBC continuava tentando fazer downloads de partes mesmo depois que o aplicativo cancelava a consulta relacionada.

  • Corrigido um problema em que o uso de SQLGetData() com o formato de resultado ARROW poderia diminuir o desempenho.

  • Corrigido um problema em que as credenciais eram mostradas em mensagens de erro.

  • Corrigido um problema com solicitações de OCSP em ambientes AWSPrivateLink.

  • Corrigido um problema em que o driver não usava o OCSP URL inteiro no certificado ao executar a validação de OCSP.

Versão 3.1.0 (23 de agosto de 2023)

Mudanças da versão da mudança de comportamento (BCR)

  • Corrigido um problema em que, sob certas condições, o driver poderia tentar novamente solicitações de HTTP indefinidamente.

    Anteriormente, durante uma interrupção, o driver tentaria novamente a chamada de HTTP com falha continuamente até que a solicitação fosse bem-sucedida ou até que alguém forçasse a interrupção da operação.

    Com essa alteração, o driver desativa infinitas tentativas de HTTP originadas de chamadas execute e executeQuery. Agora, o driver limita as tentativas de HTTP a sete, por padrão. Os clientes podem definir o parâmetro de conexão maxHttpRetries para personalizar o número máximo de novas tentativas. Os clientes podem definir maxHttpRetries=0 para remover o limite de novas tentativas, mas com isso há o risco de o driver repetir infinitamente chamadas de HTTP com falha.

  • Para melhorar o desempenho, a função SQLExecDirect() não valida mais vinculações de parâmetros desnecessariamente para uma consulta.

    Anteriormente, o driver enviava duas solicitações para cada chamada SQLExecDirect(): uma solicitação de descrição e uma solicitação de execução. Para melhorar o desempenho, a solicitação de descrição é omitida. Com esta alteração, o driver não validará as vinculações de parâmetros necessárias à consulta. Se as vinculações de parâmetros da consulta anterior não forem limpas usando SQLFreeStmt(SQL_RESET_PARAMS), elas poderão ser aplicadas incorretamente à consulta seguinte e causar problemas.

Novos recursos e atualizações

  • Adicionado o parâmetro de sessão CLIENT_OUT_OF_BAND_TELEMETRY_ENABLED para ativar e desativar o suporte de telemetria fora de banda (OOB).

Correções de bugs

  • Corrigido um problema em que o driver poderia falhar ao obter um resultado de consulta para consultas com múltiplas instruções que começam com novos tipos de instrução, como CALL.

  • Corrigido um problema que poderia fazer com que a função SQLColAttribute() retornasse um valor incorreto de SQL_DESC_OCTET_LENGTH em colunas VARCHAR, o que poderia truncar dados.

  • Corrigido um problema em que o driver não conseguia baixar os resultados da consulta enviando incorretamente tempos limite de telemetria fora de banda (OOB) ao usar links privados.

Versão 3.0.2 (27 de julho de 2023)

Novos recursos e atualizações

  • Atualizadas as seguintes bibliotecas de software:

    • util-linux para a versão 2.39.0.

    • curl para a versão 8.1.2.

  • Processamento transacional/analítico híbrido aprimorado (HTAP).

  • Defina o padrão LogLevel como OFF para clientes ODBC executados em plataformas Windows.

Correções de bugs

  • Corrigido um problema que causava travamentos intermitentes ao enviar telemetria.

Versão 3.0.1 (06 de julho de 2023)

Mudanças de BCR (versão da mudança de comportamento)

A partir da versão 3.0.1 do driver ODBC:

  • Atualizado de openssl 1.1.1 para openssl 3.0.9. Consequentemente, as chaves privadas geradas usando os algoritmos de criptografia obsoletos na versão anterior da biblioteca openssl não funcionam mais. Ao atualizar para ODBC 3.0.1, você deverá gerar novamente seu arquivo de chave privada usado para autenticação de par de chaves.

  • Suporte descartado para CentOS 6 e MacOS 10.14 e 10.15.

Novos recursos e atualizações

  • Atualizadas as seguintes bibliotecas de software:

    • openssl para a versão 3.0.9.

    • ICU para a versão 71.1.0.

  • Criada uma arquitetura de pacote de lançamento única e unificada que oferece suporte aos sistemas Mac x86_64 e arm64.

Correções de bugs

  • Corrigido um problema em que o driver travava intermitentemente quando CLIENT_SESSION_KEEP_ALIVE era definido como verdadeiro em sistemas Windows.

Versão 2.25.12 (06 de junho de 2023)

Novos recursos e atualizações

Nenhum.

Correções de bugs

  • Corrigido um problema em que solicitações muito grandes com grandes quantidades de vinculações de parâmetros poderiam travar um aplicativo ao exceder o tamanho do registro de log.

  • Corrigido um problema com a validação OCSP.

  • Corrigido um problema que poderia revelar inadvertidamente uma senha de proxy no arquivo de log do Snowflake.

Versão 2.25.11 (20 de abril de 2023)

Novos recursos e atualizações

  • Atualizada a biblioteca libcurl da versão 7.87.0 para 7.88.1.

  • Atualizada a biblioteca zlib da versão 1.2.11 para 1.2.13.

Correções de bugs

  • Corrigido um problema de URL inválido que poderia ocorrer durante a validação de OCSP ao fazer conexões.

  • Corrigido um problema em que as conexões falhavam quando as credenciais eram fornecidas ao usar proxies que não precisam delas.

  • Removidas chamadas de função openssl obsoletas.

  • Corrigido um problema em que as vinculações de parâmetros de tipo duplo podiam perder precisão.

  • Removidas chamadas de função inseguras banidas pela Microsoft.

Versão 2.25.10 (22 de março de 2023)

Novos recursos e atualizações

  • Atualizada a biblioteca libcurl da versão 7.84.0 para 7.87.0.

Correções de bugs

  • Corrigido um problema que impedia os clientes de criar um arquivo DSN (nome da fonte de dados).

  • Corrigido um problema em que o comando PUT falhava na replicação de dados.

  • Corrigido um problema em que um aplicativo Macintosh executando uma arquitetura ARM64 não conseguia se conectar ao Snowflake usando o driver Apple Silicon ODBC nativo.

Versão 2.25.9 (28 de fevereiro de 2023)

Novos recursos e atualizações

Nenhum.

Correções de bugs

  • Adicionado suporte para o tipo de dados GEOMETRY na enumeração SnowflakeType para corrigir um problema que ocorria ao chamar a função SQLColumns() para retornar metadados que incluíam dados GEOMETRY.

  • Corrigido um problema em que os dados do carimbo de data/hora eram retornados incorretamente como NULL em alguns casos.

Versão 2.25.8 (8 de fevereiro de 2023)

Novos recursos e atualizações

Nenhum.

Correções de bugs

  • Corrigido um problema em que uma instrução de vinculação de matriz INSERT falhava quando o esquema não estava definido na sessão.

  • Corrigido um problema que ocasionalmente causava falha no driver ODBC ao executar consultas GET e PUT.

  • Corrigido um problema em que o driver ODBC enviava sinais SIGPIPE após a sessão ficar inativa por cerca de 120 segundos.

  • Corrigido um problema em que o uso da autenticação Okta falhava ao receber um erro HTTP 429.