Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Importar e exportar dados

Você pode usar o MongoDB Compass para importar e exportar dados de e para collections. O Compass suporta importação e exportação para arquivos JSON e CSV. Para importar ou exportar dados de ou para uma collection, navegue até a exibição detalhada da collection selecionando a coleção na aba Bancos de dados ou clicando na collection na navegação do lado esquerdo.

Observação

O Compass não é uma ferramenta para fazer backup de dados. Para obter informações sobre soluções de backup, consulte Métodos de backup para uma implantação autogerenciada.

Importar Dados para uma Coleção

O MongoDB Compass pode importar dados para uma collection a partir de um arquivo JSON ou CSV.

Limitações

  • A importação de dados para uma coleção não é permitida em MongoDB Compass Readonly Edition.

Formatar Seus Dados

Antes de importar seus dados para o MongoDB Compass, você deve garantir que eles estejam formatados corretamente.

Ao importar dados de um arquivo JSON, você pode formatar seus dados como:

  • Newline-delimited documentos, or

  • Documentos separados por vírgula em uma array

Exemplo

O seguinte arquivo de .json delimitado por nova linha está formatado corretamente:

{ "type": "home", "number": "212-555-1234" }{ "type": "cell", "number": "646-555-4567" }{ "type": "office", "number": "202-555-0182"}

O seguinte arquivo de vetor separado por vírgula do .json também está formatado corretamente:

[{ "type": "home", "number": "212-555-1234" }, { "type": "cell", "number": "646-555-4567" }, { "type": "office", "number": "202-555-0182"}]

Compass ignora quebras de linha em arrays JSON.

O Compass gera automaticamente ObjectIDs para esses objetos na importação, pois nenhum ObjectIDs foi especificado no JSON inicial.

Procedimento

Para importar seus dados formatados para uma collection:

1
Conecte-se à implantação que contém a coleção para a qual você deseja importar dados.

Para saber como se conectar a um sistema, consulte Conectar Compass ao MongoDB.

2
Navegue até sua collection de destino.

Você pode selecionar a collection na aba Collections ou clicar na collection no painel do lado esquerdo.

3
Clique no menu suspenso Add Data e selecione Import JSON or CSV file.

Como alternativa, você também pode clicar com o botão direito do mouse na barra de query ou no espaço em branco ao redor e selecionar Import JSON or CSV file no menu suspenso.

4
Selecione o tipo de arquivo apropriado.

Selecione um arquivo JSON ou CSV para importar e clique em Select.

Se estiver importando um arquivo CSV, você pode especificar campos para importar e os tipos desses campos em Specify Fields and Types.

Selecione campos para importar de um arquivo CSV
clique para ampliar

Para excluir um campo de um arquivo CSV que você está importando, desmarque a caixa de seleção ao lado desse nome de campo. Para selecionar um tipo para um campo, use o menu suspenso abaixo do nome do campo.

5
Configurar opções de importação.

Em Options, configure as opções de importação para seu caso de uso.

Se você estiver importando um arquivo CSV, poderá selecionar como seus dados serão delimitados.

Para importações de arquivo JSON e CSV, você pode alternar entre Ignore empty strings e Stop on errors:

  • Se marcado, Ignore empty strings descarta campos com valores de string vazios dos documentos importados. O documento ainda é importado com todos os outros campos.

  • Se marcado, Stop on errors impede que quaisquer dados sejam importados em caso de erro. Se não estiver marcado, os dados serão inseridos até que um erro seja encontrado e as inserções bem-sucedidas não sejam revertidas. A operação de importação não continuará após encontrar um erro em ambos os casos.

6
Clique em Import.

Uma barra de progresso exibe o status da importação. Se ocorrer um erro durante a importação, a barra de progresso ficará vermelha, e uma mensagem de erro aparecerá na caixa de diálogo. Para ver todos os erros, clique em View Log.

Após a importação bem-sucedida, a caixa de diálogo é fechada e o Compass exibe a página de coleção que contém os documentos recém-importados.

Exportar Dados de uma Coleção

O MongoDB Compass pode exportar dados de uma collection como um arquivo JSON ou CSV. Se você especificar um filtro ou aggregation pipeline para a sua collection, o Compass exportará apenas documentos que correspondam à query especificada ou aos resultados do pipeline.

Comportamento

  • Evite exportar para arquivos CSV quando possível. Arquivos CSV podem perder informações de tipo e não são adequados para fazer backup de dados.

  • Você pode usar um filtro de query para exportar somente os documentos que correspondam ao filtro.

  • Você pode utilizar o campo Projeto na barra de query para especificar os campos para retornar ou exportar.

  • Ao exportar para CSV, o Compass ignora os valores de string que os aplicativos de planilha interpretam como fórmulas. Para desativar esse comportamento, expanda o menu suspenso Advanced CSV Format e desmarque Escape formulae in data.

Procedimento

Para exportar uma coleção inteira para um arquivo:

1
Conecte-se à implantação que contém a coleção da qual você deseja exportar dados.

Para saber como se conectar a um sistema, consulte Conectar Compass ao MongoDB.

2
Navegue até a coleção desejada.

Você pode selecionar a collection na aba Collections ou clicar na collection no painel do lado esquerdo.

3
Clique no menu suspenso Export Data e selecione Export the full collection.

Você também pode clicar com o botão direito do mouse na barra de query ou no espaço em branco ao redor e selecionar Export full collection... no menu suspenso.

4
Selecione seu tipo de arquivo.

Você pode selecionar JSON ou CSV. Se você selecionar JSON, você poderá expandir o menu suspenso Advanced JSON Format e selecionar a partir dos seguintes formatos JSON estendidos:

JSON Format
Descrição

JSON estendido padrão

Um formato de string que evita qualquer perda de informações do tipo BSON. Esta é a configuração padrão do Compass.

JSON estendido relaxado

Um formato de string que enfatiza a legibilidade e a interoperabilidade às custas da preservação do tipo. Ou seja, a conversão de formato relaxado para BSON pode perder informações de tipo.

AVISO: Este formato não é recomendado para integridade de dados.

JSON estendido canônico

Um formato de string que enfatiza a preservação do tipo às custas de legibilidade e interoperabilidade. Ou seja, conversão de canônico para BSON geralmente preservará informações de tipo, exceto em certos casos específicos.

Se você selecionar CSV, poderá expandir o menu suspenso Advanced CSV Format e alternar a seguinte opção:

Opção
Descrição

Escape formulae in data

Adiciona uma aspa simples inicial (') a qualquer valor de string que comece com =, +, - ou @. A fuga desses caracteres mantém os valores como texto literal.

O Compass seleciona esta opção por padrão. O MongoDB recomenda que você o mantenha selecionado para conjuntos de dados que contêm dados fornecidos pelo usuário.

5
Clique em Export.

Escolha onde exportar o arquivo e clique em Select.

Uma barra de progresso exibe o status da exportação. Se ocorrer um erro durante a exportação, a barra de progresso ficará vermelha, e uma mensagem de erro aparecerá na caixa de diálogo. Após a exportação bem-sucedida, a caixa de diálogo será fechada.

Importar e exportar dados da linha de comando

Para importar e exportar dados da linha de comando, você pode usar o Database Tools do MongoDB. Consulte mongoimport e mongoexport.

Voltar
Use a criptografia em execução
Próximo
Modelagem de dados
Avalie esta página

Nesta página