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á.

# $ para ObjectId
<a name="toObjectId"></a>

Novo 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 de string representando um 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()
```

------