As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Novo a partir da versão 4.0

O `$toObjectId` operador no Amazon DocumentDB é usado para converter uma representação em cadeia de caracteres de um em um ObjectId tipo de ObjectId dados real. Isso pode ser útil ao trabalhar com dados que foram armazenados como representações de seqüências de caracteres ObjectIds, pois permite realizar operações que exigem o tipo de ObjectId dados.

**Parâmetros**
+ `expression`: uma expressão em cadeia de caracteres representando um valor válido ObjectId.

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

O exemplo a seguir demonstra como usar o `$toObjectId` operador para converter uma representação em cadeia de caracteres de an ObjectId para o tipo de ObjectId dados.

**Crie documentos de amostra**

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

**Exemplo de consulta**

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

**Saída**

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

## Exemplos de código
<a name="toObjectId-code"></a>

Para ver um exemplo de código para usar o `$toObjectId` comando, escolha a guia do idioma que você deseja usar:

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

------