Arquitetura & MigraçãoArquitetura
Nível de dificuldade: Intermediário (3 de 5)
SDK JavaScript da AWS 3.1170.0 integra chaves KMS compartilhadas entre contas e filtro de catálogo no Athena
O AWS SDK for JavaScript v3 chegou à versão 3.1170.0 em 16 de novembro de 2026, segundo o changelog oficial no GitHub. Entre as mais de 20 mudanças do release, duas afetam diretamente quem escreve código de automação e integração: um novo parâmetro no client-kms para lidar com chaves compartilhadas entre contas, e um filtro no client-athena para catálogos grandes do Glue Data Catalog.
Nenhuma das duas é uma API nova: são parâmetros opcionais em operações que você provavelmente já chama. Isso significa que dá pra adotar sem reescrever fluxo nenhum, só adicionando um campo no payload da chamada.
KMS: saber de quem é a chave sem sair do código
Até aqui, compartilhar uma chave do AWS KMS entre contas exigia políticas de chave (key policy) escritas à mão, e o ListKeys só devolvia as chaves da própria conta. A partir deste release, o KMS suporta compartilhamento de chaves via AWS Resource Access Manager (RAM), e o SDK acompanha isso com um parâmetro novo: ResourceOwners na operação ListKeys.
O parâmetro aceita o literal SELF para listar só as chaves da conta que faz a chamada, um valor para listar as chaves recebidas via RAM, ou os dois conjuntos juntos — a nota de release confirma SELF explicitamente; os demais literais aceitos estão na referência da API do serviço.
import { KMSClient, ListKeysCommand } from "@aws-sdk/client-kms";
const client = new KMSClient({ region: "sa-east-1" });
// Só as chaves que a própria conta possui
const ownKeys = await client.send(
new ListKeysCommand({ ResourceOwners: ["SELF"] })
);
// Chaves próprias + chaves compartilhadas via RAM
const allKeys = await client.send(
new ListKeysCommand({ ResourceOwners: resourceOwnersComTodosOsValores })
);Na prática, isso resolve um problema comum em ambientes multiconta: antes, pra saber se um recurso numa conta de workload estava usando uma chave da conta de segurança, era preciso cruzar key policy, grant e describe-key manualmente, ou manter inventário à parte. Com ResourceOwners, um script de auditoria consegue listar, numa chamada, exatamente quais chaves são locais e quais vieram compartilhadas.
Vale notar que esse recurso não existe isolado neste release: a mesma lista de mudanças traz, no client-ec2, suporte a KMS keys associadas para snapshots de EBS, permitindo compartilhar e copiar snapshots criptografados com chaves gerenciadas pela AWS entre contas. São capacidades diferentes, mas o padrão é o mesmo: a AWS está reduzindo a fricção de usar KMS fora dos limites de uma única conta.
Athena: parar de carregar o catálogo inteiro
A segunda mudança relevante mexe com quem consulta metadados do Glue Data Catalog via Athena. As operações ListDatabases e ListTableMetadata agora aceitam um parâmetro opcional, AttributesToGet, que permite pedir só nomes de banco ou de tabela (e, no caso de tabela, o tipo), em vez da resposta completa com todas as propriedades.
O ganho declarado pela AWS é redução no tempo de resposta em catálogos grandes. Isso importa pra quem escreve rotinas de descoberta de schema, pipelines de ingestão que precisam checar se uma tabela existe antes de rodar um CREATE TABLE, ou dashboards internos que listam bancos disponíveis: hoje, sem o filtro, cada chamada traga de volta todo o payload de metadados mesmo quando só o nome importa.
import {
AthenaClient,
ListTableMetadataCommand,
} from "@aws-sdk/client-athena";
const client = new AthenaClient({ region: "sa-east-1" });
const response = await client.send(
new ListTableMetadataCommand({
CatalogName: "AwsDataCatalog",
DatabaseName: "analytics",
AttributesToGet: atributosQueVoceQuer, // ex.: só nome e tipo da tabela
})
);Em catálogos com milhares de tabelas, comuns em data lakes de empresas maiores, o corte no volume de dados trafegado tende a se refletir tanto em latência quanto em custo de transferência, embora a AWS não publique números de benchmark no changelog.
O trade-off de cada mudança
As duas mudanças empurram pilares diferentes do Well-Architected Framework, e nenhuma é de graça:
ResourceOwnersno KMS melhora o pilar de Segurança ao dar visibilidade de quem usa o quê entre contas, mas só funciona se a organização já tiver RAM configurado e askey policiescorretas; sem isso, o parâmetro simplesmente não retorna nada compartilhado.AttributesToGetno Athena melhora o pilar de Eficiência de Performance ao reduzir payload e tempo de resposta, mas exige que o código trate a resposta reduzida: se alguma rotina já espera todos os campos deListTableMetadata, adicionar o filtro sem ajustar o parsing quebra silenciosamente em runtime.
Em resumo: nenhuma das duas muda comportamento padrão se você não passar o parâmetro novo, então não há risco de regressão só por atualizar o SDK. O risco aparece quando alguém adiciona o filtro sem revisar quem consome a resposta.
Como atualizar
A atualização é pontual nos pacotes @aws-sdk/client-kms e @aws-sdk/client-athena:
npm install @aws-sdk/client-kms@3.1170.0 @aws-sdk/client-athena@3.1170.0Se o projeto usa outros clients do monorepo (Lambda, EC2, DynamoDB Streams, entre os mais de 20 atualizados neste release), vale checar o updated-packages.md do pacote de assets do release no GitHub antes de subir a versão em produção, porque alguns clients ganharam parâmetros novos sem quebra de compatibilidade, mas outros (como client-lambda, com suporte a instâncias GPU em CreateFunction) trazem mudanças de superfície maiores que merecem revisão de tipos no TypeScript.
Leve para a sua IA
Decida com o seu assistente, com o contexto deste texto já montado.
1. O que você quer saber
Ver o prompt
Li no AWS Hub: "SDK JavaScript da AWS 3.1170.0 integra chaves KMS compartilhadas entre contas e filtro de catálogo no Athena" (https://awshub.com.br/noticia/sdk-javascript-da-aws-3-1170-0-integra-chaves-kms-compartilhadas-entre-contas-e). Resumo: A versão 3.1170.0 do AWS SDK for JavaScript, lançada em 16 de novembro de 2026, adiciona parâmetros para listar chaves KMS compartilhadas via AWS RAM e para filtrar metadados no Athena sem varrer o catálogo inteiro. Minha stack: [descreva em uma linha: serviços, linguagem, volume, região] Isso muda alguma coisa na minha arquitetura? O que eu faria diferente a partir de amanhã?