Ondersteunde types

Bij het aanmaken van een datasource bepaalt het veld Type al de rest: de verbindingsvelden die het formulier toont, de parametermarkeringen die de SQL gebruikt, en wat het platform u in die database laat aanmaken (views, procedures, triggers). Deze pagina loopt de zes types één voor één langs.

#Snel overzicht

Type	Verbindt met	Standaardpoort	Bijzonderheden
PostgreSQL	PostgreSQL-server	5432	Schakelaar SSL gebruiken
MySQL	MySQL-server	3306	Schakelaar SSL gebruiken
MariaDB	MariaDB-server	3306	Schakelaar SSL gebruiken
MS SQL Server	Microsoft SQL Server	1433	Encrypt, Trust server certificate, verouderde TLS, Time-out van de query (s)
Oracle	Oracle-database	— (zit in de connect string)	Eén enkel veld Connect string
SQLite	Lokale database, in een bestand	— (geen server)	Geen inloggegevens; de database leeft met de app mee

#PostgreSQL, MySQL en MariaDB

Alle drie delen hetzelfde formulier:

Veld	Wat het is
Host	Adres van de server (naam of IP)
Poort	Komt ingevuld met die van de engine (5432 of 3306)
Database	De naam van de database binnen de server
Gebruiker	Het account waarmee het platform verbinding maakt
Wachtwoord	Het wachtwoord van dat account — het wordt nooit meer getoond
SSL gebruiken	Schakelt de versleuteling van de verbinding in, als de server die vereist of ondersteunt

#MS SQL Server

Naast Host, Poort (1433), Database, Gebruiker en Wachtwoord brengt SQL Server vier eigen opties mee:

Optie	Waar die voor dient
Time-out van de query (s)	Maximale tijd per query, in seconden (staat op 30). Zet hem hoger als u lange stored procedures hebt — daaronder sterven ze halverwege met een time-outfout.
Encrypt	Versleutelt de verbinding (staat aan).
Trust server certificate	Aanvaardt het certificaat van de server zonder het te valideren — typisch bij interne servers met een eigen certificaat.
Verouderde TLS (oude SQL Server)	Zie hieronder.

Het formulier legt zelf uit wanneer u de laatste inschakelt: "Schakel verouderde TLS in als de verbinding met een oude SQL Server (2008/2012) mislukt met SSL/TLS-fouten — dat maakt de handshake met oude cijfers/protocollen mogelijk (en betekent dat u het certificaat van de server vertrouwt)."

#Oracle

Oracle heeft geen aparte host en poort nodig — het adres gaat volledig in één veld:

Veld	Wat het is
Connect string	In de vorm host:port/service_name — bijv.: ora.intern.voorbeeld.nl:1521/CRMPROD
Gebruiker	Het Oracle-schema/account waarmee het platform verbinding maakt
Wachtwoord	Het wachtwoord van dat account

#SQLite — de database die met de app meeleeft

SQLite is het type voor gegevens die bij de app horen: prototypes, demo's, een kleine database die geen server rechtvaardigt. Er is geen Host, Poort, Gebruiker of Wachtwoord — er is een bestand, en het platform is wat het bewaart:

1. Kies SQLite in het veld Type.
2. Gebruik eventueel Database importeren (optioneel) om een bestand .db, .sqlite of .sqlite3 te sturen dat u al hebt.
3. Klik op Aanmaken. Zoals de hulptekst van het veld zegt: "Zonder bestand wordt er een lege database aangemaakt. Het bestand wordt bij de app bewaard — er zijn geen paden in te vullen."

Drie gedragingen om te kennen:

• Aanmaken heeft geen Verbinding testen — het bestand bestaat nog niet, er valt niets te testen. De knop verschijnt na het opslaan, bij het bewerken.
• Bewerken wisselt het bestand nooit om — het bestand is de datasource; de verbinding bewerken maakt geen nieuwe database aan en wist geen gegevens.
• De datasource verwijderen neemt afscheid van de gegevens — anders dan bij de externe types leeft de database hier met de app mee.

#Wat elke engine kan

Het platform biedt u alleen wat de engine ondersteunt — de opties die in een engine niet bestaan, verschijnen niet in het menu ervan. De kaart:

Mogelijkheid	PostgreSQL	MySQL	MariaDB	MS SQL Server	Oracle	SQLite
Views	Ja	Ja	Ja	Ja	Ja	Ja
Functies / procedures	Ja	Ja	Ja	Ja	Ja	Nee
Triggers — momenten	BEFORE, AFTER, INSTEAD OF	BEFORE, AFTER	BEFORE, AFTER	AFTER, INSTEAD OF	BEFORE, AFTER, INSTEAD OF	BEFORE, AFTER, INSTEAD OF
Trigger met meerdere gebeurtenissen tegelijk	Ja	Nee (één per gebeurtenis)	Nee (één per gebeurtenis)	Ja	Ja	Nee
Trigger getekend in het visuele canvas	Ja	Ja	Ja	Ja	Ja	Nee (alleen SQL)
Type/nullability van een bestaande kolom wijzigen	Ja	Ja	Ja	Ja	Ja	Nee
Veld Schema (optioneel) bij de objecten	Ja	—	—	Ja	Ja	—

#Objecten aanmaken en wijzigen (DDL)

U hebt geen ander gereedschap nodig om aan de structuur van de database te werken: het menu ⋯ van elke datasource in het paneel Data maakt objecten aan, en de boom bewerkt de bestaande. In alle gevallen genereert het platform de SQL voor de engine van de datasource en voert die echt uit op de database.

Actie	Wat die doet
Nieuwe tabel	"Bepaal de kolommen — wij genereren de CREATE TABLE voor de engine en voeren die uit." Kolommen met type, NULL toegestaan, Primaire sleutel (PK), Auto-increment, en een weergavenaam voor de apps.
Structuur bewerken (op een tabel)	"Wijzig kolommen en indexen — genereert en voert de bijbehorende ALTER / CREATE INDEX uit." Maakt ook indexen aan en verwijdert ze.
Nieuwe view	U schrijft de SQL van de view en die wordt uitgevoerd.
Nieuwe functie / procedure	U schrijft de SQL en die wordt uitgevoerd (in de engines die ze ondersteunen).
Nieuwe trigger	Beginwaarden in het modale venster; de flow bouwt u daarna in het visuele canvas.
Objecten vernieuwen	Leest de structuur van de database opnieuw — gebruik dit na wijzigingen die buiten het platform zijn gedaan.

#De SQL-console

Onderaan het scherm Model van elke datasource leeft de SQL-console: schrijf links, klik op Uitvoeren, en de resultaten verschijnen in een tabel (tot 500 rijen), met filters per kolom. De editor vult automatisch aan met de tabellen en kolommen van de datasource, en het Gegevens bekijken van elke tabel in de boom opent de console met een select al klaar.

De console is voor beheerders, en de schrijfbewerkingen worden in de audit vastgelegd — de details staan op de pagina De verbinding testen en beveiliging.

#Parametermarkeringen per engine

Wanneer u SQL in scripts schrijft, gaan de waarden in een aparte lijst mee — nooit in de zin geplakt — en elke engine heeft zijn eigen syntaxis van markeringen:

Engine	Markeringen	Voorbeeld
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 = ?