KEPLIN Docs

Typer som stöds

De sex databasmotorer en app kan ansluta till, fälten i var och en, vad varje motor klarar av, och verktygen för att skapa och ändra tabeller utan att lämna plattformen.

När du skapar en datakälla avgör fältet Typ allt annat: anslutningsfälten som formuläret visar, parametermarkörerna som SQL:en använder, och vad plattformen låter dig skapa i den databasen (vyer, procedurer, triggers). Den här sidan går igenom de sex typerna, en i taget.

Listan över databastyper i dialogen Ny datakälla: de sex motorer som stöds.
Listan över databastyper i dialogen Ny datakälla: de sex motorer som stöds.

Snabb överblick

Typ Ansluter till Standardport Särdrag
PostgreSQL PostgreSQL-server 5432 Reglaget Använd SSL
MySQL MySQL-server 3306 Reglaget Använd SSL
MariaDB MariaDB-server 3306 Reglaget Använd SSL
MS SQL Server Microsoft SQL Server 1433 Encrypt, Trust server certificate, Äldre TLS, Timeout för fråga (s)
Oracle Oracle-databas — (ingår i connect-strängen) Ett enda fält, Connect string
SQLite Lokal databas, i en fil — (ingen server) Inga autentiseringsuppgifter; databasen lever med appen

Nota

De fem första är externa databaser — dina egna servrar, som plattformen kontaktar över nätverket med de autentiseringsuppgifter du registrerar. SQLite är specialfallet: en databas i en fil, sparad tillsammans med själva appen.

PostgreSQL, MySQL och MariaDB

De tre delar samma formulär:

Fält Vad det är
Host Serverns adress (namn eller IP)
Port Kommer ifylld med motorns (5432 eller 3306)
Database Databasens namn inuti servern
Användare Kontot som plattformen ansluter med
Lösenord Kontots lösenord — det visas aldrig igen
Använd SSL Slår på kryptering av anslutningen, om servern kräver eller stöder det

Dica

Använd ett databaskonto som är dedikerat till appen, med behörigheter bara över det appen behöver. Alla frågor — från API:er, skript och konsolen — körs med det här kontot, och dess behörigheter är taket för vad appen kan göra.

MS SQL Server

Utöver Host, Port (1433), Database, Användare och Lösenord har SQL Server fyra egna alternativ:

Alternativ Vad det används till
Timeout för fråga (s) Största tid per fråga, i sekunder (kommer med 30). Höj den om du har långa stored procedures — annars dör de på halva vägen med timeout-fel.
Encrypt Krypterar anslutningen (kommer påslaget).
Trust server certificate Godtar serverns certifikat utan att validera det — typiskt på interna servrar med eget certifikat.
Äldre TLS (gammal SQL Server) Se nedan.

Formuläret förklarar självt när det sista ska slås på: ”Slå på äldre TLS om anslutningen till en gammal SQL Server (2008/2012) misslyckas med SSL/TLS-fel — det tillåter handskakning med gamla krypton och protokoll (och innebär att serverns certifikat måste litas på).”

De fält och reglage som är specifika för MS SQL Server
De fält och reglage som är specifika för MS SQL Server

Dica

Misslyckas anslutningen till en SQL Server 2008/2012 med SSL-meddelanden? Det är nästan alltid det här: slå på Äldre TLS och testa igen. Alternativet sänker säkerhetsnivån bara för den här anslutningen — det påverkar inte de andra datakällorna.

Oracle

Oracle klarar sig utan separat host och port — hela adressen ryms i ett fält:

Fält Vad det är
Connect string I formatet host:port/service_name — t.ex. ora.interno.exemplo.pt:1521/CRMPROD
Användare Oracle-schemat/kontot som plattformen ansluter med
Lösenord Kontots lösenord

Oracle-formuläret med Connect string ifylld
Oracle-formuläret med Connect string ifylld

Nota

I Oracle är att ansluta som en användare detsamma som att gå in i användarens schema — det schemats tabeller dyker upp i objektträdet utan prefix.

SQLite — databasen som lever med appen

SQLite är typen för data som hör till appen: prototyper, demos, en liten databas som inte motiverar en server. Det finns varken Host, Port, Användare eller Lösenord — det finns en fil, och det är plattformen som förvarar den:

  1. Välj SQLite i fältet Typ.
  2. Använd eventuellt Importera databas (valfritt) för att skicka in en fil .db, .sqlite eller .sqlite3 som du redan har.
  3. Tryck på Skapa. Som fältets hjälptext säger: ”Utan fil skapas en tom databas. Filen sparas tillsammans med appen — inga sökvägar att ange.”

När du väljer SQLite krymper formuläret till importfältet — ingen host och inga autentiseringsuppgifter
När du väljer SQLite krymper formuläret till importfältet — ingen host och inga autentiseringsuppgifter

Tre beteenden att känna till:

  • Skapa har ingen Testa anslutningen — filen finns ännu inte, det finns ingenting att testa. Knappen dyker upp efter att du sparat, vid redigering.
  • Redigering byter aldrig ut filen — filen är datakällan; att redigera anslutningen skapar varken en ny databas eller raderar data.
  • Att ta bort datakällan är att ta farväl av data — till skillnad från de externa typerna lever databasen här med appen.

Vad varje motor klarar av

Plattformen erbjuder bara det som motorn stöder — de alternativ som inte finns i en motor dyker inte upp i dess meny. Kartan:

Förmåga PostgreSQL MySQL MariaDB MS SQL Server Oracle SQLite
Vyer Ja Ja Ja Ja Ja Ja
Funktioner/procedurer Ja Ja Ja Ja Ja Nej
Triggers — tidpunkter BEFORE, AFTER, INSTEAD OF BEFORE, AFTER BEFORE, AFTER AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF
Trigger med flera händelser på en gång Ja Nej (en per händelse) Nej (en per händelse) Ja Ja Nej
Trigger ritad på den visuella canvasen Ja Ja Ja Ja Ja Nej (bara SQL)
Ändra typ eller nullbarhet på en befintlig kolumn Ja Ja Ja Ja Ja Nej
Fältet Schema (valfritt) på objekten Ja Ja Ja

Nota

I SQL Server finns inget BEFORE — motsvarigheten är INSTEAD OF. Och i SQLite kräver en ändring av typen på en befintlig kolumn att tabellen byggs om; det alternativet dyker inte upp.

Skapa och ändra objekt (DDL)

Du behöver inget annat verktyg för att arbeta med databasens struktur: menyn på varje datakälla i panelen Data skapar objekt, och trädet redigerar de befintliga. I samtliga fall genererar plattformen SQL för datakällans motor och kör den på riktigt i databasen.

Åtgärd Vad den gör
Ny tabell ”Definiera kolumnerna — vi genererar CREATE TABLE för motorn och kör den.” Kolumner med typ, Tillåter NULL, Primärnyckel (PK), Autoinkrement, och visningsnamn för apparna.
Redigera struktur (på en tabell) ”Ändra kolumner och index — genererar och kör motsvarande ALTER / CREATE INDEX.” Skapar och tar också bort index.
Ny vy Du skriver vyns SQL och den körs.
Ny funktion/procedur Du skriver SQL:en och den körs (i de motorer som stöder dem).
Ny trigger Grunduppgifter i modalen; flödet byggs sedan på den visuella canvasen.
Uppdatera objekten Läser om databasens struktur — använd den efter ändringar gjorda utanför plattformen.

Modalen Ny tabell: definiera kolumnerna, så genererar och kör plattformen CREATE TABLE
Modalen Ny tabell: definiera kolumnerna, så genererar och kör plattformen CREATE TABLE

Atenção

Det här är riktig DDL, i din riktiga databas — en DROP eller en ALTER här är lika slutgiltig som körd i vilken annan SQL-klient som helst. Och det fungerar bara om anslutningens Användare har behörighet att skapa och ändra objekt.

SQL-konsolen

Längst ned på varje datakällas skärm Modell bor SQL-konsolen: skriv till vänster, tryck på Kör, och resultaten dyker upp i en tabell (upp till 500 rader), med filter per kolumn. Redigeraren autokompletterar med datakällans tabeller och kolumner, och Visa data på vilken tabell som helst i trädet öppnar konsolen med en färdig select.

Visa data öppnar SQL-konsolen med frågan redan färdig — tabellens riktiga rader, under modellen.
Visa data öppnar SQL-konsolen med frågan redan färdig — tabellens riktiga rader, under modellen.

Konsolen är till för administratörer, och skrivoperationerna registreras i revisionsloggen — detaljerna finns på sidan Testa anslutningen och säkerhet.

Parametermarkörer per motor

När du skriver SQL i skript skickas värdena i en separat lista — aldrig klistrade in i satsen — och varje motor har sin egen markörsyntax:

Motor Markörer Exempel
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

I API:ernas SQL-steg behöver du inte den här tabellen: du skriver :nomeDoArg och plattformen sköter omvandlingen till den valda motorn. I Oracle: undvik att skicka datum som parameter — föredra literalen, t.ex. TO_DATE('2026-06-25','YYYY-MM-DD').