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.

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

Neu ab Version 4.0

Der `$toObjectId` Operator in Amazon DocumentDB wird verwendet, um eine Zeichenkettendarstellung eines in einen tatsächlichen ObjectId Datentyp ObjectId zu konvertieren. Dies kann nützlich sein, wenn Sie mit Daten arbeiten, die als Zeichenkettendarstellungen von gespeichert wurden ObjectIds, da Sie damit Operationen ausführen können, für die der ObjectId Datentyp erforderlich ist.

**Parameter**
+ `expression`: Ein Zeichenkettenausdruck, der einen gültigen Wert darstellt ObjectId.

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

Das folgende Beispiel zeigt, wie der `$toObjectId` Operator verwendet wird, um eine Zeichenkettendarstellung von an in den ObjectId Datentyp ObjectId zu konvertieren.

**Erstellen Sie Beispieldokumente**

```
db.employees.insertMany([
  { _id: 1, empId:"64e5f8886218c620cf0e8f8a", name: "Carol Smith", employeeId: "c720a" },
  { _id: 2, empId:"64e5f94e6218c620cf0e8f8c", name: "Bill Taylor", employeeId: "c721a" }
]);
```

**Beispiel für eine Abfrage**

```
db.employees.aggregate([
  { $project: {
    "empIdAsObjectId": {$toObjectId: "$empId"}}
  }
]);
```

**Ausgabe**

```
[
  { _id: 1, empIdAsObjectId: ObjectId('64e5f8886218c620cf0e8f8a') },
  { _id: 2, empIdAsObjectId: ObjectId('64e5f94e6218c620cf0e8f8c') }
]
```

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

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

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

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

async function example() {
  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('employees');

  const result = await collection.aggregate([
    { $project: {
      "empIdAsObjectId": {$toObjectId: "$empId"}}
    }
  ]).toArray();

  console.log(result);
  client.close();
}

example();
```

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

```
from pymongo import MongoClient

def example():
    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['employees']

    result = list(collection.aggregate([
      { "$project": {
        "empIdAsObjectId": {"$toObjectId": "$empId"}}
      }
    ]))

    print(result)
    client.close()

example()
```

------