# Usar a função CONTAINS com PartiQL para DynamoDB
<a name="ql-functions.contains"></a>

Retorna `TRUE` quando o atributo especificado pelo caminho é um dos seguintes:
+ Uma String que contém uma substring específica. 
+ Um Set que contém um elemento específico dentro do conjunto.

Para obter mais informações, consulte a função [contains](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions) do DynamoDB. 

## Sintaxe
<a name="ql-functions.contains.syntax"></a>

```
contains( {{path}}, {{substring}} )
```

## Argumentos
<a name="ql-functions.contains.arguments"></a>

{{path}}  
(Obrigatório) O nome do atributo ou o caminho do documento a ser usado.

{{substring}}  
(Obrigatório) A substring do atributo ou o membro do conjunto a ser verificado. Para obter mais informações, consulte a função [contains](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions) do DynamoDB.

## Tipo de retorno
<a name="ql-functions.contains.return-type"></a>

`bool`

## Exemplos
<a name="ql-functions.contains.examples"></a>

```
SELECT * FROM "Orders" WHERE "OrderID"=1 AND contains("Address", 'Kirkland')
```