KEPLIN Docs

Støttede typer

De seks databasemotorene en app kan koble til, feltene til hver av dem, hva hver motor kan gjøre, og verktøyene for å opprette og endre tabeller uten å forlate plattformen.

Når du oppretter en datakilde, avgjør feltet Type alt det andre: tilkoblingsfeltene skjemaet viser, parametermarkørene SQL-en bruker, og hva plattformen lar deg opprette i den basen (visninger, prosedyrer, triggere). Denne siden går gjennom de seks typene, én for én.

Listen over databasetyper i dialogen Ny datakilde: de seks støttede motorene.
Listen over databasetyper i dialogen Ny datakilde: de seks støttede motorene.

Rask oversikt

Type Kobler til Standardport Særtrekk
PostgreSQL PostgreSQL-server 5432 Bryteren Bruk SSL
MySQL MySQL-server 3306 Bryteren Bruk SSL
MariaDB MariaDB-server 3306 Bryteren Bruk SSL
MS SQL Server Microsoft SQL Server 1433 Encrypt, Trust server certificate, eldre TLS, Tidsavbrudd for spørring (s)
Oracle Oracle-base — (går i connect-strengen) Ett enkelt felt, Connect string
SQLite Lokal database, i en fil — (ingen server) Ingen legitimasjon; basen lever sammen med appen

Nota

De fem første er eksterne databaser — dine egne servere, som plattformen kontakter over nettet med legitimasjonen du registrerer. SQLite er spesialtilfellet: en database i en fil, lagret sammen med selve appen.

PostgreSQL, MySQL og MariaDB

De tre deler det samme skjemaet:

Felt Hva det er
Host Adressen til serveren (navn eller IP)
Port Kommer utfylt med motorens egen (5432 eller 3306)
Database Navnet på databasen inne i serveren
Bruker Kontoen plattformen kobler seg til med
Passord Passordet til den kontoen — det vises aldri igjen
Bruk SSL Slår på kryptering av tilkoblingen, hvis serveren krever eller støtter det

Dica

Bruk en databasekonto som er dedikert til appen, med rettigheter bare til det appen trenger. Alle spørringene — fra API-er, skript og konsollen — kjører med denne kontoen, og rettighetene dens er taket for hva appen får til.

MS SQL Server

I tillegg til Host, Port (1433), Database, Bruker og Passord har SQL Server fire egne valg:

Valg Hva det er til for
Tidsavbrudd for spørring (s) Maksimal tid for hver spørring, i sekunder (står til 30). Sett den opp hvis du har lange stored procedures — under det dør de på halvveien med tidsavbruddsfeil.
Encrypt Krypterer tilkoblingen (er på fra start).
Trust server certificate Godtar sertifikatet til serveren uten å validere det — typisk på interne servere med eget sertifikat.
Eldre TLS (gammel SQL Server) Se nedenfor.

Skjemaet forklarer selv når du skal slå på den siste: «Slå på eldre TLS hvis tilkoblingen til en gammel SQL Server (2008/2012) feiler med SSL/TLS-feil — det tillater håndtrykk med gamle chiffer og protokoller (innebærer at du stoler på sertifikatet til serveren).»

Feltene og bryterne som er spesifikke for MS SQL Server
Feltene og bryterne som er spesifikke for MS SQL Server

Dica

Feiler tilkoblingen til en SQL Server 2008/2012 med SSL-meldinger? Det er nesten alltid dette: slå på Eldre TLS og test på nytt. Valget senker sikkerhetsnivået bare for denne tilkoblingen — det påvirker ikke de andre datakildene.

Oracle

Oracle klarer seg uten separat host og port — hele adressen går i ett felt:

Felt Hva det er
Connect string På formen host:port/service_name — f.eks. ora.interno.exemplo.pt:1521/CRMPROD
Bruker Oracle-skjemaet/kontoen plattformen kobler seg til med
Passord Passordet til den kontoen

Oracle-skjemaet med Connect string fylt ut
Oracle-skjemaet med Connect string fylt ut

Nota

I Oracle er det å koble seg til som en bruker det samme som å gå inn i skjemaet hans — tabellene i det skjemaet dukker opp i objekttreet uten prefiks.

SQLite — databasen som lever sammen med appen

SQLite er typen for data som hører til appen: prototyper, demoer, en liten base som ikke rettferdiggjør en server. Det finnes verken Host, Port, Bruker eller Passord — det finnes en fil, og det er plattformen som tar vare på den:

  1. Velg SQLite i feltet Type.
  2. Bruk eventuelt Importer database (valgfritt) for å sende inn en .db-, .sqlite- eller .sqlite3-fil du allerede har.
  3. Trykk på Opprett. Som hjelpeteksten på feltet sier: «Uten fil opprettes en tom database. Filen lagres sammen med appen — ingen stier å oppgi.»

Når du velger SQLite, krymper skjemaet til importfeltet — uten host og uten legitimasjon
Når du velger SQLite, krymper skjemaet til importfeltet — uten host og uten legitimasjon

Tre oppførsler du bør kjenne til:

  • Opprettelse har ingen Test tilkoblingen — filen finnes ennå ikke, det er ingenting å teste. Knappen dukker opp etter at du har lagret, ved redigering.
  • Redigering bytter aldri filen — filen er datakilden; å redigere tilkoblingen oppretter verken en ny base eller sletter data.
  • Å slette datakilden er å ta farvel med dataene — i motsetning til de eksterne typene lever basen her sammen med appen.

Hva hver motor kan gjøre

Plattformen tilbyr deg bare det motoren støtter — valgene som ikke finnes i en motor dukker ikke opp i menyen dens. Kartet:

Evne PostgreSQL MySQL MariaDB MS SQL Server Oracle SQLite
Visninger Ja Ja Ja Ja Ja Ja
Funksjoner / prosedyrer Ja Ja Ja Ja Ja Nei
Triggere — tidspunkter BEFORE, AFTER, INSTEAD OF BEFORE, AFTER BEFORE, AFTER AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF
Trigger med flere hendelser på én gang Ja Nei (én per hendelse) Nei (én per hendelse) Ja Ja Nei
Trigger tegnet på det visuelle canvaset Ja Ja Ja Ja Ja Nei (kun SQL)
Endre type/nullbarhet på en kolonne som finnes Ja Ja Ja Ja Ja Nei
Feltet Skjema (valgfritt) på objektene Ja Ja Ja

Nota

I SQL Server finnes ikke BEFORE — det tilsvarende er INSTEAD OF. Og i SQLite krever det å endre typen på en kolonne som finnes at tabellen bygges opp på nytt; valget dukker ikke opp.

Opprette og endre objekter (DDL)

Du trenger ikke et annet verktøy for å jobbe med strukturen i basen: menyen på hver datakilde i panelet Data oppretter objekter, og treet redigerer dem som finnes. I alle tilfeller genererer plattformen SQL for motoren til datakilden og kjører den på ordentlig i databasen.

Handling Hva den gjør
Ny tabell «Definer kolonnene — vi genererer CREATE TABLE for motoren og kjører den.» Kolonner med type, Tillat NULL, Primærnøkkel (PK), Autoinkrement, og visningsnavn for appene.
Rediger struktur (på en tabell) «Endre kolonner og indekser — genererer og kjører tilsvarende ALTER / CREATE INDEX.» Den oppretter og sletter også indekser.
Ny visning Du skriver SQL-en for visningen, og den kjøres.
Ny funksjon / prosedyre Du skriver SQL-en, og den kjøres (i motorene som støtter det).
Ny trigger Innledende data i modalen; flyten bygges etterpå på det visuelle canvaset.
Oppdater objektene Leser strukturen i basen på nytt — bruk den etter endringer gjort utenfor plattformen.

Modalen Ny tabell: du definerer kolonnene, og plattformen genererer og kjører CREATE TABLE
Modalen Ny tabell: du definerer kolonnene, og plattformen genererer og kjører CREATE TABLE

Atenção

Dette er ekte DDL, i din ekte database — et DROP eller et ALTER her er like endelig som kjørt fra en hvilken som helst annen SQL-klient. Og det virker bare hvis Bruker i tilkoblingen har rettigheter til å opprette og endre objekter.

SQL-konsollen

Nederst på skjermen Modell for hver datakilde lever SQL-konsoll: skriv til venstre, trykk på Kjør, og resultatene dukker opp i en tabell (opptil 500 rader), med filtre per kolonne. Editoren fullfører automatisk med tabellene og kolonnene fra datakilden, og Vis data på en hvilken som helst tabell i treet åpner konsollen med en ferdig select.

Vis data åpner SQL-konsollen med spørringen allerede kjørt — de virkelige radene i tabellen, under modellen.
Vis data åpner SQL-konsollen med spørringen allerede kjørt — de virkelige radene i tabellen, under modellen.

Konsollen er for administratorer, og skriveoperasjonene registreres i revisjonen — detaljene står på siden Teste tilkoblingen og sikkerhet.

Parametermarkører per motor

Når du skriver SQL i skript, sendes verdiene i en egen liste — aldri limt inn i setningen — og hver motor har sin egen markørsyntaks:

Motor Markører Eksempel
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 SQL-stegene i API-ene trenger du ikke denne tabellen: du skriver :nomeDoArg, og plattformen tar seg av konverteringen til motoren du valgte. I Oracle bør du unngå å sende datoer som parameter — bruk heller literalen, f.eks.: TO_DATE('2026-06-25','YYYY-MM-DD').