Insira documentos

Dados de amostra

Os exemplos neste guia usam a collection sample_restaurants.restaurants dos conjuntos de dados de amostra do Atlas. Para saber como criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o tutorial Introdução ao PyMongo .

Exemplo

O código a seguir usa o método insert_many() para inserir três novos documentos em uma coleção. Como o segundo argumento do método é bypass_document_validation = True, essa operação de inserção ignora a validação em nível de documento.

document_list = [
    { "name" : "Mongo's Burgers" },
    { "name" : "Mongo's Pizza" },
    { "name" : "Mongo's Tacos" }
 ]
 sample_restaurants.restaurants.insert_many(document_list, bypass_document_validation = True)

Anotações do tipo de cliente

Se você não adicionar uma anotação de tipo para seu objeto MongoClient, seu verificador de tipo poderá mostrar um erro semelhante ao seguinte:

from pymongo import MongoClient
client = MongoClient()  # error: Need type annotation for "client"

A solução é anotar o objeto MongoClient como client: MongoClient ou client: MongoClient[Dict[str, Any]].

Tipo incompatível

Se você especificar MongoClient como uma dica de tipo, mas não incluir tipos de dados para o documento, as chaves e os valores, seu verificador de tipo poderá mostrar um erro semelhante ao seguinte:

error: Dict entry 0 has incompatible type "str": "int";
expected "Mapping[str, Any]": "int"

A solução é adicionar a seguinte dica de tipo ao seu objeto MongoClient :

``client: MongoClient[Dict[str, Any]]``

TypedDict chave _id ausente

Se você não especificar o campo _id, o PyMongo o inserirá automaticamente no documento. Você pode recuperar o valor do campo _id no tempo de execução, mas se usar o MySQL ou outra ferramenta para realizar a verificação estática do tipo, ela não encontrará o campo _id em sua classe e mostrará um erro semelhante ao seguinte:

TypedDict has no key "_id"

Isso é causado por código semelhante ao seguinte:

from typing import TypedDict
from pymongo import MongoClient
from pymongo.collection import Collection
class Movie(TypedDict):
    name: str
    year: int
client: MongoClient = MongoClient()
collection: Collection[Movie] = client.test.test
inserted = collection.insert_one(Movie(name="Jurassic Park", year=1993))
result = collection.find_one({"name": "Jurassic Park"})
# _id is present but was added by PyMongo; this will raise a type-checking error
assert result["_id"]

Uma solução é adicionar um comentário # type:ignore ao final da linha que usa o campo _id. Este comentário instrui a ferramenta de verificação de tipo a ignorar quaisquer erros que a linha cause. O exemplo a seguir mostra como implementar esta solução;

from typing import TypedDict
from pymongo import MongoClient
from pymongo.collection import Collection
class Movie(TypedDict):
    name: str
    year: int
collection: Collection[Movie] = client.test.test
inserted = collection.insert_one(
    Movie(name="Jurassic Park", year=1993)
)
result = collection.find_one({"name": "Jurassic Park"})
assert result is not None
assert result["_id"] # type:ignore[typeddict-item]

Em vez de ignorar o erro de tipo, você pode evitá-lo incluindo o campo _id na classe de modelo e especificando explicitamente um valor para esse campo ao criar a instância de classe . O seguinte código mostra como implementar esta solução:

from typing import TypedDict
from pymongo import MongoClient
from pymongo.collection import Collection
from bson import ObjectId
class Movie(TypedDict):
    _id: ObjectId
    name: str
    year: int
collection: Collection[ExplicitMovie] = client.test.test
inserted = collection.insert_one(
    ExplicitMovie(_id=ObjectId(), name="Jurassic Park", year=1993)
)
result = collection.find_one({"name": "Jurassic Park"})
assert result is not None
assert result["_id"]

Uma desvantagem de adicionar o campo _id à sua classe personalizada é que você deve incluir um valor para o campo para cada instância da classe que criar. Para evitar isso, você pode instalar o pacote typing.NotRequired , que inclui a dica de tipo NotRequired . Se você usar essa dica de tipo para o campo _id , poderá acessar o valor do campo _id no tempo de execução sem ver nenhum erro de tipo em tempo de compilação.

O seguinte exemplo de código mostra como implementar esta solução:

from typing import TypedDict, NotRequired
from pymongo import MongoClient
from pymongo.collection import Collection
from bson import ObjectId
class Movie(TypedDict):
     _id: NotRequired[ObjectId]
    name: str
    year: int
client: MongoClient = MongoClient()
collection: Collection[Movie] = client.test.test
inserted = collection.insert_one(Movie(name="Jurassic Park", year=1993))
result = collection.find_one({"name": "Jurassic Park"})
assert result is not None
assert result["_id"]

Documentação da API

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

• insert_one()

• insert_many()

• ClientSession