Dans les environnements de développement collaboratif, rencontrer du code SQL complexe écrit par d'autres est inévitable. Les outils d’IA générative peuvent analyser et expliquer rapidement les requêtes SQL, en décomposant une logique complexe en composants compréhensibles. En utilisant ces assistants IA pour déchiffrer le code inconnu, vous pouvez réduire le temps d'apprentissage, améliorer la collaboration et adopter les meilleures pratiques des développeurs expérimentés.
Utilisation de l'IA générative pour mieux comprendre le SQL
Dans SAP HANA Cloud Central - SQL Console, il est désormais possible de laisser l'IA générative expliquer le code SQL dans SAP HANA Cloud Central - Console SQL. Dans la console SQL, l'IA générative explique les instructions SQL sélectionnées lorsque vous utilisez la fonction Expliquer l'instruction SQL à l'aide de l'IA, comme illustré dans l'image.

En tant que source, j'ai utilisé le code SQL généré par l'IA dans la leçon précédente. J'ai sélectionné toutes les instructions SQL et je laisse l'IA générative m'expliquer le code. L'instruction Explain SQL à l'aide de l'IA a généré une brève explication par instruction SQL. Le résultat est affiché ici :
1234567891011121314151617181920212223242526272829303132333435AI Explanation Result:
-- Create a new schema called "my_company" to logically group related tables.
CREATE SCHEMA "my_company";
-- Create a table named "job_titles" in the "my_company" schema to store job positions.
-- The table has a primary key column "job_title_id" and a required column "job_title_name".
CREATE COLUMN TABLE "my_company"."job_titles" (
"job_title_id" NVARCHAR(2) PRIMARY KEY,
"job_title_name" NVARCHAR(100) NOT NULL
);
-- Create a table named "departments" in the "my_company" schema to represent company departments.
-- The table has a primary key "department_id" and columns for department name and head.
CREATE COLUMN TABLE "my_company"."departments" (
"department_id" NVARCHAR(3) PRIMARY KEY,
"department_name" NVARCHAR(100),
"department_head" NVARCHAR(100)
);
-- Create a table named "employees" in the "my_company" schema to store employee information.
-- The table includes an auto-incrementing primary key "employee_id", employee names, department and
-- job references, and hire date.
-- The "department_id" column is a foreign key referencing the "departments" table.
-- The "job_title_id" column is a foreign key referencing the "job_titles" table.
CREATE COLUMN TABLE "my_company"."employees" (
"employee_id" INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
"first_name" NVARCHAR(50),
"last_name" NVARCHAR(50),
"department_id" NVARCHAR(3),
"job_title_id" NVARCHAR(2),
"hire_date" DATE,
FOREIGN KEY ("department_id") REFERENCES "my_company"."departments"("department_id"),
FOREIGN KEY ("job_title_id") REFERENCES "my_company"."job_titles"("job_title_id")
);
Dans cet exemple, les descriptions ajoutées par instruction SQL en tant que commentaire ont rendu l'ensemble du code plus facile à comprendre.
Génération d'un document de conception de modèle de données
À l'étape suivante, j'ai supprimé le code SQL de la réponse et demandé à Joule :
1234567891011121314Write me, in human readable natural language, a data model definition document from the following text:
Create a new schema called "my_company" to logically group related tables.
Create a table named "job_titles" in the "my_company" schema to store job positions. The table has a
primary key column "job_title_id" and a required column "job_title_name".
Create a table named "departments" in the "my_company" schema to represent company departments. The
table has a primary key "department_id" and columns for department name and head.
Create a table named "employees" in the "my_company" schema to store employee information. The table
includes an auto-incrementing primary key "employee_id", employee names, department and job references,
and hire date. The "department_id" column is a foreign key referencing the "departments" table. The
"job_title_id" column is a foreign key referencing the "job_titles" table.Joule a répondu par ce qui suit :

Définition du modèle de données : schéma my_company
Vue d'ensemble
Ce modèle de données définit la structure organisationnelle principale d'une société, en capturant des informations sur les postes, les services et les salariés. Il est conçu pour prendre en charge la gestion de la main-d'œuvre en établissant des relations claires entre les salariés, les services auxquels ils appartiennent et les intitulés de poste qu'ils détiennent.
Schéma
| Propriété | Détail |
|---|---|
| Nom du schéma | mon_entreprise |
| Objectif | Regroupement logique de toutes les tables liées aux données organisationnelles de l'entreprise et au personnel |
Tables
Tableau 1: job_title
Cette table sert de catalogue de référence pour tous les postes qui existent au sein de l'entreprise. Chaque enregistrement représente un rôle métier distinct qui peut être affecté à un ou plusieurs employés. Cela garantit que les désignations de poste sont standardisées et référencées de manière cohérente dans l'ensemble de l'organisation.
Column Name | Type de données | Contraintes | Description |
|---|---|---|---|
| job_title_id | INTEGER | Clé primaire | Identifiant unique pour chaque intitulé de poste |
| nom_titre_job | VARCHAR | NOT NULL | Nom ou étiquette du poste (par exemple, « Ingénieur logiciel », « Responsable RH ») |
Table : départements
Cette table représente les différentes entités organisationnelles ou secteurs d'activité au sein de l'entreprise. Chaque enregistrement de service capture son identité et son leadership, ce qui permet à l'organisation de mapper les employés à leurs unités d'affaires respectives.
Column Name | Type de données | Contraintes | Description |
|---|---|---|---|
| id_service | INTEGER | Clé primaire | Identifiant unique pour chaque service |
| nom_service | VARCHAR | NOT NULL | Nom officiel du service (p. ex., « Finance », « Ingénierie ») |
| département_responsable | VARCHAR | NULLABLE | Nom ou identifiant de la personne qui dirige le service |
Table : salariés
Il s'agit de la table centrale du modèle de données qui stocke tous les enregistrements des salariés. Elle relie chaque salarié au service et à l'intitulé de poste qui lui sont affectés, et suit la date à laquelle il a rejoint l'entreprise. La clé primaire à incrémentation automatique garantit que chaque employé reçoit un identifiant unique généré par le système sans saisie manuelle.
Column Name | Type de données | Contraintes | Description |
|---|---|---|---|
| ID_employé | INTEGER | Clé primaire, incrément automatique | Identificateur unique généré par le système pour chaque employé |
| prénom_prénom | VARCHAR | NOT NULL | Prénom du salarié |
| last_name | VARCHAR | NOT NULL | Nom de famille du salarié |
| id_service | INTEGER | Clé externe → services | Référence le service auquel le salarié appartient. |
| job_title_id | INTEGER | Clé externe → job_title | Référence le poste affecté au salarié |
| hire_date | DATE | NOT NULL | Date à laquelle le salarié a été officiellement embauché. |
Relations
| De la table | Colonne | Relation | Vers la table | Colonne |
|---|---|---|---|---|
| employés | id_service | De quelqu'un à un | services | id_service |
| employés | job_title_id | De quelqu'un à un | job_title | job_title_id |
Notes de conception clés
Les décisions de conception suivantes ont été prises :
- Incrément automatique pour l’identité de l’employé
- La colonne employee_id utilise un mécanisme d'incrémentation automatique, ce qui signifie que la base de données affecte automatiquement une nouvelle valeur numérique unique chaque fois qu'un enregistrement d'employé est inséré. Cela élimine la charge de travail liée à la gestion manuelle des ID uniques et évite les doublons.
- Intégrité référentielle via des clés étrangères
- Les colonnes depment_id et job_title_id de la table des salariés sont définies en tant que clés étrangères. Cela signifie que la base de données impose que toute valeur saisie dans ces colonnes doit déjà exister dans les services correspondants ou dans la table job_title, ce qui empêche les enregistrements orphelins ou incohérents.
- Regroupement logique au niveau du schéma
- Les trois tables sont placées dans le schéma my_company. Cela agit comme un espace de noms logique qui regroupe les tables liées, ce qui facilite la gestion des autorisations d'accès, évite les conflits de noms avec d'autres schémas et communique clairement que ces tables appartiennent au même domaine de gestion.

Résumé
Cette leçon a montré comment l'IA générative peut être utilisée pour expliquer le code SQL et comment Joule peut créer un document de définition de modèle de données à l'aide de l'explication du code SQL.