Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Nouveau depuis la version 4.0

L'`$toObjectId`opérateur dans Amazon DocumentDB est utilisé pour convertir une représentation sous forme de chaîne d'un en un type ObjectId de ObjectId données réel. Cela peut être utile lorsque vous travaillez avec des données stockées sous forme de représentations sous forme de chaînes de caractères ObjectIds, car cela vous permet d'effectuer des opérations qui nécessitent le type de ObjectId données.

**Paramètres**
+ `expression`: expression sous forme de chaîne représentant une valeur valide ObjectId.

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

L'exemple suivant montre comment utiliser l'`$toObjectId`opérateur pour convertir une représentation sous forme de chaîne de caractères ObjectId en type de ObjectId données.

**Création d'exemples de documents**

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

**Exemple de requête**

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

**Sortie**

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

## Exemples de code
<a name="toObjectId-code"></a>

Pour afficher un exemple de code d'utilisation de la `$toObjectId` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ 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()
```

------