Notas de versão do JDBC 3.x do Amazon Athena

Plug-in de autenticação de propagação de identidade confiável JWT: foi adicionado um novo plug-in de autenticação para oferecer suporte à integração da propagação de identidade confiável do JWT com drivers JDBC. Esse tipo de autenticação permite usar um JSON Web Token (JWT) obtido de um provedor de identidades externo como parâmetro de conexão para autenticação no Athena. Com a propagação de identidade confiável, o contexto de identidade é adicionado a um perfil do IAM para identificar o usuário que está solicitando acesso aos recursos da AWS. Para obter informações sobre como habilitar e usar a propagação de identidade confiável, consulte O que é propagação de identidade confiável?.

Suporte a endpoints SSO OIDC e SSO Admin personalizados: foi adicionado suporte a endpoints SSO OIDC e admin SSO personalizados no driver JDBC. Esse aprimoramento permite que você especifique seus próprios endpoints para serviços de SSO ao executar o JDBC por trás de VPCs.

Atualização da versão do AWS SDK: atualizamos a versão do AWS SDK usada no driver para 2.32.16 e atualizamos as dependências do projeto para a versão 3.6.0.

Recursos de registro em log: registro em log aprimorado das buscas do S3, elevando o nível do log a INFO e adicionando métricas para contagens de linhas, desvios e comprimento de objetos. Implementado rastreamento do ciclo de vida das conexões e otimizada a performance geral do registro em log.

Tratamento de caracteres especiais: melhor tratamento dos caracteres especiais para padrões LIKE em nomes de esquemas e de catálogos.

Gerenciamento do estado da conexão: gerenciamento aprimorado do estado da conexão para evitar possíveis erros, evitando chamadas de API após a conexão ser fechada e adicionando verificações de segurança para operações de consulta durante o encerramento.

Metadados de consultas DDL: corrigido o problema de NoSuchKeyFound com o tratamento de metadados de consultas DDL.

Parâmetros de configuração do resultado: adição de suporte a dois novos parâmetros de conexão ExpectedBucketOwner e AclOption. Para obter mais informações, consulte Parâmetros de configuração do resultado.

Versão do AWS SDK: a versão do AWS SDK usada no driver foi atualizada para 2.30.22.

Buscador de resultados: agora, o driver seleciona automaticamente o método mais rápido para fazer o download dos resultados das consultas. Isso dispensa a necessidade de configurar manualmente o buscador na maioria das situações. Para obter mais informações, consulte Parâmetros de busca de resultados.

ResultSet: agora, o driver lida com a iteração sobre os conjuntos de resultados de instruções de DDL que não produzem objetos de resultados no S3. Além disso, o driver retorna um objeto ResultSet vazio, em vez de um objeto com anulação, quando GetQueryResultsStream retorna uma página completamente em branco.

ResultsStream: o processo de transmissão de resultados foi otimizado ao remover chamadas desnecessárias para contar o número de linhas nos buffers internos.

getTables: a chamada GetTables foi otimizada ao lidar com os tipos de tabela com base nas respostas ListTableMetadata e GetTableMetadata.

Autenticação DataZone — Foi adicionado suporte para os plug-ins de autenticação DataZone DataZoneIdC e DataZoneIAM. Para obter mais informações, consulte Provedor de credenciais DataZone IdC e Provedor de credenciais DataZone IAM.

Tempo limite da rede — O tempo limite da rede agora pode ser definido usando o parâmetro de conexão NetworkTimeoutMillis. Anteriormente, ele só podia ser definido no próprio objeto Connection. Para obter mais informações, consulte Tempo limite de rede.

Manipulação de objetos vazios do S3 — O driver agora manipula objetos vazios no buscador do S3 em vez de lançar uma exceção Intervalo não satisfatório no Amazon S3.

Registro — O driver não registra mais a mensagem Itens solicitados para execução da consulta [...], mas a assinatura é cancelada após o consumo dos resultados da consulta.

Strings de parâmetros vazios — O driver agora manipula strings vazias presentes em um parâmetro de conexão como se o parâmetro não estivesse presente. Isso resolve problemas que ocorriam quando algumas ferramentas de BI passavam inadvertidamente strings vazias que causavam tentativas de autenticação não intencionais.

Mapeamento de tipos de dados: melhoria na conformidade com a especificação JDBC alterando a forma como o driver mapeia os tipos de dados tinyint, smallint, row e struct para objetos Java.

Atualização da versão do AWS SDK: a versão do AWS SDK usada no driver foi atualizada para 2.26.23.

Comentários: corrigido um problema com comentários de linha no final de uma instrução.

Listagem de banco de dados: corrigido um problema no qual listar os bancos de dados poderia entrar em um loop infinito quando a última página retornada pela API ListDatabases paginada estivesse vazia.

Provedor de credenciais de JWT — Foi adicionado suporte para durações de sessão especificadas pelo usuário. Para obter mais informações, consulte Duração da sessão da função.

Pool de threads — Criado um ThreadPoolExecutor por conexão para tarefas assíncronas para evitar o uso do pool ForkJoin.

Provedores de credenciais — O host proxy agora é analisado para obter o esquema e o host quando o cliente HTTP está configurado para IdPs externos.

Provedor de credenciais padrão — Garantimos que o provedor de credenciais padrão não possa ser fechado pelo código do cliente.

getColumns — Corrigido um problema de propriedade da coluna ORDINAL_COLUMN no método DatabaseMetaData#getColumns.

ResultSet — Foi adicionado suporte para Infinity, -Infinity e NaN para ResultSet.. Corrigida uma discrepância entre o tipo de coluna retornado das operações de catálogo e o conjunto de resultados de uma consulta concluída.

Desempenho da operação de catálogo: o desempenho foi aprimorado para operações de catálogo que não usam caracteres curinga.

Alteração do intervalo mínimo de pesquisa: o padrão do intervalo mínimo de pesquisa foi modificado para reduzir o número de chamadas de API que o driver faz para o Athena. As conclusões de consultas ainda são detectadas o mais rápido possível.

Possibilidade de descoberta de ferramentas de BI: o driver ficou mais facilmente detectável para ferramentas de business intelligence.

Mapeamento de tipos de dados: o mapeamento de tipos de dados para os tipos de dados DDL do Athena binary, array e structfoi aprimorado.

Versão do AWS SDK: a versão do AWS SDK usada no driver foi atualizada para 2.25.34.

Listagens de tabelas de catálogos federados: corrigido um problema que fazia com que catálogos federados retornassem uma lista vazia de tabelas.

getSchemas: corrigido um problema que fazia com que o método JDBC DatabaseMetaData#getSchemas buscasse bancos de dados somente do catálogo padrão, e não de todos os catálogos.

getColumns: corrigido um problema que fazia com que um catálogo nulo fosse retornado quando o método JDBC DatabaseMetaData#getSchemas era chamado com um nome de catálogo nulo.

Suporte adicionado para autenticação integrada do Windows por meio do Microsoft Active Directory Federation Services (AD FS) e autenticação com base em formulário.

Para compatibilidade com versões anteriores da versão 2.x, o subprotocolo JDBC awsathena agora é aceito, mas produz um aviso de depreciação. Em vez disso, use o subprotocolo JDBC athena.

AwsDataCatalog agora é o padrão para o parâmetro do catálogo, e default é o padrão para o parâmetro do banco de dados. Essas alterações garantem que os valores corretos do catálogo e do banco de dados atuais sejam retornados em vez de nulos.

Em conformidade com a especificação JDBC, IS_AUTOINCREMENT e IS_GENERATEDCOLUMN agora retornam uma string vazia em vez de NO.

O tipo de dados int do Athena agora é mapeado para o mesmo tipo de JDBC integer do Athena, em vez de para other.

Quando os metadados da coluna do Athena não contêm os campos opcionais precision e scale, o driver agora retorna zero para os valores correspondentes em uma coluna ResultSet.

A versão do AWS SDK foi atualizada para 2.21.39.

Foi corrigido um problema com GetQueryResultsStream que causava a ocorrência de uma exceção quando resultados de texto simples do Athena tinham uma contagem de colunas inconsistente com a contagem de colunas nos metadados de resultados do Athena.