Importar um arquivo JSON para o MongoDB com mongoimport

Ao usar o MongoDB, você pode usar mongoimport para importar documentos para uma coleção. mongoimport é um utilitário de linha de comando que importa conteúdo de um arquivo JSON, CSV ou TSV estendido. O arquivo de importação pode ter sido criado por mongoexport ou algum outro utilitário de exportação.

Este artigo apresenta exemplos de importação de um arquivo JSON para o MongoDB.

Exemplo

Suponha que temos o seguinte arquivo JSON chamado pets.json :

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

O comando a seguir importa o arquivo JSON para o MongoDB:

mongoimport --db=PetHotel --file=pets.json

Nesse caso, não especifiquei uma coleção para importar, então criei uma coleção com o mesmo nome do arquivo (pets ).

Verifique os resultados

Vamos dar uma olhada na coleção.

db.pets.find()

Resultado:

{ "_id" : 1, "name" : "Wag", "type" : "Dog" }
{ "_id" : 2, "name" : "Bark", "type" : "Dog" }
{ "_id" : 3, "name" : "Meow", "type" : "Cat" }

Podemos ver que os documentos foram importados conforme o esperado.

Especifique o nome da coleção

Você pode usar o --collection (ou -c ) para especificar uma coleção para a qual importar o arquivo.

Aqui está um exemplo de como usar o --collection parâmetro para importar o mesmo arquivo para uma coleção diferente:

mongoimport --db=PetHotel --collection=pets2 --file=pets.json

Se a coleção ainda não existir, ela será criada. Se já existir, o resultado da importação dependerá do modo que você está usando (mais sobre isso abaixo).

Solte a coleção antes de importar

Você pode usar o --drop parâmetro para descartar qualquer coleção existente com o mesmo nome que você está tentando criar/importar.

Imagine que temos um segundo arquivo, chamado pets2.json , com o seguinte documento:

{ "_id" : 4, "name" : "Bubbles" }
{ "_id" : 5, "name" : "Hop", "type": "Kangaroo" }

Veja o que acontece se eu importar esse documento para os pets coleção usando o --drop opção:

mongoimport --db=PetHotel --collection=pets --drop --file=pets2.json

Saída:

2021-01-03T15:42:25.626+1000	connected to: mongodb://localhost/
2021-01-03T15:42:25.640+1000	dropping: PetHotel.pets
2021-01-03T15:42:25.734+1000	2 document(s) imported successfully. 0 document(s) failed to import.

A mensagem nos informa que a coleção foi descartada e um documento foi importado.

Vamos dar uma olhada na coleção:

db.pets.find()

Resultado:

{ "_id" : 5, "name" : "Hop", "type" : "Kangaroo" }
{ "_id" : 4, "name" : "Bubbles" }

Como esperado, nossos dois novos documentos são os únicos da coleção.

Modos de importação

Existem vários modos de importação que você pode usar com mongoimport . Esses modos determinam o que acontece se já houver documentos correspondentes na coleção para a qual você está tentando importar.

Os modos são os seguintes:

Modo	Descrição
`insert`	Este é o modo padrão. Este modo insere os documentos do arquivo de importação. Se já existir um documento correspondente na coleção, ocorrerá um erro. Um documento correspondente é aquele que tem o mesmo ID exclusivo (como um `_id` correspondente field) como um documento no arquivo de importação.
`upsert`	Substitui os documentos existentes no banco de dados pelos documentos correspondentes do arquivo de importação. Todos os outros documentos são inseridos.
`merge`	Mescla documentos existentes que correspondem a um documento no arquivo de importação com o novo documento. Todos os outros documentos são inseridos.
`delete`	Exclui documentos existentes no banco de dados que correspondem a um documento no arquivo de importação. Quaisquer documentos não correspondentes não têm efeito.

Veja os modos de importação de mongoimport para exemplos de cada modo.

Verifique se há `mongoimport`

mongoimport faz parte do pacote MongoDB Database Tools. As ferramentas de banco de dados do MongoDB são um conjunto de utilitários de linha de comando para trabalhar com o MongoDB.

Se você não tem certeza se possui o MongoDB Database Tools/mongoimport instalado, tente executar o seguinte comando em seu Terminal ou Prompt de Comando para verificar:

mongoimport --version

Se você o tiver, deverá ver as informações da versão, etc. Se não o tiver, poderá usar as instruções de instalação no site do MongoDB para instalá-lo em seu sistema.

Onde executar os comandos?

Não se esqueça, você precisa executar mongoimport comandos da linha de comando do seu sistema (por exemplo, um novo Terminal ou janela de prompt de comando).

Não os execute a partir do mongo Concha.