KEPLIN Docs

Unterstützte Typen

Die sechs Datenbank-Engines, die eine App verbinden kann, die Felder jeder einzelnen, was jede Engine kann, und die Werkzeuge, um Tabellen anzulegen und zu ändern, ohne die Plattform zu verlassen.

Beim Anlegen einer Datenquelle entscheidet das Feld Typ über alles Weitere: über die Verbindungsfelder, die das Formular zeigt, über die Parameter-Platzhalter, die das SQL verwendet, und darüber, was die Plattform Sie in dieser Datenbank anlegen lässt (Ansichten, Prozeduren, Trigger). Diese Seite geht die sechs Typen einzeln durch.

Die Liste der Datenbanktypen im Dialog Neue Datenquelle: die sechs unterstützten Engines.
Die Liste der Datenbanktypen im Dialog Neue Datenquelle: die sechs unterstützten Engines.

Schnellübersicht

Typ Verbindet zu Standard-Port Besonderheiten
PostgreSQL PostgreSQL-Server 5432 Schalter SSL verwenden
MySQL MySQL-Server 3306 Schalter SSL verwenden
MariaDB MariaDB-Server 3306 Schalter SSL verwenden
MS SQL Server Microsoft-SQL-Server 1433 Encrypt, Trust server certificate, Legacy-TLS, Timeout der Query (s)
Oracle Oracle-Datenbank — (steht im Connect string) Ein einziges Feld Connect string
SQLite Lokale Datenbank in einer Datei — (kein Server) Keine Zugangsdaten; die Datenbank lebt mit der App

Nota

Die ersten fünf sind externe Datenbanken — Ihre Server, die die Plattform über das Netz mit den von Ihnen erfassten Zugangsdaten kontaktiert. SQLite ist der Sonderfall: eine Datenbank in einer Datei, mit der App selbst gespeichert.

PostgreSQL, MySQL und MariaDB

Die drei teilen sich dasselbe Formular:

Feld Was es ist
Host Adresse des Servers (Name oder IP)
Port Kommt mit dem der Engine vorausgefüllt (5432 oder 3306)
Database Der Name der Datenbank innerhalb des Servers
Benutzer Das Konto, mit dem sich die Plattform verbindet
Passwort Das Passwort dieses Kontos — es wird nie wieder angezeigt
SSL verwenden Schaltet die Verschlüsselung der Verbindung ein, wenn der Server sie verlangt oder unterstützt

Dica

Verwenden Sie ein der App gewidmetes Datenbankkonto, mit Rechten nur auf das, was die App braucht. Alle Queries — aus APIs, Skripten und Konsole — laufen mit diesem Konto, und seine Rechte sind die Obergrenze dessen, was die App tun kann.

MS SQL Server

Neben Host, Port (1433), Database, Benutzer und Passwort bringt der SQL Server vier eigene Optionen mit:

Option Wofür sie da ist
Timeout der Query (s) Maximale Zeit je Query, in Sekunden (kommt mit 30). Erhöhen Sie ihn, wenn Sie lange Stored Procedures haben — darunter sterben sie auf halbem Weg mit einem Timeout-Fehler.
Encrypt Verschlüsselt die Verbindung (ist standardmäßig eingeschaltet).
Trust server certificate Nimmt das Zertifikat des Servers an, ohne es zu prüfen — typisch bei internen Servern mit eigenem Zertifikat.
Legacy-TLS (alter SQL Server) Siehe unten.

Das Formular selbst erklärt, wann die letzte einzuschalten ist: „Aktivieren Sie Legacy-TLS, wenn die Verbindung zu einem alten SQL Server (2008/2012) mit SSL/TLS-Fehlern scheitert — das erlaubt den Handshake mit alten Verschlüsselungen und Protokollen (und setzt voraus, dem Zertifikat des Servers zu vertrauen).“

Die spezifischen Felder und Schalter des MS SQL Server
Die spezifischen Felder und Schalter des MS SQL Server

Dica

Die Verbindung zu einem SQL Server 2008/2012 scheitert mit SSL-Meldungen? Das ist fast immer dies: Schalten Sie Legacy-TLS ein und testen Sie erneut. Die Option senkt das Sicherheitsniveau nur dieser Verbindung — die anderen Datenquellen sind nicht betroffen.

Oracle

Oracle kommt ohne getrennte Angaben für Host und Port aus — die Adresse steht komplett in einem Feld:

Feld Was es ist
Connect string Im Format host:port/service_name — z. B.: ora.interno.exemplo.pt:1521/CRMPROD
Benutzer Das Oracle-Schema bzw. -Konto, mit dem sich die Plattform verbindet
Passwort Das Passwort dieses Kontos

Das Oracle-Formular mit ausgefülltem Connect string
Das Oracle-Formular mit ausgefülltem Connect string

Nota

In Oracle heißt sich als Benutzer zu verbinden, in dessen Schema einzusteigen — die Tabellen dieses Schemas erscheinen ohne Präfix im Objektbaum.

SQLite — die Datenbank, die mit der App lebt

SQLite ist der Typ für Daten, die der App gehören: Prototypen, Demos, eine kleine Datenbank, die keinen Server rechtfertigt. Es gibt weder Host noch Port, weder Benutzer noch Passwort — es gibt eine Datei, und die Plattform ist es, die sie aufbewahrt:

  1. Wählen Sie SQLite im Feld Typ.
  2. Nutzen Sie optional Datenbank importieren (optional), um eine bereits vorhandene Datei .db, .sqlite oder .sqlite3 hochzuladen.
  3. Klicken Sie auf Erstellen. Wie die Hilfe des Feldes sagt: „Ohne Datei wird eine leere Datenbank erstellt. Die Datei wird bei der App gespeichert — es sind keine Pfade anzugeben.“

Bei der Wahl von SQLite schrumpft das Formular auf das Importfeld — ohne Host und ohne Zugangsdaten
Bei der Wahl von SQLite schrumpft das Formular auf das Importfeld — ohne Host und ohne Zugangsdaten

Drei Verhaltensweisen, die man kennen sollte:

  • Beim Anlegen gibt es kein Verbindung testen — die Datei existiert noch nicht, es gibt nichts zu testen. Der Button erscheint nach dem Speichern, beim Bearbeiten.
  • Bearbeiten tauscht nie die Datei aus — die Datei ist die Datenquelle; die Verbindung zu bearbeiten legt keine neue Datenbank an und löscht keine Daten.
  • Die Datenquelle zu löschen heißt, sich von den Daten zu verabschieden — im Gegensatz zu den externen Typen lebt die Datenbank hier mit der App.

Was jede Engine kann

Die Plattform bietet Ihnen nur an, was die Engine unterstützt — Optionen, die es in einer Engine nicht gibt, erscheinen in deren Menü nicht. Die Landkarte:

Fähigkeit PostgreSQL MySQL MariaDB MS SQL Server Oracle SQLite
Ansichten Ja Ja Ja Ja Ja Ja
Funktionen / Prozeduren Ja Ja Ja Ja Ja Nein
Trigger — Zeitpunkte BEFORE, AFTER, INSTEAD OF BEFORE, AFTER BEFORE, AFTER AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF
Trigger mit mehreren Ereignissen auf einmal Ja Nein (eines pro Ereignis) Nein (eines pro Ereignis) Ja Ja Nein
Trigger, im visuellen Canvas gezeichnet Ja Ja Ja Ja Ja Nein (nur SQL)
Typ/Nullbarkeit einer vorhandenen Spalte ändern Ja Ja Ja Ja Ja Nein
Feld Schema (optional) bei den Objekten Ja Ja Ja

Nota

Im SQL Server gibt es kein BEFORE — das Äquivalent ist INSTEAD OF. Und in SQLite zwingt das Ändern des Typs einer vorhandenen Spalte dazu, die Tabelle neu zu erstellen; die Option erscheint nicht.

Objekte anlegen und ändern (DDL)

Sie brauchen kein anderes Werkzeug, um an der Struktur der Datenbank zu arbeiten: Das Menü jeder Datenquelle im Panel Daten legt Objekte an, und der Baum bearbeitet die vorhandenen. In allen Fällen erzeugt die Plattform das SQL für die Engine der Datenquelle und führt es wirklich aus in der Datenbank.

Aktion Was sie tut
Neue Tabelle „Definieren Sie die Spalten — wir erzeugen das CREATE TABLE für die Engine und führen es aus.“ Spalten mit Typ, NULL erlaubt, Primärschlüssel (PK), Auto-Inkrement und Anzeigename für die Apps.
Struktur bearbeiten (an einer Tabelle) „Ändern Sie Spalten und Indizes — erzeugt und führt das entsprechende ALTER / CREATE INDEX aus.“ Legt auch Indizes an und löscht sie.
Neue Ansicht Sie schreiben das SQL der Ansicht, und es wird ausgeführt.
Neue Funktion / Prozedur Sie schreiben das SQL, und es wird ausgeführt (in den Engines, die sie unterstützen).
Neuer Trigger Erste Angaben im Modal; den Ablauf bauen Sie danach im visuellen Canvas.
Objekte aktualisieren Liest die Struktur der Datenbank neu ein — nach Änderungen, die außerhalb der Plattform gemacht wurden.

Das Modal Neue Tabelle: Sie definieren die Spalten, und die Plattform erzeugt und führt das CREATE TABLE aus
Das Modal Neue Tabelle: Sie definieren die Spalten, und die Plattform erzeugt und führt das CREATE TABLE aus

Atenção

Das ist echtes DDL, in Ihrer echten Datenbank — ein DROP oder ein ALTER ist hier so endgültig wie in jedem anderen SQL-Client. Und es gelingt nur, wenn der Benutzer der Verbindung die Rechte hat, Objekte anzulegen und zu ändern.

Die SQL-Konsole

Am unteren Rand des Bildschirms Modell jeder Datenquelle lebt die SQL-Konsole: Sie schreiben links, klicken auf Ausführen, und die Ergebnisse erscheinen als Tabelle (bis zu 500 Zeilen), mit Filtern je Spalte. Der Editor vervollständigt automatisch mit den Tabellen und Spalten der Datenquelle, und das Daten anzeigen jeder Tabelle des Baums öffnet die Konsole mit einem bereits fertigen Select.

Daten anzeigen öffnet die SQL-Konsole mit der bereits ausgeführten Abfrage — die echten Zeilen der Tabelle, unter dem Modell.
Daten anzeigen öffnet die SQL-Konsole mit der bereits ausgeführten Abfrage — die echten Zeilen der Tabelle, unter dem Modell.

Die Konsole ist etwas für Administratoren, und die Schreiboperationen werden im Audit protokolliert — die Einzelheiten stehen auf der Seite Die Verbindung testen und Sicherheit.

Parameter-Platzhalter je Engine

Wenn Sie SQL in Skripten schreiben, werden die Werte in einer separaten Liste übergeben — nie in den Satz geklebt — und jede Engine hat ihre eigene Syntax für Platzhalter:

Engine Platzhalter Beispiel
PostgreSQL $1, $2, … select * from contas where cidade = $1
MySQL / MariaDB ? select * from contas where cidade = ?
MS SQL Server @p1, @p2, … select * from contas where cidade = @p1
Oracle :1, :2, … select * from contas where cidade = :1
SQLite ? select * from contas where cidade = ?

Dica

In den SQL-Schritten der APIs brauchen Sie diese Tabelle nicht: Sie schreiben :nomeDoArg, und die Plattform kümmert sich um die Umwandlung für die gewählte Engine. Vermeiden Sie es in Oracle, Datumsangaben als Parameter zu übergeben — bevorzugen Sie das Literal, z. B.: TO_DATE('2026-06-25','YYYY-MM-DD').