Datenbanken verwenden

Die CAP-Node.js-Laufzeit bietet sofort einsatzbereite Unterstützung für verschiedene Datenbanken.

Sehen Sie sich das Video an, um mehr über unterstützte Datenbanken zu erfahren.

In CAP wird die sogenannte CDS-Plugin-Technik verwendet, um eine Datenbank in eine Anwendung zu integrieren. Im Wesentlichen handelt es sich bei diesen Datenbank-Plugins um Node.js-Pakete, mit denen CAP eine Verbindung zu einer bestimmten Datenbank herstellen und mit dieser interagieren kann, ohne dass eine zusätzliche Konfiguration erforderlich ist. Jede unterstützte Datenbank verfügt über ein entsprechendes CDS-Plugin-Paket.

Durch die Verwendung dieser Datenbank-Plug-Ins können Entwickler während der Entwicklung und Produktion problemlos zwischen verschiedenen Datenbanken wechseln, ohne den Anwendungscode ändern zu müssen.

Um SQLite automatisch für die Entwicklung zu konfigurieren, installieren Sie das entsprechende Datenbankpaket mit dem folgenden Befehl im Terminal:

1
npm add @cap-js/sqlite -D

Führen Sie den folgenden Befehl aus, um SAP HANA Cloud for production zu verwenden:

1
npm add @sap/cds-hana

Die Node.js-Datenbankpakete verbinden Dinge automatisch über Konfigurationsstandardwerte, die über den CDS-Plugin-Mechanismus festgelegt werden. Sie können die von den Paketen bereitgestellte Standardkonfiguration für Ihre Anwendung verwenden oder einzelne Eigenschaften übersteuern. Wie das geht, erfahren wir später in dieser Learning Journey.

Um die effektive Datenbankkonfiguration anzuzeigen, können Sie den Befehl cds env für den Schlüssel cds.requires.db im Stammordner Ihres Projekts ausführen, wie in der Abbildung „Effektive Konfiguration prüfen" dargestellt.

Der Befehl gibt folgende Konfigurationsoptionen zurück:

• impl - der Modulname der Implementierung eines CAP-Datenbankservice
• Credentials - ein Objekt mit db-spezifischen Konfigurationen, meist URL
• kind - Name einer Voreinstellung, z.B. sqlite oder hana

Sie können die Datenbanktabellen, die für Ihre CAP-Anwendung angelegt wurden, mit Ausgangsdaten füllen.

Gehen Sie wie folgt vor, um initiale Daten in diese Tabellen zu laden, sobald die Anwendung gestartet wird: Legen Sie für jede über das CDS-Modell definierte Tabelle eine .csv-Datei mit einem Dateinamen an, der mit dem vollqualifizierten Namen der entsprechenden Entitätsdefinition in Ihrem CDS-Modell übereinstimmt. Aus kosmetischen Gründen können Sie optional einen Bindestrich (-) anstelle eines Punkts (.) verwenden.

In dem hier besprochenen Szenario können Sie beispielsweise die Dateien com.sap.learning-Authors.csv und com.sap.learning-Books.csv für die Model-Entitäten com.sap.learning.Authors und com.sap.learning.Books anlegen.

Die angelegten .csv-Dateien müssen dann mit Standard-CSV gefüllt werden, wobei die Spaltentitel den deklarierten Elementnamen im CDS-Modell entsprechen müssen, wie das Beispiel in der Abbildung „Bereitstellen von Ausgangsdaten" zeigt.

Häufig müssen Sie zwischen Beispieldaten und echten Ausgangsdaten unterscheiden. CAP unterstützt dies durch die Möglichkeit, initiale Daten an zwei Stellen zur Verfügung zu stellen.

CSV-Dateien, die im Test-/Datenordner angelegt werden, werden nur implementiert, wenn die Anwendung nicht produktiv ausgeführt wird. Dieser Ordner kann daher verwendet werden, um Beispieldaten für Tests und Demos zu speichern.

.csv-Dateien, die im Ordner db/data erstellt werden, werden dagegen in jeder Umgebung, einschließlich Produktivumgebung, implementiert. Dieser Ordner eignet sich daher beispielsweise für initiale Konfigurationsdaten und Daten für Codelisten.

Wenn Sie den folgenden Befehl im Terminal eingeben, werden im Ordner db/data entsprechende CSV-Dateien für die Tabellen angelegt, die über Ihr CDS-Modell definiert wurden:

1
cds add data

Die generierten Dateien enthalten noch keine Daten, aber Spaltentitel basierend auf Ihrem CDS-Modell (siehe Abbildung „Generierte CSV-Dateien für modellierte Entitäten").

SAP empfiehlt dringend, SQLite während der Entwicklung und beim Testen so weit wie möglich zu verwenden. CAP bietet umfangreiche Unterstützung für diese Datenbank, wodurch Projekte die Entwicklung beschleunigen und Kosten minimieren können.

In dieser Learning Journey folgen wir dieser Empfehlung und verwenden SQLite als Datenbank während der Entwicklung. Wie Sie zu SAP HANA Cloud als Datenbank für die Produktion wechseln, erfahren Sie in der CAP-Dokumentation.

Wie oben erwähnt, müssen Sie den folgenden Befehl im Terminal ausführen, um SQLite für die Entwicklung zu verwenden:

1
npm add @cap-js/sqlite -D

Dieser Befehl fügt der Datei package.json eine Abhängigkeit ähnlich der folgenden hinzu:

Das @cap-js/sqlite-Paket verwendet die cds-Plugin-Technik, um eine In-Memory-SQLite-Datenbank für Ihre Anwendung standardmäßig automatisch zu konfigurieren. Sie können dies in der Protokollausgabe sehen, wenn Sie Ihre Anwendung mit cds watchstarten:

Sie können auch persistente SQLite-Datenbanken verwenden. Führen Sie dazu die folgenden Schritte aus:

1. Geben Sie einen Datenbankdateinamen in der DB-Konfiguration in package.json wie folgt an:

   Zusammenfassend lässt sich sagen, dass diese Konfiguration dem CAP-Framework mitteilt, dass es während der Entwicklung eine SQLite-Datenbank verwenden sollte, die sich in einer Datei namens db.sqlite am Stamm des Projekts befindet.

2. Führen Sie den folgenden Befehl im Terminal aus:
   Code Snippet

   Copy codeSwitch to dark mode

   1
   cds deploy

Dies bewirkt Folgendes:

1. Erstellen Sie eine Datenbankdatei mit dem angegebenen Namen im Stammordner Ihres Projekts.
2. Legen Sie die Tabellen und Views gemäß Ihrem CDS-Modell in der Datenbank an.
3. Geben Sie die Ausgangsdaten aus den bereitgestellten CSV-Dateien ein.

Wenn dies der Fall ist, verwendet der Server diese vorbereitete Datenbank, anstatt beim Start eine In-Memory-Datenbank zu starten. Sie können dies in der Protokollausgabe sehen, wenn Sie den Server über cds watchstarten:

Wenn Sie Ihre persistente Datenbank mit cds deployerneut implementieren, werden zuerst alle Tabellen und Ansichten gelöscht und dann neu erstellt. Dies eignet sich am besten für Entwicklungsumgebungen, in denen Schemaänderungen sehr häufig und umfassend sind.

cds deployunterstützt jedoch auch die automatische Schemaentwicklung für persistente Datenbanken. In diesem Fall werden geänderte Tabellen nicht einfach gelöscht und während des erneuten Deployments neu angelegt. Stattdessen werden die Änderungen über ALTER TABLE übernommen.

Beachten Sie jedoch, dass die automatische Schemaentwicklung nur Änderungen ohne möglichen Datenverlust zulässt. Details zur Schemaentwicklung finden Sie in der CAP-Dokumentation. Der verlinkte Abschnitt in der Dokumentation bezieht sich auf die PostgreSQL-Datenbank. Die dortigen Informationen gelten jedoch auch für SQLite mit persistenten Datenbanken.

Sehen Sie sich das Video an, um zu sehen, wie Sie eine persistente SQLite-Datenbank mit initialen Daten für die Entwicklung einrichten.