/ /

Realizar operações CRUD

Página inicial do Docs

/ /

Explorar com Playgrounds

Realizar operações CRUD

Página inicial do Docs

Ferramentas

Extensão VS Code

Explorar com Playgrounds

Realizar operações CRUD

Ler documentos com VS Code

Você pode ler documentos em uma coleção usando osoperadores CRUD do MongoDB em um MongoDB Playground:

Use o método findOne() para ler um documento.
Use o método find() para ler mais de um documento.

Observação

Você pode abrir umJavaScript Playground pré-configurado para pesquisar uma collection passando o mouse sobre o rótulo Documents no painel de navegação e clicando em ícone que aparece.

Pré-requisitos

Se ainda não tiver feito isso, deverá preencher os seguintes pré-requisitos antes de ler documentos com um MongoDB Playground:

Crie uma conexão com uma instalação do MongoDB.
Ative a conexão para a implantação do MongoDB.
Abra um MongoDB Playground.
Crie documentos com VS Code ou crie documentos em uma coleção usando um método diferente.

Leia um documento

Para ler um documento, use a seguinte sintaxe no seu Playground:

db.collection.findOne(
   { <query> },
   { <projection> }
)

Se vários documento satisfizerem a query, esse método retornará o primeiro documento de acordo com a ordem de armazenamento que reflete a ordem dos documento no disco.

Para saber mais sobre os parâmetros deste método, consulte findOne() no Manual MongoDB.

Para executar o Playground, pressione o botão no canto superior direito da visualização do Playground. VS Code Extension divide seu Playground e exibe os resultados do seu Playground no painel Playground Results. Se você desativou a visualização dividida, a VS Code Extension exibe os resultados do seu Playground em uma nova aba.

Você pode editar qualquer documentoJSON retornado de uma operação findOne() ou find() .

Clique em Edit Document

Na parte superior deste documento, clique em Edit Document. A extensão VS Code a abre como um documento EJSON editável intitulado <database>.<collection>:"<_id>".

Faça as edições necessárias no documento.

Salvar o documento editado

Pressione Ctrl + S (Windows/Linux) ou Cmd + S para salvar o documento editado no banco de dados do MongoDB.

Se a atualização for bem-sucedida, a VS Code Extension confirma que o banco de dados armazenou a alteração. Se a atualização resultar em um erro, a Extensão VS Code exibirá o erro.

Exemplo

Para executar este exemplo, comece com um Playground do MongoDB em branco, limpando o Playground modelo se ele estiver carregado.

O seguinte exemplo:

Passa para o banco de dados test.
Lê um documento na coleção test.sales que corresponde à query.

use("test");
db.sales.findOne(
  { "_id" : 1 },
  { "_id" : 0 }
);

Quando você pressiona o botão , a VS Code Extension realiza a divisão do seu Playground e gera o documento a seguir no painel Playground Result. Se você desativou a divisão, a Extensão VS Code exibirá o seguinte documento em uma nova aba. Se você mover manualmente os resultados do seu playground, a extensão VS Code exibirá os resultados nessa aba.

{
  item: 'abc',
  price: 10,
  quantity: 2,
  date: 2014-03-01T08:00:00.000Z
}

Ler muitos documentos

Para ler muitos documentos, use a seguinte sintaxe no seu Playground:

db.collection.find(
   { <query> },
   { <projection> }
)

Para obter uma descrição detalhada dos parâmetros desse método, consulte find() no Manual do MongoDB.

Exemplo

Para executar este exemplo, comece com um Playground do MongoDB em branco, limpando o Playground modelo se ele estiver carregado.

O seguinte exemplo:

Passa para o banco de dados test.
Lê todos os documentos na coleção test.sales que correspondem à consulta.

use("test");
db.sales.find(
  { "item" : "abc" },
  { "price" : 1 }
);

[
  {
    _id: 2,
    price: 10
  },
  {
    _id: 6,
    price: 10
  },
  {
    _id: 9,
    price: 10
  },
  {
    _id: 1,
    price: 10
  }
]

Ler documentos com um cursor

Quando a última expressão em seu Playground é avaliada como um cursor, como uma db.collection.find() ou db.collection.aggregate() chamar, o Visual Studio Code abre os resultados na exibição do navegador do documento de resultados do cursor.

Nesta visualização, você pode:

Percorra os resultados com os controles de paginação na parte superior da visualização.
Visualize cada documento em uma lista semelhante a uma tabela. Os documentos aparecem na sintaxe do shell por padrão.

Observação

O Visual Studio Code ainda usa o editor de resultados comum para operações que não produzem um cursor com uma lista de documentos, como agregações terminadas em $out ou $merge, ou resultados que não são documentos, como cadeias de caracteres, números, ou outros valores escalares.

Exemplo

Para executar este exemplo, comece com um Playground do MongoDB em branco, limpando o Playground modelo se ele estiver carregado.

O seguinte exemplo:

Passa para o banco de dados test.
Lê todos os documentos da collection test.sales que correspondem à query.
Retorna um cursor como a última expressão.

use("test");
db.sales.find(
  { "price": { $gte: 10 } },
  { "price": 1 }
);

Quando você clica no botão , o Visual Studio Code abre uma aba do navegador de documento que mostra os documentos que o cursor retornou com controles de paginação na parte superior da visualização.

Retornar o cursor inteiro como uma array

Se você preferir converter um cursor em uma array e visualizá-lo diretamente no editor de Playground Results em vez do navegador de documento , chame toArray() no cursor como a última expressão em seu Playground:

let cursor = db.collection.find({ <query> });
cursor.toArray();

[
   {
      "_id": 2,
      "price": 10
   },
   {
      "_id": 3,
      "price": 20
   },
   {
      "_id": 6,
      "price": 10
   },
   {
      "_id": 9,
      "price": 10
   }
]

Saiba mais

Para obter documentação mais detalhada sobre métodos e comportamentos do cursor, consulte:

Voltar

criar

Update