Esta seção descreve restrições atuais, antes chamadas de limites, no Amazon DynamoDB.
Tópicos
Modo de capacidade de leitura/gravação
É possível alternar as tabelas do modo sob demanda para o modo de capacidade provisionada a qualquer momento. Ao alternar várias vezes entre os modos de capacidade, as seguintes condições se aplicam:
-
É possível alternar uma tabela recém-criada no modo sob demanda para o modo de capacidade provisionada a qualquer momento. No entanto, só é possível voltar ao modo sob demanda 24 horas após o carimbo de data e hora de criação da tabela.
-
É possível alternar uma tabela existente no modo sob demanda para o modo de capacidade provisionada a qualquer momento. No entanto, você só pode voltar ao modo sob demanda 24 horas após o último carimbo de data e hora indicando uma mudança para o modo sob demanda.
Para ter mais informações sobre como alternar entre os modos de capacidade de leitura e de gravação, consulte Considerações ao alternar os modos de capacidade no DynamoDB.
Tamanhos de unidade de capacidade (para tabelas provisionadas)
Uma unidade de capacidade de leitura = uma leitura altamente consistente por segundo, ou duas leituras finais consistentes por segundo, para itens até 4 KB de tamanho.
Uma unidade de capacidade de gravação = uma gravação por segundo para itens de até 1 KB de tamanho.
As solicitações de leitura transacional exigem duas unidades de capacidade de leitura para executar uma leitura por segundo para itens de até 4 KB.
As solicitações de gravação transacional exigem duas unidades de capacidade de gravação para executar uma gravação por segundo para itens de até 1 KB.
Tamanhos de unidade de solicitação (para tabelas sob demanda)
Uma unidade de solicitação de leitura = uma leitura altamente consistente por segundo, ou duas leituras finais consistentes por segundo, para itens até 4 KB de tamanho.
Uma unidade de solicitação de gravação = uma gravação por segundo para itens com até 1 KB de tamanho.
As solicitações de leitura transacionais exigem duas unidades de solicitação de leitura para executar uma leitura por segundo para itens de até 4 KB.
As solicitações de gravação transacionais exigem duas unidades de solicitação de gravação para executar uma gravação por segundo para itens de até 1 KB.
Índices secundários
Atributos do índice secundário projetados por tabela
Você pode projetar um total de até 100 atributos em todos os índices secundários locais e globais de uma tabela. Isso se aplica somente a atributos projetados especificados pelo usuário.
Em uma operação CreateTable, se você especificar um ProjectionType de INCLUDE, a contagem total de atributos especificados emNonKeyAttributes, somados entre todos os índices secundários, não deve exceder 100. Se você projetar o mesmo nome de atributo em dois índices diferentes, isso conta como dois atributos distintos ao determinar o total.
Esse limite não se aplica a índices secundários com ProjectionType de KEYS_ONLY ou ALL.
Chaves de partição e chaves de classificação
Tamanho da chave de partição
O tamanho mínimo de um valor de chave de partição é 1 byte. O comprimento máximo é de 2048 bytes.
Valores de chave de partição
Não há um limite prático para o número de valores de chave de partição distintos, para tabelas ou para índices secundários.
Tamanho da chave de classificação
O tamanho mínimo de um valor de chave de classificação é 1 byte. O comprimento máximo é de 1024 bytes.
Valores de chave de classificação
Em geral, não há limite prático para o número de valores de chave de classificação distintos por valor de chave de partição.
Há exceção para tabelas com índices secundários. Coleção de itens é o conjunto de itens que têm o mesmo valor do atributo de chave de partição. Em um índice secundário global, a coleção de itens é independente da tabela-base (e pode ter um atributo de chave de partição diferente). Entretanto, em um índice secundário local, a exibição indexada é colocada na mesma partição do item na tabela e compartilha o mesmo atributo de chave de partição. Em decorrência dessa localidade, quando uma tabela tem um ou mais LSIs, a coleção de itens não pode ser distribuída por várias partições.
Para uma tabela com um ou mais LSIs, as coleções de itens não podem exceder 10 GB de tamanho. Inclui todos os itens da tabela de base e todas as visualizações de LSI projetadas que têm o mesmo valor do atributo de chave de partição. O tamanho máximo de uma partição é 10 GB. Para obter mais informações detalhadas, consulte Limite de tamanho de conjunto de itens.
Regras de nomenclatura
Nomes de tabela e nomes de índices secundários
Nomes de tabelas e índices secundários devem ter pelo menos 3 caracteres, mas não podem ser maiores do que 255 caracteres. Veja a seguir os caracteres permitidos:
-
A-Z -
a-z -
0-9 -
_(sublinhado) -
-(hífen) -
.(ponto)
Nomes de atributo
Em geral, um nome de atributo deve ter pelo menos 64 caracteres, mas não pode ser maior do que 64 KB.
Veja as exceções a seguir. Estes nomes de atributo não devem ser maiores do que 255 caracteres:
-
Nomes de chaves de partição de índices secundários.
-
Nomes de chaves de classificação de índices secundários.
-
Os nomes de atributos projetados especificados pelo usuário (aplicável apenas a índices secundários locais). Em uma operação
CreateTable, se você especificar umProjectionTypecomoINCLUDE, os nomes dos atributos no parâmetroNonKeyAttributesterão tamanho restrito. Os tipos de projeçãoKEYS_ONLYeALLnão são afetados.
Esses nomes de atributos devem ser codificados usando UTF-8 e o tamanho total de cada nome (após a codificação) não pode exceder 255 bytes.
Tipos de dados
String
O tamanho de uma string é restrito pelo tamanho de item máximo de 400 KB.
Strings são Unicode com codificação binária UTF-8. Como a codificação UTF-8 tem largura variável, o DynamoDB determina o tamanho de uma string usando seus bytes UTF-8.
Número
Um número pode ter até 38 dígitos de precisão, e pode ser positivo, negativo ou zero.
-
Intervalo positivo:
1E-130a9.9999999999999999999999999999999999999E+125 -
Intervalo negativo:
-9.9999999999999999999999999999999999999E+125a-1E-130
O DynamoDB usa strings JSON para representar dados de números em solicitações e respostas. Para ter mais informações, consulte API de baixo nível do DynamoDB.
Se a precisão de número for importante, você deverá passar os números para o DynamoDB usando strings convertidas por você de um tipo de número.
Binário
O tamanho de um binário é restrito pelo tamanho de item máximo de 400 KB.
As aplicações que funcionam com atributos binários devem codificar os dados em formato base64 antes de enviá-los para o DynamoDB. Após o recebimento dos dados, o DynamoDB os decodifica em uma matriz de bytes não assinados e usa esse resultado como o tamanho do atributo.
Itens
Tamanho de item
O tamanho de item máximo no DynamoDB é 400 KB, o que inclui o tamanho binário do nome do atributo (tamanho UTF-8) e os tamanhos dos valores dos atributos (novamente, tamanho binário). O nome do atributo conta para o limite de tamanho.
Por exemplo, considere um item com dois atributos: um atributo chamado “cor-camisa” com o valor “R” e outro atributo chamado “tamanho-camisa” com o valor “M”. O tamanho total desse item é 23 bytes.
Tamanho de item para tabelas com índices secundários locais
Para cada índice secundário local em uma tabela, existe um limite de 400 KB no total do seguinte:
-
O tamanho dos dados de um item na tabela.
-
O tamanho das entradas correspondentes (inclusive os valores de chaves e atributos projetados) em todos os índices secundários locais.
Atributos
Pares de nome-valor de atributo por item
O tamanho cumulativo de atributos por item deve se adequar ao tamanho máximo de item do DynamoDB (400 KB).
Número de valores em lista, mapa ou conjunto
Não há limite para o número de valores em uma lista, um mapa ou um conjunto, desde que o item que contém os valores permaneça no limite de tamanho de item de 400 KB.
Valores de atributo
Valores de atributos binários e de string vazios serão permitidos se o atributo não for usado como um atributo de chave para uma tabela ou um índice. Valores binários e de string vazios são permitidos dentro dos tipos de conjunto, lista e mapa. Um valor de atributo não pode ser um conjunto vazio (conjunto de strings, conjunto de número ou conjunto binário). Entretanto, Lists e Maps vazios são permitidos.
Profundidade de atributo aninhado
O DynamoDB oferece suporte a atributos aninhados com até 32 níveis de profundidade.
Parâmetros de expressão
Os parâmetros de expressão incluem ProjectionExpression, ConditionExpression, UpdateExpression e FilterExpression.
Tamanhos
O tamanho máximo de qualquer string de expressão é 4 KB. Por exemplo, o tamanho de ConditionExpression a=b é 3 bytes.
O tamanho máximo de qualquer nome de atributo de expressão única ou valor de atributo de expressão é 255 bytes. Por exemplo, #name é 5 bytes; :val é 4 bytes.
O tamanho máximo de todas as variáveis de substituição em uma expressão é 2 MB. Esta é a soma dos tamanhos de todos os ExpressionAttributeNames e ExpressionAttributeValues.
Operadores e operandos
O número máximo de operadores ou funções permitidos em uma UpdateExpression é 300. Por exemplo, a UpdateExpression SET a = :val1 + :val2 + :val3 contém dois operadores “+“.
O número máximo de operandos do comprador IN é 100.
Palavras reservadas
O DynamoDB não impede uso de nomes conflitantes com palavras reservadas. (Para obter uma lista completa, consulte Palavras reservadas no DynamoDB.)
No entanto, caso use uma palavra reservada em um parâmetro de expressão, você também deverá especificar ExpressionAttributeNames. Para ter mais informações, consulte Nomes (aliases) de atributo de expressão no DynamoDB.
Transações do DynamoDB
As operações de API transacionais do DynamoDB têm as seguintes restrições:
-
Uma transação não pode conter mais de 100 itens únicos.
-
Uma transação não pode conter mais de 4 MB de dados.
-
Duas ações em uma transação não podem funcionar contra o mesmo item na mesma tabela. Por exemplo, você não pode usar
ConditionCheckeUpdateno mesmo item em uma transação. -
Uma transação não pode operar nas tabelas em mais de uma conta ou região da AWS.
-
As operações transacionais fornecem garantia de atomicidade, consistência, isolamento e durabilidade (ACID) somente na região da AWS em que a gravação é originalmente realizada. As transações não são compatíveis entre regiões em tabelas globais. Por exemplo, suponha que você tenha uma tabela global com réplicas nas regiões Leste dos EUA (Ohio) e Oeste dos EUA (Oregon) e execute uma operação
TransactWriteItemsna região Leste dos EUA (Norte da Virgínia). Nesse caso, você pode observar transações parcialmente concluídas na região Oeste dos EUA (Oregon) conforme as alterações são replicadas. As alterações só são replicadas para outras regiões quando forem confirmadas na região de origem.
DynamoDB Streams
Leitores simultâneos de um fragmento no DynamoDB Streams
Para tabelas de região única que não são tabelas globais, você pode projetar até dois processos ao mesmo tempo para ler o mesmo fragmento do DynamoDB Streams. Exceder esse limite pode resultar em controle de utilização de solicitação. Quanto a tabelas globais, recomendamos que você limite o número de leitores simultâneos a 1 para evitar o controle de utilização de solicitações.
DynamoDB Accelerator (DAX)
Disponibilidade de regiões do AWS
Para obter uma lista de regiões da AWS em que o DAX está disponível, consulte DynamoDB Accelerator (DAX) na Referência geral da AWS.
Nós
Um cluster do DAX consiste em exatamente um nó primário e entre zero e dez nós de réplica de leitura.
O número total de nós (por conta da AWS) não pode exceder 50 em uma única região da AWS.
Grupos de parâmetros
Você pode criar até 20 grupos de parâmetros do DAX por região.
Grupos de sub-redes
Você pode criar até 50 grupos de sub-redes do DAX por região.
Em um grupo de sub-redes, você pode definir até 20 sub-redes.
Importante
Um cluster do DAX comporta no máximo quinhentas tabelas do DynamoDB. Ao ultrapassar quinhentas tabelas do DynamoDB, o cluster poderá sofrer degradação na disponibilidade e na performance.
Restrições específicas da API
CreateTable/UpdateTable/DeleteTable/PutResourcePolicy/DeleteResourcePolicy-
Em geral, é possível ter até quinhentas solicitações CreateTable, UpdateTable, DeleteTable, PutResourcePolicy e DeleteResourcePolicy sendo executadas simultaneamente em qualquer combinação. Por esse motivo, o número total de tabelas no estado
CREATING,UPDATINGouDELETINGnão pode exceder 500.É possível enviar até 2.500 solicitações por segundo de solicitações mutáveis (
CreateTable,DeleteTable,UpdateTable,PutResourcePolicyeDeleteResourcePolicy) da API do ambiente de gerenciamento em um grupos de tabelas. No entanto, as solicitaçõesPutResourcePolicyeDeleteResourcePolicytêm limites individuais mais baixos. Para ter mais informações, consulte os detalhes de cotas a seguir paraPutResourcePolicyeDeleteResourcePolicy.As solicitações
CreateTableePutResourcePolicyque incluam uma política baseada em recursos contarão como duas solicitações adicionais para cada KB da política. Por exemplo, uma solicitaçãoCreateTableouPutResourcePolicycom uma política de tamanho 5 KB contará como 11 solicitações. Uma para a solicitaçãoCreateTablee 10 para a política baseada em recursos (2 x 5 KB). Da mesma forma, uma política com 20 KB de tamanho contará como 41 solicitações. Uma para a solicitaçãoCreateTablee quarenta para a política baseada em recursos (2 x 20 KB).PutResourcePolicy-
É possível enviar até 25 solicitações de API
PutResourcePolicypor segundo em um grupo de tabelas. Depois de uma solicitação bem-sucedida de uma tabela individual, nenhuma nova solicitaçãoPutResourcePolicyé aceita nos 15 segundos seguintes.O tamanho máximo aceito para um documento de política baseado em recursos é de 20 KB. O DynamoDB conta espaços em branco ao calcular o tamanho de uma política em relação a esse limite.
DeleteResourcePolicy-
É possível enviar até cinquenta solicitações de API
DeleteResourcePolicypor segundo em um grupo de tabelas. Depois de uma solicitaçãoPutResourcePolicybem-sucedida de uma tabela individual, nenhuma nova solicitaçãoDeleteResourcePolicyé aceita nos 15 segundos seguintes.
BatchGetItem-
Uma única operação
BatchGetItempode recuperar no máximo 100 itens. O tamanho total de todos os itens recuperados não pode exceder 16 MB.
BatchWriteItem-
Uma única operação
BatchWriteItempode conter até 25 solicitaçõesPutItemouDeleteItem. O tamanho total de todos os itens gravados não pode exceder 16 MB.
DescribeStream-
É possível chamar
DescribeStreamcom uma taxa máxima de dez vezes por segundo.
DescribeTableReplicaAutoScaling-
O método
DescribeTableReplicaAutoScalingoferece suporte a apenas 10 solicitações por segundo.
DescribeLimits-
DescribeLimitsdeve ser chamado apenas periodicamente. Você pode esperar erros de controle de utilização se chamá-lo mais de uma vez em um minuto.
DescribeContributorInsights/ListContributorInsights/UpdateContributorInsights-
DescribeContributorInsights,ListContributorInsightseUpdateContributorInsightsdevem ser chamados apenas periodicamente. O DynamoDB oferece suporte a cinco solicitações por segundo para cada uma dessas APIs.
DescribeTable/ListTables/GetResourcePolicy-
É possível enviar até 2.500 solicitações por segundo de uma combinação de solicitações de API do ambiente de gerenciamento (
DescribeTable,ListTableseGetResourcePolicy) somente leitura. A APIGetResourcePolicytem um limite individual inferior de cem solicitações por segundo.
Query-
O conjunto de resultados de uma
Queryé limitado a 1 MB por chamada. Você pode usar aLastEvaluatedKeyda resposta da consulta para recuperar mais resultados.
Scan-
O conjunto de resultados de uma
Scané limitado a 1 MB por chamada. Você pode usar aLastEvaluatedKeyda resposta da verificação para recuperar mais resultados.
UpdateKinesisStreamingDestination-
Ao realizar operações
UpdateKinesisStreamingDestination, é possível definirApproximateCreationDateTimePrecisioncomo um novo valor no máximo 3 vezes em um período de 24 horas.
UpdateTableReplicaAutoScaling-
O método
UpdateTableReplicaAutoScalingoferece suporte a apenas dez solicitações por segundo.
UpdateTableTimeToLive-
O método
UpdateTableTimeToLiveé compatível apenas com uma solicitação para habilitar ou desabilitarTime to Live (TTL)por tabela especificada por hora. O processamento completo dessa alteração pode levar até uma hora. Todas as chamadasUpdateTimeToLiveadicionais para a mesma tabela durante esse período de uma hora geram uma ValidationException.
Criptografia em repouso do DynamoDB
É possível alternar entre uma Chave pertencente à AWS, uma Chave gerenciada pela AWS e uma chave gerenciada pelo cliente até quatro vezes e a qualquer momento durante um período de 24 horas, por tabela, a partir do momento da criação da tabela. Se não houve mudança nas últimas seis horas, uma alteração adicional será permitida. Isso leva o número máximo de alterações em um dia para oito vezes (quatro alterações nas primeiras seis horas e uma alteração para cada uma das janelas de seis horas subsequentes em um dia).
É possível alternar as chaves de criptografia para usar uma Chave pertencente à AWS tantas vezes quanto necessário, mesmo que a cota acima tenha sido esgotada.
Estas são as cotas, a menos que você solicite uma quantidade maior. Para solicitar um aumento da cota de serviço, consulte https://aws.amazon.com/support
