cql

CQL : langage de requête compilé

Qu’est-ce que cql ?

Faisant initialement partie de BaDaaS, CQL permet une persistance et une interrogation faciles et sûres des objets.

Il est construit sur gorm, une bibliothèque qui fournit en fait les fonctionnalités d'un ORM : mapper des objets aux tables de la base de données SQL. Bien que gorm fasse bien ce travail avec sa migration automatique, l'exécution de requêtes sur ces objets est quelque peu limitée, nous obligeant à écrire directement des requêtes SQL lorsqu'elles sont complexes. CQL cherche à remédier à ces limitations avec un système de requêtes qui :

• Est-il sûr au moment de la compilation : les requêtes sont validées au moment de la compilation pour éviter des erreurs telles que comparer des attributs de types différents, essayer d'utiliser des attributs ou naviguer dans des relations qui n'existent pas, utiliser des informations provenant de tables qui ne sont pas incluses dans la requête, etc. .; garantissant qu'une erreur d'exécution ne sera pas générée.
• Est simple à utiliser : l’utilisation de son système de requêtes ne nécessite pas de connaissance de bases de données, de langages SQL ou de concepts complexes. L'écriture de requêtes nécessite uniquement une programmation en Go et le résultat est facile à lire.
• Est conçu pour des applications réelles : le système de requêtes est conçu pour fonctionner correctement dans des cas réels où les requêtes sont complexes, nécessitent de naviguer dans plusieurs relations, d'effectuer plusieurs comparaisons, etc.
• Est conçu pour que les développeurs puissent se concentrer sur le modèle économique : ses requêtes permettent de récupérer facilement les relations du modèle pour appliquer la logique métier au modèle et il fournit des mécanismes pour éviter les erreurs dans la logique métier dues à des erreurs de chargement des informations depuis la base de données.
• Il est conçu pour des performances élevées : le système de requête évite autant que possible le recours à la réflexion et vise à ce que toutes les données de modèle nécessaires puissent être récupérées en une seule requête dans la base de données.

Langue	Requête
SQL	SÉLECTIONNER des villes.* DES villes INNER JOIN pays ON country.id = villes.country_id ET country.name = "France" OÙ villes.nom = "Paris"
GORM	db.Où( "villes.nom = ?", "Paris", ).Joint( "Pays", db.Où( "Pays.nom = ?", "France", ), ).Rechercher(&villes)
CQL	cql.Query[models.City]( base de données, conditions.City.Name.Is().Eq("Paris"), conditions.Ville.Pays( conditions.Country.Name.Is().Eq("France"), ), ).FindOne()

Cql est-il une copie de gorm-gen ?

Il est vrai que son objectif semble être le même :

API DAO 100 % sécurisée sans interface{}

Bien que gorm-gen fournisse une API plus structurée que gorm pour effectuer des requêtes, fournissant des méthodes telles que :

 Where ( conds ... gen . Condition ) IUserDo

on peut voir sur ces signatures que, par exemple, la méthode Where reçoit des paramètres de type gen.Condition. De cette manière, les conditions de différents modèles pourraient être mélangées sans générer d'erreur de compilation :

 u := query . User
c := query . Company
user , err := u . Where ( c . Name . Eq ( "franco" )). First ()

ce qui générerait une erreur d'exécution lors de l'exécution du SQL généré :

 SELECT * FROM `users` WHERE `companies`.`name` = "franco"
no such column: companies.name

De ce fait, cql décide d'aller plus loin dans la sécurité des types et de vérifier que les conditions sont du bon modèle, que les valeurs comparées sont du même type, que les modèles sont inclus dans la requête et plus encore, en s'assurant qu'une erreur d'exécution sera générée. ne pas être élevé.

Documentation

https://compiledquerylenguage.readthedocs.io/en/latest/

Contribuer

Consultez cette section pour consulter les directives de contribution cql.

Licence

CQL est sous licence Mozilla Public License version 2.0.