KEPLIN Docs

Tuetut tyypit

Kuusi tietokantamoottoria, joihin sovellus voi yhdistää, kunkin kentät, mitä kukin moottori osaa tehdä, ja työkalut taulujen luontiin ja muuttamiseen poistumatta alustalta.

Tietolähdettä luotaessa kenttä Tyyppi ratkaisee kaiken muun: mitkä yhteyskentät lomake näyttää, mitä parametrimerkintöjä SQL käyttää ja mitä alusta antaa sinun luoda siihen tietokantaan (näkymiä, proseduureja, triggereitä). Tämä sivu käy kuusi tyyppiä läpi yksi kerrallaan.

Tietokantatyyppien lista Uusi tietolähde -valintaikkunassa: kuusi tuettua moottoria.
Tietokantatyyppien lista Uusi tietolähde -valintaikkunassa: kuusi tuettua moottoria.

Pikakatsaus

Tyyppi Yhdistää Oletusportti Erityispiirteet
PostgreSQL PostgreSQL-palvelimeen 5432 Kytkin Käytä SSL:ää
MySQL MySQL-palvelimeen 3306 Kytkin Käytä SSL:ää
MariaDB MariaDB-palvelimeen 3306 Kytkin Käytä SSL:ää
MS SQL Server Microsoft SQL Server -palvelimeen 1433 Encrypt, Trust server certificate, vanha TLS, Kyselyn aikakatkaisu (s)
Oracle Oracle-tietokantaan — (menee connect stringissä) Yksi ainoa kenttä Connect string
SQLite Paikalliseen tiedostotietokantaan — (ei palvelinta) Ei tunnistetietoja; tietokanta elää sovelluksen mukana

Nota

Viisi ensimmäistä ovat ulkoisia tietokantoja — sinun palvelimiasi, joihin alusta ottaa yhteyttä verkon yli rekisteröimilläsi tunnistetiedoilla. SQLite on erikoistapaus: tiedostossa oleva tietokanta, joka tallennetaan itse sovelluksen mukana.

PostgreSQL, MySQL ja MariaDB

Näillä kolmella on sama lomake:

Kenttä Mikä se on
Host Palvelimen osoite (nimi tai IP)
Portti Tulee valmiiksi täytettynä moottorin oletuksella (5432 tai 3306)
Database Tietokannan nimi palvelimen sisällä
Käyttäjä Tili, jolla alusta yhdistää
Salasana Kyseisen tilin salasana — sitä ei näytetä enää uudelleen
Käytä SSL:ää Ottaa yhteyden salauksen käyttöön, jos palvelin sitä vaatii tai tukee

Dica

Käytä tietokantatiliä, joka on omistettu sovellukselle ja jolla on oikeudet vain siihen, mitä sovellus tarvitsee. Kaikki kyselyt — API:ista, skripteistä ja konsolista — ajetaan tällä tilillä, ja sen oikeudet ovat katto sille, mitä sovellus pystyy tekemään.

MS SQL Server

Kenttien Host, Portti (1433), Database, Käyttäjä ja Salasana lisäksi SQL Server tuo neljä omaa valintaa:

Valinta Mihin se on
Kyselyn aikakatkaisu (s) Kunkin kyselyn enimmäisaika sekunteina (oletus 30). Nosta sitä, jos sinulla on pitkiä stored procedureja — muuten ne kuolevat kesken aikakatkaisuvirheeseen.
Encrypt Salaa yhteyden (päällä oletuksena).
Trust server certificate Hyväksyy palvelimen varmenteen validoimatta sitä — tyypillistä sisäisillä palvelimilla, joilla on oma varmenne.
Vanha TLS (vanha SQL Server) Katso alta.

Lomake itse kertoo, milloin viimeinen kytketään päälle: ”Ota käyttöön vanha TLS, jos yhteys vanhaan SQL Serveriin (2008/2012) epäonnistuu SSL/TLS-virheisiin — se sallii kättelyn vanhoilla salauksilla ja protokollilla (edellyttää palvelimen varmenteeseen luottamista).”

MS SQL Serverin omat kentät ja kytkimet
MS SQL Serverin omat kentät ja kytkimet

Dica

Epäonnistuuko yhteys SQL Server 2008/2012 -palvelimeen SSL-viesteillä? Kyse on lähes aina tästä: ota käyttöön vanha TLS ja testaa uudelleen. Valinta laskee turvatasoa vain tässä yhteydessä — se ei vaikuta muihin tietolähteisiin.

Oracle

Oracle ei tarvitse erillistä hostia ja porttia — koko osoite menee yhteen kenttään:

Kenttä Mikä se on
Connect string Muodossa host:port/service_name — esim. ora.sisainen.esimerkki.fi:1521/CRMPROD
Käyttäjä Oracle-skeema tai -tili, jolla alusta yhdistää
Salasana Kyseisen tilin salasana

Oracle-lomake Connect string täytettynä
Oracle-lomake Connect string täytettynä

Nota

Oraclessa käyttäjänä yhdistäminen tarkoittaa hänen skeemaansa menemistä — kyseisen skeeman taulut näkyvät objektipuussa ilman etuliitettä.

SQLite — tietokanta, joka elää sovelluksen mukana

SQLite on tyyppi datalle, joka kuuluu sovellukselle: prototyypit, demot, pieni tietokanta jolle ei kannata pystyttää palvelinta. Ei ole Hostia, Porttia, Käyttäjää eikä Salasanaa — on tiedosto, ja alusta tallentaa sen:

  1. Valitse kentässä Tyyppi vaihtoehto SQLite.
  2. Käytä halutessasi kohtaa Tuo tietokanta (valinnainen) lähettääksesi valmiin .db-, .sqlite- tai .sqlite3-tiedoston.
  3. Paina Luo. Kuten kentän ohje sanoo: ”Ilman tiedostoa luodaan tyhjä tietokanta. Tiedosto tallennetaan sovelluksen mukana — polkuja ei tarvitse antaa.”

SQLiten valinta kutistaa lomakkeen pelkäksi tuontikentäksi — ei hostia eikä tunnistetietoja
SQLiten valinta kutistaa lomakkeen pelkäksi tuontikentäksi — ei hostia eikä tunnistetietoja

Kolme käyttäytymistä, jotka on hyvä tietää:

  • Luonnissa ei ole Testaa yhteys -painiketta — tiedostoa ei ole vielä olemassa, joten testattavaa ei ole. Painike ilmestyy tallennuksen jälkeen, muokkaustilassa.
  • Muokkaus ei koskaan vaihda tiedostoa — tiedosto on tietolähde; yhteyden muokkaaminen ei luo uutta tietokantaa eikä poista dataa.
  • Tietolähteen poistaminen hyvästelee datan — toisin kuin ulkoisissa tyypeissä, täällä tietokanta elää sovelluksen mukana.

Mitä kukin moottori osaa tehdä

Alusta tarjoaa vain sitä, mitä moottori tukee — valinnat, joita moottorissa ei ole, eivät ilmesty sen valikkoon. Kartta:

Ominaisuus PostgreSQL MySQL MariaDB MS SQL Server Oracle SQLite
Näkymät Kyllä Kyllä Kyllä Kyllä Kyllä Kyllä
Funktiot / proseduurit Kyllä Kyllä Kyllä Kyllä Kyllä Ei
Triggerit — ajankohdat BEFORE, AFTER, INSTEAD OF BEFORE, AFTER BEFORE, AFTER AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF BEFORE, AFTER, INSTEAD OF
Triggeri, jossa monta tapahtumaa kerralla Kyllä Ei (yksi tapahtumaa kohti) Ei (yksi tapahtumaa kohti) Kyllä Kyllä Ei
Visuaalisella canvasilla suunniteltu triggeri Kyllä Kyllä Kyllä Kyllä Kyllä Ei (vain SQL)
Olemassa olevan sarakkeen tyypin tai nulliuden muutos Kyllä Kyllä Kyllä Kyllä Kyllä Ei
Kenttä Skeema (valinnainen) objekteissa Kyllä Kyllä Kyllä

Nota

SQL Serverissä ei ole BEFORE-ajankohtaa — vastine on INSTEAD OF. Ja SQLitessä olemassa olevan sarakkeen tyypin muuttaminen pakottaa luomaan taulun uudelleen; valintaa ei näytetä.

Objektien luonti ja muuttaminen (DDL)

Et tarvitse toista työkalua tietokannan rakenteen työstämiseen: kunkin tietolähteen valikko paneelissa Data luo objekteja, ja puu muokkaa olemassa olevia. Kaikissa tapauksissa alusta luo SQL:n tietolähteen moottorille ja suorittaa sen oikeasti tietokannassa.

Toiminto Mitä se tekee
Uusi taulu ”Määrittele sarakkeet — luomme CREATE TABLE -lauseen moottorille ja suoritamme sen.” Sarakkeissa tyyppi, Sallii NULL-arvon, Pääavain (PK), Automaattinen kasvatus sekä selkonimi sovelluksille.
Muokkaa rakennetta (taulussa) ”Muuta sarakkeita ja indeksejä — luo ja suorittaa vastaavan ALTER- / CREATE INDEX -lauseen.” Luo ja poistaa myös indeksejä.
Uusi näkymä Kirjoitat näkymän SQL:n ja suoritat sen.
Uusi funktio / proseduuri Kirjoitat SQL:n ja suoritat sen (niissä moottoreissa, jotka tukevat näitä).
Uusi triggeri Perustiedot modaalissa; kulku rakennetaan seuraavaksi visuaalisella canvasilla.
Päivitä objektit Lukee tietokannan rakenteen uudelleen — käytä alustan ulkopuolella tehtyjen muutosten jälkeen.

Uusi taulu -modaali: määrittele sarakkeet, ja alusta luo ja suorittaa CREATE TABLE -lauseen
Uusi taulu -modaali: määrittele sarakkeet, ja alusta luo ja suorittaa CREATE TABLE -lauseen

Atenção

Tämä on oikeaa DDL:ää sinun oikeassa tietokannassasi — DROP tai ALTER täällä on yhtä lopullinen kuin missä tahansa muussa SQL-asiakkaassa suoritettuna. Ja se onnistuu vain, jos yhteyden Käyttäjällä on oikeudet luoda ja muuttaa objekteja.

SQL-konsoli

Kunkin tietolähteen Malli-näytön alalaidassa asuu SQL-konsoli: kirjoita vasemmalle, paina Suorita, ja tulokset ilmestyvät taulukkona (enintään 500 riviä), sarakekohtaisin suodattimin. Editori täydentää automaattisesti tietolähteen tauluilla ja sarakkeilla, ja minkä tahansa puun taulun Näytä data avaa konsolin valmiilla select-lauseella.

Näytä data avaa SQL-konsolin kysely valmiiksi tehtynä — taulun oikeat rivit mallin alapuolella.
Näytä data avaa SQL-konsolin kysely valmiiksi tehtynä — taulun oikeat rivit mallin alapuolella.

Konsoli on ylläpitäjiä varten, ja kirjoitusoperaatiot kirjautuvat auditointiin — yksityiskohdat ovat sivulla Yhteyden testaus ja tietoturva.

Parametrimerkinnät moottoreittain

Kun kirjoitat SQL:ää skripteihin, arvot kulkevat erillisessä listassa — ei koskaan lauseeseen liimattuna — ja jokaisella moottorilla on oma merkintänsä:

Moottori Merkinnät Esimerkki
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

API:iden SQL-vaiheissa et tarvitse tätä taulukkoa: kirjoitat :argNimi, ja alusta hoitaa muunnoksen valitulle moottorille. Oraclessa vältä päivämäärien välittämistä parametrina — suosi literaalia, esim. TO_DATE('2026-06-25','YYYY-MM-DD').