nota
O console do Service Quotas inclui informações sobre as cotas do Amazon Athena. Você também pode usar o console do Service Quotas para solicitar aumentos de cotas
Consultas
Sua conta tem as seguintes cotas relacionadas a consultas para o Amazon Athena. Para obter detalhes, consulte a página Endpoints e cotas do Amazon Athena da Referência geral da AWS.
-
Active DDL queries (Consultas DDL ativas): o número de consultas DDL ativas. As consultas DDL incluem consultas
CREATE TABLE
eALTER TABLE ADD PARTITION
. -
DDL query timeout (Tempo limite de consulta DDL): a quantidade máxima de tempo em minutos que uma consulta DDL pode ser executada antes de ser cancelada.
-
Active DML queries (Consultas DML ativas): o número de consultas DML ativas. As consultas DML incluem consultas
SELECT
,CREATE TABLE AS
(CTAS) eINSERT INTO
. As cotas específicas variam de acordo com a região da AWS. -
DML query timeout (Tempo limite de consulta DML): a quantidade máxima de tempo em minutos que uma consulta DML pode ser executada antes de ser cancelada. É possível solicitar um aumento desse tempo limite para até 240 minutos.
Para solicitar aumentos de cotas, você pode usar o console do Service Quotas para o Athena
O Athena processa as consultas atribuindo recursos com base na carga geral do serviço e no número de solicitações recebidas. Suas consultas podem ser temporariamente enfileiradas antes da execução. Os processos assíncronos retiram as consultas das filas e as executam nos recursos físicos assim que eles se tornam disponíveis e conforme permitido na configuração da sua conta.
As cotas para consultas em DML ativas e para consultas em DDL ativas incluem tanto as consultas em execução quanto as enfileiradas. Por exemplo, caso a cota para consultas em DML ativas seja 25 e o número total de consultas em execução e enfileiradas chegue a 26, a consulta de número 26 retornará um erro TooManyRequestsException
.
nota
Se você deseja controlar a concorrência diretamente para as consultas que você executa no Athena, pode usar reservas de capacidade. Para ter mais informações, consulte Gerenciar a capacidade de processamento de consulta.
Comprimento da string de consulta
O comprimento máximo permitido da string da consulta é de 262.144 bytes, pois as strings são codificadas em UTF-8. Esta não é uma cota ajustável. No entanto, você pode resolver esse problema dividindo as consultas grandes em várias consultas menores. Para obter mais informações, consulte Como posso aumentar o tamanho máximo da string de consulta no Athena?
Grupos de trabalho
Ao usar os grupos de trabalho do Athena, lembre-se dos seguintes pontos:
-
As cotas do serviço do Athena são compartilhadas com todos os grupos de trabalho em uma conta.
-
O número máximo de grupos de trabalho que podem ser criados por região em uma conta é 1000.
-
O número máximo de instruções preparadas em um grupo de trabalho é mil.
-
O número máximo de tags por grupo de trabalho é 50. Para ter mais informações, consulte Restrições de tags.
Bancos de dados, tabelas e partições
O Athena usa o AWS Glue Data Catalog. Consulte Endpoints e cotas do AWS Glue para conhecer as cotas de serviço referentes a tabelas, bancos de dados e partições (por exemplo, o número máximo de bancos de dados ou de tabelas por conta). Observe que, embora o Athena ofereça suporte a consulta a tabelas do AWS Glue com 10 milhões de partições, ele não pode ler mais de 1 milhão de partições em uma única varredura.
Buckets do Amazon S3
Ao trabalhar com buckets do Amazon S3, lembre-se dos seguintes pontos:
-
O Amazon S3 tem uma cota de serviço padrão de 10 mil buckets por conta.
-
O Athena requer um bucket separado para registrar os resultados.
-
É possível solicitar um aumento de cota de até um milhão de buckets do Amazon S3 por conta da AWS.
Cotas de chamada de API por conta
As cotas padrão para as APIs do Athena se aplicam ao número de chamadas realizadas por conta, e não por consulta. Para obter uma lista completa das cotas padrão, consulte a tabela Service quotas no guia de Referência geral da AWS.
Se você usar qualquer uma dessas APIs e exceder a cota padrão de número de chamadas por segundo ou a capacidade de expansão da sua conta, a API do Athena emitirá um erro semelhante ao seguinte: “ClientError: Ocorreu um erro (ThrottlingException) ao chamar a operação da <nome_da_API>: taxa excedida.
” Reduza o número de chamadas por segundo ou a capacidade de intermitência da API para essa conta.
É possível alterar a cota do Athena para as chamadas de API por conta no console de Service Quotas do Athena