09: Datenbank einrichten

web/09/db/anleitung_db.md

@@ -0,0 +1,23 @@
+# Tooling für die Entwicklung mit einer PostGreSQL-DB
+
+Diese Anleitung beschreibt die Schritte zur Verbindung mit einer PostGreSQL-DB sowie das Erstellen von Tabellen mit Hilfe der VS Code Extension _PostgreSQL_ und der im Dev-Container enthaltenen Datenbank.
+
+## Neue Verbindung
+
+1. Prüfen Sie, ob Sie sich im Dev-Container befinden
+2. Klicken Sie auf das PostGreSQL-Symbol (VS Code Extension) in der Activity Bar (default: linke Leiste)
+3. Wählen Sie "Add New Connection" und "CONNECTIONS" in der Primary Side Bar (meistens: links)
+   1. Füllen Sie die geforderten Felder aus. Sie finden die Daten zu Ihrer Datenbank-Installation in der Datei `.env` innerhalb des `.devcontainer`- Ordners.
+   2. Testen Sie die Verbindung ("Test Connection")
+   3. Vergeben Sie einen geeigneten Namen und speichern Sie die Verbindung ("Save & Connect")
+
+## Tabellen
+4. Öffnen Sie die Datei `create_personen.sql`.
+5. Auf der rechten Seite der Tab-Leiste erscheinen nun mehrere Symbole. Wählen Sie "Connect" aus und geben Sie ggf. Ihr Datenbank-Passwort ein (`POSTGRES_PASSWORD` in `.env`)
+6. Wählen Sie nun das Symbol für "Change PostGreSQL Database" aus und wählen Ihre Datenbank aus (`POSTGRES_DB` in `.env`)
+7. Wählen Sie nun das Symbol für "Execute PostGreSQL Query" aus: Es wird eine neue Tabelle in Ihrer Datenbank erstellt.
+
+## Einfügen und Anzeigen
+8. Führen Sie die Schritte 5.-7. nun auch für die Dateien `insert_personen.sql` und `select_personen.sql` durch.
+9. Alternativ oder zusätzlich können Sie natürlich auch eigene Queries ausführen.
+

web/09/db/create_personen.sql

@@ -0,0 +1,5 @@
+CREATE TABLE personen (
+    name TEXT NOT NULL,
+    hobbies TEXT,
+	alter SMALLINT
+);

web/09/db/insert_personen.sql

@@ -0,0 +1 @@
+INSERT INTO personen (name, hobbies, alter) VALUES ('Siri', 'Lesen, Wandern, Kochen', 14),('Alexa', 'Kochen, Gitarre spielen', 11);

web/09/db/select_personen.sql

@@ -0,0 +1 @@
+SELECT * FROM personen;