

# Filtragem de uma exportação de tabela
<a name="S3DataExport.Filtered"></a>

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](Query.KeyConditionExpressions.md).
+ 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](Expressions.OperatorsAndFunctions.md#Expressions.OperatorsAndFunctions.Syntax).
+ 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](Expressions.ProjectionExpressions.md).

**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.