Modifica registros existentes em uma coleção com base em um filtro.


Figura 1 - Bloco Atualizar 


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

Compatibilidade

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

Retorno

Retorna o valor "1" se o registro for atualizado; caso contrário retorna "0".

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://<db_userName>:<db_password>@meucluster.trzwoga.mongodb.net/?retryWrites=true&w=majority&appName=MeuCluster"

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

No MongoDB, coleções são estruturas que armazenam os documentos (dados) dentro de um banco de dados. Elas funcionam de maneira semelhante às tabelas em bancos de dados relacionais, mas com algumas diferenças importantes por causa da natureza NoSQL do MongoDB.

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

  • Exemplo: "movies"

Filtro

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

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

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

Dados

Novo valor que será substituído. É necessário utilizar o operador $set antes de informar o novo valor.

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

  • Exemplo: "{'$set':{ 'title': 'Matrix 2' }}"

Exemplo

A função da imagem abaixo apresenta um exemplo de uso do bloco Atualizar. 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 Atualizar. 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. No parâmetro "Filtro", indicamos, em formato JSON, o conteúdo que será alterado, contendo o título do filme no seguinte formato: {"title": "nome_do_filme"}. Por fim, no último parâmetro, definimos o novo título do filme. Lembre-se de utilizar o operador $set para realizar a alteração.


Figura 2 - Exemplo de uso do bloco Atualizar 


A figura 2.1 apresenta o conteúdo presente no MongoDB Atlas antes da sua alteração.


Figura 2.1 - Registro antes da alteração


Ao executar a função da figura 2, o registro é atualizado para o título "Matrix 2".


Figura 2.2 - Registro após a alteração


Após a alteração do título, buscamos novamente por "Matrix", o resultado é uma busca vazia, tendo em vista que não há mais um registro com esse título, devido a alteração realizada pela função.


Figura 2.3 - Consulta novamente por Matrix

Nesta página