Filtragem de uma exportação de tabela

Em vez de exportar uma tabela inteira, você pode exportar somente os itens e atributos necessários. O DynamoDB exporta somente os dados que correspondem às expressões que você fornece. A exportação filtrada funciona tanto com exportações completas quanto com exportações incrementais.

Para uma exportação incremental, o DynamoDB avalia o filtro em relação à imagem mais recente de cada item alterado. Para um item excluído, o DynamoDB avalia o filtro em relação à imagem antiga do item, porque a nova imagem não existe.

Você controla o que uma exportação filtrada retorna com três tipos de expressões. Você pode fornecer um deles ou combiná-los em uma única solicitação de exportação:

• Uma expressão de condição de chave seleciona itens por chave primária, usando a mesma sintaxe e as mesmas regras de uma expressão de condição de chave Query do DynamoDB. Uma expressão de condição de chave especifica um único valor de chave de partição com uma comparação de igualdade e uma condição opcional na chave de classificação. Ela não pode referenciar atributos que não sejam de chave e não pode especificar mais de um valor de chave de partição. Como uma expressão de condição de chave limita a exportação a um único valor de chave de partição, ela reduz a quantidade de dados que o DynamoDB lê para a exportação. Para obter mais informações, consulte Principais expressões de condição para a operação de consulta no DynamoDB.

• Uma expressão de filtro pode aplicar condições a atributos de chave e não de chave, usando a mesma sintaxe e as mesmas regras de uma expressão de filtro em uma operação Scan. As expressões de filtro oferecem suporte a comparações como igualdade, diferença e OR, junto com as funções contains, IN, begins_with, BETWEEN, attribute_exists e size. O DynamoDB aplica uma expressão de filtro depois de ler os dados, para que o filtro não reduza a quantidade de dados que o DynamoDB processa para a exportação. Para obter mais informações sobre expressões de filtro e sintaxe, consulte Sintaxe para expressões de filtro e de condição.

• Uma expressão de projeção identifica os atributos específicos que você deseja na saída de exportação, usando a mesma sintaxe e as mesmas regras de uma expressão de projeção em outras operações do DynamoDB. Para obter mais informações, consulte Usar expressões de projeção no DynamoDB.

nota

A possibilidade de um atributo de chave aparecer na expressão de filtro depende de você também fornecer uma expressão de condição de chave. Se você fornecer uma expressão de condição de chave, o atributo de chave também não poderá aparecer na expressão de filtro. Se você fornecer somente uma expressão de filtro, os atributos de chave poderão aparecer na expressão de filtro.

Cada expressão está sujeita aos limites a seguir:

• Uma expressão pode ter até 4 MB.

• Os nomes dos atributos podem ter até 250 bytes.

• Os valores de atributo podem ter até 2 MB.

• Uma expressão pode conter no máximo 300 operadores.