Criar, Exibir, Atualizar e Excluir Documentos
Nesta página
Você pode utilizar a interface do usuário do Atlas para gerenciar documentos dentro de suas coletas. Documentos são registros individuais em uma coleta MongoDB e são a unidade básica de dados no MongoDB.
A visualização de documentos e coletas na interface do usuário do Atlas pode fornecer uma visão geral de alto nível do esquema do seu banco de dados. Você pode usar a UI Atlas para garantir que você esteja seguindo os principais conceitos de modelagem de dados do MongoDB, como a utilização de documentos e arrays incorporados.
Dica
Veja também:
Funções obrigatórias
Para inserir, editar ou excluir documentos, você deve ter acesso a uma das seguintes funções:
Insira documentos
Para adicionar um ou mais documentos a uma coleta por meio do Interface do usuário do Atlas, você pode especificar os documentos a serem inseridos do zero ou você pode clonar um documento existente e modificar seus campos e valores conforme necessário.
Inserir um documento
Vá para a aba Find na IU do Atlas.
Selecione a coleção e vá para a guia Find.
Modifique o documento.
Para adicionar um novo campo após um campo existente, passe o mouse sobre o campo e clique no sinal de "mais" que aparece sobre o número de linha do campo.
Para excluir um campo, paire sobre o campo e clique no sinal x que aparece à esquerda do número da linha do campo. Você não pode excluir o campo
_id.Para editar um nome de campo, valor ou tipo, clique no nome do campo, valor ou tipo.
Clique em Insert.
Insira vários documentos
Vá para a aba Find na IU do Atlas.
Selecione a coleção e vá para a guia Find.
Clique em Insert Document.
A interface do usuário do Atlas abre a caixa de diálogo Insert to Collection.
Selecione a Visualização JSON.
Digite ou cole uma array de documentos para inserir.
Exemplo
A seguinte matriz de documentos insere três documentos na coleta:
[ { "name": "Alice", "age": 26, "email": "alice@abc.com" }, { "name": "Bob", "age": 43, "email": "bob@def.com" }, { "name": "Carol", "age": 19, "email": "carol@xyz.com" } ]
Clique em Insert.
Clonar um documento
Vá para a aba Find na IU do Atlas.
Selecione a coleção e vá para a guia Find.
Até 20 documentos são exibidos na guia.
Opcional. Especifique um filtro.
Para especificar a condição de filtro, digite um documento de filtro de query na barra de filtros. Por exemplo, para especificar a condição de igualdade, use um documento de filtro do formulário:
{ <field1>: <value1>, ... }
Para usar operadores de consulta para especificar uma condição de filtro, use um documento de filtro do formulário:
{ <field1>: { <queryoperator>: <value1> }, ... }
Clone o documento.
Para clonar um documento exibido nos resultados da consulta, passe o mouse sobre o documento e clique no ícone do documento clonado.
O editor de documentos aparece com o campo _id com um valor ObjectId que reflete a hora de sua geração e não a hora de inserção do documento. Dessa forma, o ObjectId não representa uma ordem estrita de inserção.
Modifique o documento.
Para adicionar um novo campo após um campo existente, passe o mouse sobre o campo e clique no sinal de "mais" que aparece sobre o número de linha do campo.
Para excluir um campo, paire sobre o campo e clique no sinal x que aparece à esquerda do número da linha do campo. Você não pode excluir o campo
_id.Para editar um nome de campo, valor ou tipo, clique no nome do campo, valor ou tipo.
Clique em Insert.
Visualizar, filtrar e classificar documentos
Na guia Collections, você pode visualizar documentos em uma coleção. Para exibir documentos de uma coleção:
Selecione o banco de dados para a collection.
O painel principal e Namespaces no lado esquerdo listam as collections na base de dados.
Selecione a coleção no lado esquerdo ou no painel principal.
O painel principal exibe a visualização Find e a visualização Indexes.
Selecione a visualização Find.
O painel exibe os documentos na coleção. Coleções de documentos menores exibem até 20 documentos por página. Coleções de documentos maiores exibem um único documento por página.
Opcional: especifique uma query para encontrar documentos específicos.
Você pode usar a barra de query para pesquisar documentos específicos em sua coleção. Você executa as seguintes ações com a barra de query:
Filtrar uma query
Campos de projeto para incluir ou excluir campos específicos nos resultados da consulta
Classificar os documentos nos resultados
Aplicar o agrupamento para especificar regras específicas do idioma
Observação
Você não pode ignorar documentos e omiti-los dos resultados de query da barra de query do Atlas. Para ignorar documentos, use a etapa de pipeline $skip no construtor do aggregation pipeline .
Filtrar Resultados da Consulta
Para especificar uma condição de filtro, digite um filtro de query no campo Filter . Por exemplo, para especificar uma condição de igualdade, use um filtro com o formato:
{ <field1>: <value1>, ... }
Para usar operadores de consulta para especificar uma condição de filtro, use um filtro com o seguinte formulário:
{ <field1>: { <queryoperator>: <value1> }, ... }
Observação
A UI do Atlas não suporta consultas de data que utilizam a função IsoDate() . Em vez disso, utilize o MongoDB Extended JSON (v2) $date tipo de dados para consultas de data.
Por exemplo, a query a seguir retorna todos os documentos em que a data adicionada a um campo created_at é igual ou mais recente à meia-noite de 1º de janeiro de 2019, horário UTC:
{ created_at: { $gte: { $date: "2019-01-01T00:00-00:00" } } }
Para obter mais informações sobre como especificar filtros de query, incluindo condições compostas, consulte Documentos de query.
Campos do Projeto nos Resultados da Consulta
Para especificar os campos do documento a serem incluídos ou excluídos nos resultados, clique em More Options na barra de query e especifique os campos do documento no campo Project.
Para incluir campos, especifique o nome do campo e defina para 1 no documento do projeto. Por exemplo, para incluir os campos year e name nos documentos:
{ year: 1, name: 1 }
O Atlas retorna os campos especificados no campo Project e o campo _id, que é retornado a menos que seja explicitamente excluído.
Para excluir campos, especifique o nome do campo e defina para 0 no documento do projeto. Por exemplo, para excluir os campos year e name nos documentos:
{ year: 0, name: 0 }
O Atlas retorna todos os campos, exceto os campos especificados no Project.
Para saber mais sobre documentos de projeto, consulte $project.
Classificar Resultados da Consulta
Para classificar a ordem dos documentos nos resultados, clique em More Options na barra de query e insira o documento sort no campo Sort.
Para especificar a ordem crescente de um campo, defina o campo como
1no documento de classificação.Para especificar a ordem decrescente de um campo, defina o campo como
-1nos documentos de classificação.
Por exemplo, o documento sort a seguir classifica os resultados primeiro por year em ordem decrescente e, dentro de cada ano, classifica por name em ordem crescente:
{ year: -1, name: 1 }
Para saber mais sobre classificar documentos, consulte $sort.
Especifique o agrupamento
Importante
Recurso Indisponível em Instâncias sem Servidor
Neste momento, as instâncias sem servidor não permitem essa funcionalidade. Para saber mais, consulte Limitações de instância sem servidor.
Para especificar regras específicas de linguagem para comparação de strings, como regras para letras maiúsculas e acentos, clique More Options em na barra de query e insira o documento de agrupamento no Collation campo . Use o locale campo no documento de agrupamento para especificar o código de localidade da UTI para o idioma desejado. Por exemplo, para usar a pinyin variante do agrupamento Chinês, use o seguinte documento do agrupamento:
{ "locale" : "zh@collation=pinyin" }
Para saber mais sobre agrupamento de documentos, consulte Agrupamento.
Observação
Conforme você digita, o botão Apply é desabilitado e o nome do campo na interface do usuário fica vermelho até que uma query válida seja inserida.
Clique em Apply para executar sua query.
Número de documentos exibidos por página
A interface do usuário do Atlas limita o tamanho total de bytes dos documentos exibidos por página. Como resultado, você poderá ver um número variável de documentos por página, especialmente se o tamanho dos documentos variar significativamente.
Editar um documento
Para editar um documento a partir de uma coleção através da UI do Atlas:
Vá para a aba Find na IU do Atlas.
Selecione a coleção e vá para a guia Find.
Até 20 documentos são exibidos na guia.
Opcional. Especifique um filtro.
Para especificar a condição de filtro, digite um documento de filtro de query na barra de filtros. Por exemplo, para especificar a condição de igualdade, use um documento de filtro do formulário:
{ <field1>: <value1>, ... }
Para usar operadores de consulta para especificar uma condição de filtro, use um documento de filtro do formulário:
{ <field1>: { <queryoperator>: <value1> }, ... }
Edite o documento.
Para editar um documento exibido nos resultados da consulta, passe o mouse sobre o documento para editar e clique no ícone de lápis.
O documento aparece no editor de documentos:
Para adicionar um novo campo, passe o mouse sobre o campo e clique no sinal de mais que aparece sobre o número da linha do campo.
Para excluir um campo, paire sobre o campo e clique no sinal x que aparece à esquerda do número da linha do campo. Você não pode excluir o campo
_id.Para editar um nome de campo, valor ou tipo, clique no nome do campo, valor ou tipo.
Para reverter uma alteração específica, passe o mouse sobre o campo editado e clique no ícone reverter que aparece à esquerda do número da linha do campo.
Salve ou cancele as alterações.
Para confirmar e salvar as alterações, clique no botão Update.
Para cancelar todas as modificações no documento, clique no botão Cancel.
Excluir um documento
Para excluir um documento de uma coleção por meio da UI do Atlas:
Vá para a aba Find na IU do Atlas.
Selecione a coleção e vá para a guia Find.
Até 20 documentos são exibidos na guia.
Opcional. Especifique um filtro.
Para especificar a condição de filtro, digite um documento de filtro de query na barra de filtros. Por exemplo, para especificar a condição de igualdade, use um documento de filtro do formulário:
{ <field1>: <value1>, ... }
Para usar operadores de consulta para especificar uma condição de filtro, use um documento de filtro do formulário:
{ <field1>: { <queryoperator>: <value1> }, ... }
Exclua o documento.
Para excluir um documento exibido nos resultados da query, passe o mouse sobre o documento para excluí-lo e clique no ícone da lixeira.
O documento está sinalizado para exclusão.