Insere dados em um banco de dados MongoDB.


Figura 1 - Bloco Inserir


Este bloco faz parte do plugin Plugin MongoDB. Para visualizá-lo, é necessário instalar o plugin.

Compatibilidade

  • Bloco servidor: cronapp.framework.mongodb.Operations.insert()

Retorno

Retorna um objeto contendo informações do registro inserido no banco de dados.

Parâmetros

String de conexão

É a URL que permite conectar seu aplicativo ao banco de dados MongoDB. Essa string contém informações como o nome de usuário, senha, endereço do cluster e banco de destino.

  • Posição: 1
  • Inglês: Connection String
  • Tipo: Texto / String
  • Exemplo: "mongodb+srv://username:<db_password>@cluster.iftwlci.mongodb.net/..."

Banco de dados

Nome do banco dentro do cluster onde os dados serão inseridos.

  • Posição: 2
  • Inglês: Database
  • Tipo: Texto / String

  • Exemplo: "sample_mflix"

Coleção

Nome da coleção (equivalente a uma tabela em bancos relacionais) onde o registro será armazenado.

  • Posição: 3
  • Inglês: Collection
  • Tipo: Texto / String

  • Exemplo: "movies"

Dados

O conteúdo a ser inserido no banco, no formato JSON.

  • Posição: 4
  • Inglês: Data
  • Tipo: Texto / String

  • Exemplo: "{'title': 'Matrix'}"

Exemplo

A função da imagem abaixo apresenta um exemplo de uso do bloco Inserir. Antes de utilizá-lo, certifique-se de que o cluster MongoDB já esteja devidamente configurado. Para mais detalhes sobre essa configuração, consulte a documentação do Plugin MongoDB.

Inicialmente, a variável "connectionString" é utilizada para armazenar a string de conexão com o banco de dados. Em seguida, essa variável é passada como primeiro parâmetro do bloco Inserir. No segundo parâmetro, é especificado o nome do banco de dados de destino, que neste exemplo é o "sample_mflix", um banco fornecido pelo MongoDB para testes e aprendizado. No parâmetro "Coleção", é informado "movies", uma coleção existente nesse banco. Por fim, no último parâmetro do bloco, são inseridos os dados em formato JSON, contendo o título do filme no seguinte formato: {"title": "nome_do_filme"}.


Figura 2 - Exemplo de uso do bloco Inserir


A imagem a seguir exibe o resultado de execução da função da Figura 2.


Figura 2.1 - Resultado de execução da função da Figura 2


Para confirmar se o dado foi realmente inserido no banco, acesse novamente o MongoDB Atlas. Na tela principal, vá até a seção "Database" e clique na opção "Browse Collections". Em seguida, selecione a aba "Collections" e, depois, clique na coleção "movies" (destaque 1 da Figura 2.1). A pesquisa pelo dado inserido deve ser feita em formato JSON (2), portanto, utilize exatamente o mesmo conteúdo informado no parâmetro "Dado" da Figura 2. Após inserir o JSON no campo de busca, clique em "Apply" (3). O resultado será exibido logo abaixo (4), confirmando a inserção no banco. Para mais detalhes de como acessar os registros, consulte a documentação Plugin MongoDB.


Figura 2.2 - Registro inserido no banco de dados

Nesta página