Definição
Return Values
Um mapa de IDs (ou seja, _id valores de campo) para documentos que foram atualizados por todas as operações de atualização e substituição na gravação em massa.
O índice de cada ID no mapa corresponde à posição de cada documento na operação em massa. Se um documento tivesse um ID antes do upsering (ou seja, o servidor não gerou um ID), o índice conterá seu valor de campo _id. Qualquer ID gerado pelo servidor será uma instância MongoDB\BSON\ObjectId.
Erros/exceções
MongoDB\Exception\BadMethodCallException se esse método for chamado e a operação de gravação usar uma write concern não reconhecida.