

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# \$1in
<a name="in"></a>

Der `$in` Operator in Amazon DocumentDB ist ein logischer Abfrageoperator, mit dem Sie Dokumente finden können, bei denen der Wert eines Felds einem der in einem Array angegebenen Werte entspricht.

**Parameter**
+ `field`: Das Feld, das mit dem angegebenen Array verglichen werden soll.
+ `[value1, value2, ...]`: Ein Array von Werten, die mit dem angegebenen Feld abgeglichen werden sollen.

 

**Dollar (`$`) in Feldnamen**

Einschränkungen [Dollar (\$1) und Punkt (.) in Feldnamen](functional-differences.md#functional-differences-dollardot) bei der Abfrage von Feldern mit `$` Präfix `$in` in verschachtelten Objekten finden Sie unter.

## Beispiel (MongoDB Shell)
<a name="in-examples"></a>

Das folgende Beispiel zeigt, wie der `$in` Operator verwendet wird, um Dokumente zu finden, bei denen das `color` Feld einer der Werte im bereitgestellten Array ist.

**Erstellen Sie Beispieldokumente**

```
db.colors.insertMany([
  { "_id": 1, "color": "red" },
  { "_id": 2, "color": "green" },
  { "_id": 3, "color": "blue" },
  { "_id": 4, "color": "yellow" },
  { "_id": 5, "color": "purple" }
])
```

**Beispiel für eine Abfrage**

```
db.colors.find({ "color": { "$in": ["red", "blue", "purple"] } })
```

**Ausgabe**

```
{ "_id": 1, "color": "red" },
{ "_id": 3, "color": "blue" },
{ "_id": 5, "color": "purple" }
```

## Codebeispiele
<a name="in-code"></a>

Um ein Codebeispiel für die Verwendung des `$in` Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function findByIn() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('colors');

  const result = await collection.find({ "color": { "$in": ["red", "blue", "purple"] } }).toArray();
  console.log(result);

  await client.close();
}

findByIn();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def find_by_in():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client.test
    collection = db.colors

    result = list(collection.find({ "color": { "$in": ["red", "blue", "purple"] } }))
    print(result)

    client.close()

find_by_in()
```

------