Service Quotas - Amazon Athena

Service Quotas

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 para aquelas que são ajustáveis. Para obter as limitações de esquema relacionadas ao AWS Glue, consulte a página Endpoints e cotas do AWS Glue. Para obter informações gerais sobre cotas de serviço da AWS, consulte Cotas de serviço da AWS na Referência geral da AWS.

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 e ALTER 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) e INSERT 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.

Uma cota de consulta DML ou DDL inclui consultas tanto em execução quanto enfileiradas. Por exemplo, se sua conta de consultas DML for 25 e seu total de consultas em execução e em fila for 26, a consulta 26 resultará em 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 Como 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? (em inglês) na Central de Conhecimento da AWS.

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 100 buckets por conta.

  • O Athena requer um bucket separado para registrar os resultados.

  • Você pode solicitar um aumento da cota de até 1.000 buckets do Amazon S3 por conta da AWS.

Cotas de chamada de API por conta

As APIs do Athena têm as seguintes cotas padrão para o número de chamadas à API por conta (não por consulta):

Nome da API Número padrão de chamadas por segundo Capacidade de expansão
BatchGetNamedQuery, ListNamedQueries, ListQueryExecutions 5 até 10
CreateNamedQuery, DeleteNamedQuery, GetNamedQuery 5 até 20
BatchGetQueryExecution 20 até 40
StartQueryExecution, StopQueryExecution 20 até 80
GetQueryExecution, GetQueryResults 100 até 200

Por exemplo, para StartQueryExecution, é possível fazer até 20 chamadas por segundo. Além disso, se essa API não for chamada por 4 segundos, sua conta acumulará uma capacidade de intermitência de até 80 chamadas. Nesse caso, o aplicativo pode fazer até 80 chamadas para essa API no modo de intermitência.

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.

A cota do Athena para chamadas de API por conta não pode ser alterada no console Service Quotas do Athena. Para solicitar um aumento de cota para chamadas da API Athena, navegue até a página deAWS Support aumento do limite de serviço, preencha e envie o formulário.