Types pris en charge

À la création d'un datasource, le champ Type décide de tout le reste : les champs de connexion que le formulaire affiche, les marqueurs de paramètres que le SQL utilise, et ce que la plateforme vous laisse créer sur cette base (vues, procédures, triggers). Cette page parcourt les six types, un par un.

#Vue rapide

Type	Se connecte à	Port par défaut	Particularités
PostgreSQL	Serveur PostgreSQL	5432	Interrupteur Utiliser SSL
MySQL	Serveur MySQL	3306	Interrupteur Utiliser SSL
MariaDB	Serveur MariaDB	3306	Interrupteur Utiliser SSL
MS SQL Server	Serveur Microsoft SQL Server	1433	Encrypt, Trust server certificate, TLS hérité, Timeout de requête (s)
Oracle	Base Oracle	— (elle va dans la connect string)	Un unique champ Connect string
SQLite	Base de données locale, dans un fichier	— (pas de serveur)	Sans identifiants ; la base vit avec l'app

#PostgreSQL, MySQL et MariaDB

Les trois partagent le même formulaire :

Champ	Ce que c'est
Host	Adresse du serveur (nom ou IP)
Port	Il arrive rempli avec celui du moteur (5432 ou 3306)
Database	Le nom de la base de données à l'intérieur du serveur
Utilisateur	Le compte avec lequel la plateforme se connecte
Mot de passe	Le mot de passe de ce compte — il n'est jamais réaffiché
Utiliser SSL	Active le chiffrement de la connexion, si le serveur l'exige ou le prend en charge

#MS SQL Server

En plus de Host, Port (1433), Database, Utilisateur et Mot de passe, SQL Server apporte quatre options qui lui sont propres :

Option	À quoi elle sert
Timeout de requête (s)	Temps maximum de chaque requête, en secondes (30 par défaut). Augmentez-le si vous avez des procédures stockées longues — en dessous, elles meurent à mi-chemin avec une erreur de timeout.
Encrypt	Chiffre la connexion (activé par défaut).
Trust server certificate	Accepte le certificat du serveur sans le valider — typique sur des serveurs internes avec un certificat maison.
TLS hérité (ancien SQL Server)	Voir plus bas.

Le formulaire lui-même explique quand activer la dernière : « Activez le TLS hérité si la connexion à un ancien SQL Server (2008/2012) échoue avec des erreurs SSL/TLS — il autorise le handshake avec d'anciens chiffrements/protocoles (implique de faire confiance au certificat du serveur). »

#Oracle

Oracle se passe d'un host et d'un port séparés — l'adresse tient tout entière dans un champ :

Champ	Ce que c'est
Connect string	Au format host:port/service_name — ex. : ora.interne.exemple.fr:1521/CRMPROD
Utilisateur	Le schéma/compte Oracle avec lequel la plateforme se connecte
Mot de passe	Le mot de passe de ce compte

#SQLite — la base de données qui vit avec l'app

SQLite est le type pour les données qui appartiennent à l'app : prototypes, démos, une petite base qui ne justifie pas un serveur. Il n'y a ni Host, ni Port, ni Utilisateur, ni Mot de passe — il y a un fichier, et c'est la plateforme qui le conserve :

1. Choisissez SQLite dans le champ Type.
2. Éventuellement, utilisez Importer une base de données (facultatif) pour envoyer un fichier .db, .sqlite ou .sqlite3 que vous avez déjà.
3. Cliquez sur Créer. Comme le dit l'aide du champ : « Sans fichier, une base de données vide est créée. Le fichier est stocké avec l'app — aucun chemin à indiquer. »

Trois comportements à connaître :

• Créer n'a pas de Tester la connexion — le fichier n'existe pas encore, il n'y a rien à tester. Le bouton apparaît après l'enregistrement, en modification.
• Modifier ne remplace jamais le fichier — le fichier est le datasource ; modifier la connexion ne crée pas une nouvelle base et n'efface pas de données.
• Supprimer le datasource dit adieu aux données — contrairement aux types externes, ici la base vit avec l'app.

#Ce que chaque moteur sait faire

La plateforme ne vous offre que ce que le moteur prend en charge — les options qui n'existent pas sur un moteur n'apparaissent pas dans son menu. La carte :

Capacité	PostgreSQL	MySQL	MariaDB	MS SQL Server	Oracle	SQLite
Vues	Oui	Oui	Oui	Oui	Oui	Oui
Fonctions / procédures	Oui	Oui	Oui	Oui	Oui	Non
Triggers — moments	BEFORE, AFTER, INSTEAD OF	BEFORE, AFTER	BEFORE, AFTER	AFTER, INSTEAD OF	BEFORE, AFTER, INSTEAD OF	BEFORE, AFTER, INSTEAD OF
Trigger avec plusieurs événements d'un coup	Oui	Non (un par événement)	Non (un par événement)	Oui	Oui	Non
Trigger dessiné dans le canvas visuel	Oui	Oui	Oui	Oui	Oui	Non (SQL seulement)
Modifier le type/la nullité d'une colonne existante	Oui	Oui	Oui	Oui	Oui	Non
Champ Schéma (facultatif) sur les objets	Oui	—	—	Oui	Oui	—

#Créer et modifier des objets (DDL)

Vous n'avez pas besoin d'un autre outil pour travailler la structure de la base : le menu ⋯ de chaque datasource dans le panneau Données crée des objets, et l'arborescence modifie ceux qui existent. Dans tous les cas, la plateforme génère le SQL pour le moteur du datasource et l'exécute pour de vrai dans la base de données.

Action	Ce qu'elle fait
Nouvelle table	« Définissez les colonnes — nous générons le CREATE TABLE pour le moteur et nous l'exécutons. » Des colonnes avec type, Autorise NULL, Clé primaire (PK), Auto-incrément, et un nom convivial pour les apps.
Modifier la structure (sur une table)	« Modifiez les colonnes et les index. Génère et exécute le ALTER / CREATE INDEX correspondant. » Crée et supprime aussi des index.
Nouvelle vue	Vous écrivez le SQL de la vue et cela s'exécute.
Nouvelle fonction / procédure	Vous écrivez le SQL et cela s'exécute (sur les moteurs qui les prennent en charge).
Nouveau trigger	Données initiales dans la fenêtre ; le flux se construit ensuite dans le canvas visuel.
Actualiser les objets	Relit la structure de la base — à utiliser après des changements faits hors de la plateforme.

#La Console SQL

Au bas de l'écran Modèle de chaque datasource vit la Console SQL : écrivez à gauche, cliquez sur Exécuter, et les résultats apparaissent en tableau (jusqu'à 500 lignes), avec des filtres par colonne. L'éditeur complète automatiquement avec les tables et les colonnes du datasource, et le Voir les données de n'importe quelle table de l'arborescence ouvre la console avec un select tout prêt.

La console est réservée aux administrateurs, et les opérations d'écriture sont enregistrées dans l'audit — les détails sont sur la page Tester la connexion et sécurité.

#Marqueurs de paramètres par moteur

Quand vous écrivez du SQL dans des scripts, les valeurs passent dans une liste à part — jamais collées dans la phrase — et chaque moteur a sa syntaxe de marqueur :

Moteur	Marqueurs	Exemple
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 = ?