Wat is MongoDB?

Tot nu toe hebben we enkel gewerkt met in-memory data. Dit wil zeggen dat we data in een array steken en deze array in het geheugen houden. Wanneer de server stopt, is deze data weg. Dit is niet handig wanneer we data willen bijhouden die we later willen opvragen. Daarom gaan we nu werken met een database. We zouden kunnen werken met een relationele database zoals MySQL, maar we gaan werken met MongoDB omdat dit beter aansluit bij de manier waarop we data bijhouden in TypeScript (JSON).

Door een database te gebruiken, kunnen we data bijhouden die we later kunnen opvragen. We kunnen data toevoegen, aanpassen, verwijderen en opvragen. Dit noemen we CRUD operaties (Create, Read, Update, Delete).

MongoDB vs Relational DB

MongoDB is een NoSQL database. Hier zijn enkele verschillen tussen een relationele database en een NoSQL database:

Een relationele database:

• data verspreid over tabellen

• gestructureerde data

• structuur moeilijk aan te passen

• goed voor ingewikkelde queries

Een NoSQL database:

• data wordt bijgehouden als "documents" / JSON

• dynamische data

• structuur is makkelijk aanpasbaar

• goed voor simpele queries

Je kan echter de logica van relationele databases mappen op die van NoSQL:

• een record in RDB komt overeen met een MongoDB"s document (JSON object)

• een tabel in RDB komt overeen met MongoDB"s collection

• _id is unieke identifier (indexed) voor elk document net zoals je een ID met primary key zou toevoegen aan een relationele database tabel

Laten we een eenvoudig voorbeeld nemen van een tabel met persoonsgegevens:

firstName	lastName	email
Sven	Charleer	[e-mail]
Andie	Similon	[e-mail]

In NoSQL stellen we dit als volgt voor:

[
  {
    firstname: "Sven",
    lastname: "Charleer",
    email: "[e-mail]"
  },
  {
    firstname: "Andie",
    lastname: "Similon",
    email: "[e-mail]"
  },

]

MongoDB Atlas

Om MongoDB te gebruiken, moeten we uiteraard een MongoDB server hebben. Het is mogelijk om een MongoDB server te installeren op je eigen machine, maar dit is niet altijd handig. Daarom kan je gebruik maken van MongoDB Atlas. Dit is een cloud service die ons toelaat een MongoDB server te gebruiken zonder dat we deze zelf moeten installeren.

Om MongoDB Atlas te gebruiken, kan je een account aanmaken op https://www.mongodb.com/atlas en hier een database aanmaken. Je kan dan een connectie string genereren die je later kan gebruiken om te connecteren op de database.

Let zeker op dat je voor deze cursus een gratis cluster aanmaakt. Dit is voldoende voor onze doeleinden.

Docker en devcontainers

Wanneer je applicatie in productie draait, maak je uiteraard gebruik van een externe MongoDB-server, zoals MongoDB Atlas.

Tijdens het ontwikkelen is het echter praktischer om een lokale MongoDB-instantie te gebruiken. Dit kun je doen door MongoDB direct op je machine te installeren of door gebruik te maken van Docker.

MongoDB draaien met Docker

Met het onderstaande commando start je een MongoDB-container waarbij de data behouden blijft via een volume:

docker run -d \
  -p 27017:27017 \
  -v mongo-data:/data/db \
  --name mongodb \
  mongo:latest

Let op: dit commando moet je op je eigen machine uitvoeren, niet in de devcontainer.

Verbinding maken vanuit een Dev Container

Als je werkt vanuit een Dev Container en verbinding wilt maken met de MongoDB-server die op je eigen machine (de host) draait, gebruik je de volgende verbindingsstring:

mongodb://host.docker.internal:27017/

Let op: host.docker.internal is een speciale DNS-naam die binnen Docker wordt gebruikt om te verwijzen naar het IP-adres van je lokale machine (de host).

MongoDB for VS Code

Om MongoDB te gebruiken in Visual Studio Code, kan je de MongoDB for VS Code extension installeren. Deze extension laat je toe om MongoDB databases te beheren vanuit VS Code.

Om deze extension te installeren, ga je naar de extensions tab in VS Code en zoek je naar "MongoDB for VS Code". Klik op install om de extension te installeren.

alt text