/
Deletar / Delete (MongoDB)

Deletar / Delete (MongoDB)

Deleta dados de um banco de dados MongoDB.

Figura 1 - Bloco Deletar

 

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

Compatibilidade

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

Retorno

Se algum registro for deletado, retorna o valor "1". Caso contrário, retorna o valor "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://username:<db_password>@cluster.iftwlci.mongodb.net/..."

Banco de dados

Nome do banco dentro do cluster onde os dados estã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 que será excluído está armazenado.

  • Posição: 3

  • Inglês: Collection

  • Tipo: Texto / String

  • Exemplo: "movies"

Dados

O conteúdo a ser deletado 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 Deletar. 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 Deletar. No segundo parâmetro, é especificado o nome do banco de dados onde os registros estão inseridos, 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, adicionamos o registro em formato JSON a ser deletado, contendo o título do filme no seguinte formato: {"title": "nome_do_filme"}.

Figura 2 - Exemplo de uso do bloco Deletar

 

A imagem a seguir exibe o resultado de execução da função da Figura 2. Antes disso, um registro foi adicionado ao banco de dados por meio do bloco Inserir. Em seguida, ao executar a função da Figura 2, o mesmo registro foi removido, resultando no retorno do valor "1", que indica que a exclusão foi realizada com sucesso.

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

 

Para confirmar se o dado foi realmente deletado 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 deletado 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). Observe que nenhum registro foi encontrado (4), confirmando a sua exclusão. 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