Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Novità dalla versione 4.0

L'`$toObjectId`operatore in Amazon DocumentDB viene utilizzato per convertire una rappresentazione in formato stringa di un tipo di dati ObjectId in un tipo di ObjectId dati effettivo. Questo può essere utile quando si lavora con dati che sono stati archiviati come rappresentazioni di stringhe di ObjectIds, in quanto consente di eseguire operazioni che richiedono il tipo di ObjectId dati.

**Parametri**
+ `expression`: Un'espressione stringa che rappresenta un valore valido ObjectId.

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

L'esempio seguente mostra come utilizzare l'`$toObjectId`operatore per convertire una rappresentazione in formato stringa di an nel ObjectId tipo di ObjectId dati.

**Crea documenti di esempio**

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

**Esempio di interrogazione**

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

**Output**

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

## Esempi di codice
<a name="toObjectId-code"></a>

Per visualizzare un esempio di codice per l'utilizzo del `$toObjectId` comando, scegliete la scheda relativa alla lingua che desiderate utilizzare:

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

------