SQL Server
Les bases d’INSERT dans SQL Server
Apprenez à insérer une ou plusieurs lignes dans SQL Server avec une liste de colonnes explicite et une vérification par SELECT.
Dans cet article
Après avoir appris à lire des lignes avec votre première requête SELECT, vous pouvez apprendre à en ajouter. SQL Server utilise INSERT pour ajouter des données à une table. Cette leçon s’appuie uniquement sur la base synthétique JaviBuildsLab et sa table dbo.Customers. Un INSERT réussi modifie la table : vérifiez donc la destination et relisez le résultat au lieu de supposer que l’instruction a fonctionné.
Insérer une ligne avec une liste de colonnes
Le script de démonstration crée les identifiants client 1 à 10. La ligne suivante utilise l’identifiant d’exercice 11, en dehors de cette plage. Vérifiez d’abord la base active et la disponibilité de cette clé :
SELECT DB_NAME() AS CurrentDatabase;
SELECT CustomerId, FirstName, LastName
FROM dbo.Customers
WHERE CustomerId = 11;Pour poursuivre, la première requête doit afficher JaviBuildsLab et la seconde ne doit renvoyer aucune ligne. Vous pouvez alors ajouter la ligne :
INSERT INTO dbo.Customers
(
CustomerId,
FirstName,
LastName,
City,
State,
Email,
CreatedDate
)
VALUES
(
11,
N'Maya',
N'Rivera',
N'Orlando',
'FL',
N'maya.rivera@example.com',
'2026-10-21'
);INSERT INTO nomme la table cible. La liste entre parenthèses indique les colonnes à renseigner, puis VALUES donne une valeur pour chacune dans le même ordre. Le préfixe N indique une chaîne Unicode, adaptée aux colonnes NVARCHAR. La colonne d’État est CHAR(2), donc 'FL' y tient. La date utilise le format année-mois-jour, explicite dans cet exemple.
Cet identifiant est une valeur d’exercice, pas une nouvelle ligne ajoutée par le script de configuration. Exécutez l’exemple une seule fois dans votre base locale. Au nouvel essai, la clé primaire existera déjà ; vérifiez d’abord et choisissez une clé d’exercice libre au lieu de modifier le script. La configuration reste déterministe et additive ; le site n’insère aucune donnée client automatiquement.
Pourquoi nommer les colonnes ?
Une forme plus courte, comme INSERT INTO dbo.Customers VALUES (...), suppose que vous connaissiez toutes les colonnes et leur ordre physique. Une évolution du schéma ou une valeur oubliée peut faire échouer l’instruction, voire placer une valeur valide dans la mauvaise colonne. Une liste explicite documente l’intention, relie les valeurs aux noms et permet d’omettre les colonnes qui acceptent NULL ou possèdent une vraie valeur par défaut.
Cette liste facilite aussi la relecture. Un collègue peut voir que City reçoit Orlando et CreatedDate la date sans chercher la définition de la table. Gardez les listes des colonnes et des valeurs dans le même ordre : SQL Server associe les éléments par position, pas selon leur signification.
Omettre une colonne nullable
Dans le schéma de démonstration, Email accepte NULL et n’a pas de valeur par défaut. Vous pouvez l’omettre si l’adresse électronique est inconnue. SQL Server affectera NULL à cette colonne nullable omise :
INSERT INTO dbo.Customers
(CustomerId, FirstName, LastName, City, State, CreatedDate)
VALUES
(12, N'Rosa', N'Chen', N'Phoenix', 'AZ', '2026-10-21');Il s’agit d’un autre exemple d’exercice, avec l’identifiant 12, et non d’une modification du script initial. L’omission ne crée pas une adresse électronique par défaut : la colonne vaut NULL parce que sa définition l’autorise. Une colonne NOT NULL sans valeur par défaut rendrait l’insertion invalide. Consultez le schéma au lieu de deviner ce que SQL Server remplira.
Ajouter quelques lignes
Un INSERT peut ajouter plusieurs lignes. Chaque ligne doit fournir une valeur par colonne, compatible avec celle-ci :
INSERT INTO dbo.Customers
(CustomerId, FirstName, LastName, City, State, Email, CreatedDate)
VALUES
(13, N'Noah', N'Patel', N'Boulder', 'CO', N'noah.patel@example.com', '2026-10-21'),
(14, N'Leila', N'Morgan', N'Raleigh', 'NC', NULL, '2026-10-21');Cet exemple constitue une autre option d’exercice, pas une modification des données de départ. La deuxième ligne utilise le mot-clé SQL NULL pour une adresse inconnue. NULL n’est pas du texte : écrivez NULL, et non 'NULL'. Le texte entre apostrophes serait constitué des quatre lettres N-U-L-L. La leçon sur NULL explique comment SQL Server compare et affiche les valeurs manquantes. N’exécutez pas chaque exemple illustratif à répétition ; vérifiez qu’un identifiant est disponible avant de l’utiliser.
Respecter les types SQL
Les chaînes sont placées entre apostrophes. Le préfixe N convient aux colonnes NVARCHAR, comme N'Maya'. Les nombres, par exemple l’identifiant entier, s’écrivent sans apostrophes : 11, et non '11'. SQL Server sait parfois convertir du texte automatiquement, mais une conversion implicite rend les erreurs moins visibles. Écrivez les dates sans ambiguïté, comme '2026-10-21'. Pour une information manquante, utilisez le mot-clé non cité NULL, uniquement si la colonne l’autorise.
Chaque colonne possède un type et souvent une longueur maximale. FirstName et LastName acceptent jusqu’à 50 caractères Unicode ; State en accepte deux. Une valeur trop longue ou incompatible peut provoquer une erreur, et certains contextes peuvent la tronquer. Respectez les limites déclarées et consultez les définitions réelles lorsque vous adaptez un exemple.
Colonnes IDENTITY et contraintes
Une colonne IDENTITY est configurée pour générer un nombre lors de l’insertion. Beaucoup de tables utilisent cette propriété pour une clé de substitution, et l’INSERT omet alors cette colonne. Dans la démonstration, CustomerId n’est pas IDENTITY : c’est une clé primaire INT NOT NULL que l’INSERT doit fournir. Ne supposez jamais que SQL Server génère les identifiants sans avoir vérifié le schéma. Le script de configuration existant n’a pas besoin d’être modifié pour cette leçon.
Les contraintes empêchent les valeurs ou relations invalides. CustomerId est une clé primaire : un identifiant en double fait échouer l’insertion. Dans dbo.Orders, CustomerId est une clé étrangère vers dbo.Customers ; une commande liée à un client absent est rejetée. Une valeur NULL ne peut pas être placée dans une colonne NOT NULL, et un type ou une longueur incorrects peuvent également produire une erreur. Ces contrôles protègent les règles des tables.
En cas d’erreur, lisez le nom de la table, de la colonne ou de la contrainte indiqué par SQL Server. Vérifiez la base, consultez les colonnes cibles et comparez-les à votre liste. Corrigez la cause avant de réessayer. Ne modifiez pas des données de démonstration sans rapport pour contourner une collision de clé : choisissez plutôt une clé libre.
Vérifier la nouvelle ligne
Quand l’instruction se termine, relisez la ligne à l’aide de sa clé :
SELECT
CustomerId,
FirstName,
LastName,
City,
State,
Email,
CreatedDate
FROM dbo.Customers
WHERE CustomerId = 11;Vérifiez que chaque valeur correspond à votre intention. Si aucune ligne n’apparaît, lisez le message SSMS, confirmez la base active et contrôlez l’identifiant. Cette habitude prolonge la leçon sur le filtrage avec WHERE : une condition précise facilite l’inspection d’un enregistrement.
SQL Server accepte aussi INSERT ... SELECT, qui insère les lignes renvoyées par une requête. Cette méthode est utile pour copier ou transformer plusieurs lignes, mais elle combine lecture et écriture. Il faut donc vérifier la requête source et la liste de destination. Commencez par la forme explicite avec VALUES ; la discipline d’association des colonnes s’applique aussi au motif ultérieur.
Un INSERT ajoute des lignes à la table ; il ne modifie pas une ligne existante lorsque sa clé est déjà présente. Dans ce cas, la contrainte de clé primaire rejette le doublon. Vérifiez si la ligne existe avant de décider si votre objectif est d’ajouter un enregistrement ou de modifier un enregistrement actuel. Ces deux tâches utilisent des instructions et des vérifications différentes. Pour une ligne existante, utilisez la méthode SELECT d’abord de la leçon sur UPDATE plutôt que de contourner une clé en modifiant celle d’un autre client.
Pour plusieurs lignes, comptez les groupes de valeurs et comparez-les à la liste de colonnes. Avec sept colonnes, chaque tuple doit contenir sept valeurs, y compris un NULL explicite si un champ facultatif est inconnu. Relisez l’ensemble avant exécution : un tuple mal formé peut empêcher l’insertion attendue. Ensuite, sélectionnez les identifiants ajoutés et confirmez la présence de toutes les lignes. Cette vérification devient encore plus utile lorsque l’instruction dépasse l’exemple d’une seule ligne.
Erreurs courantes et exercices
Évitez d’oublier la liste des colonnes, d’inverser l’ordre des valeurs, de citer NULL, de réutiliser une clé primaire, d’écrire dans la mauvaise base ou de considérer la fenêtre de requête comme preuve que la bonne ligne existe. Vérifiez le contexte, nommez clairement les colonnes et relisez la nouvelle ligne par sa clé. Même dans une base de démonstration, un INSERT est une vraie modification.
Entraînez-vous dans JaviBuildsLab. Avant chaque insertion, vérifiez la base et choisissez un identifiant libre. Les exemples sont indépendants et ne doivent pas être exécutés à répétition.
- Ajoutez le client 15, Imani Brooks, à Boise dans l’Idaho, sans adresse électronique.
- Ajoutez deux clients d’identifiants 16 et 17 dans une instruction ; le second a un courriel NULL.
- Sans valeur par défaut, quelles colonnes sont obligatoires ? Consultez la définition de la table et trouvez les colonnes
NOT NULL. - Pourquoi l’exemple fournit-il
CustomerId, alors que de nombreuses tables basées sur une identité omettent leur clé ? - Écrivez une requête de vérification pour le client 15.
Réponses
-- 1
INSERT INTO dbo.Customers (CustomerId, FirstName, LastName, City, State, CreatedDate)
VALUES (15, N'Imani', N'Brooks', N'Boise', 'ID', '2026-10-21');
-- 2
INSERT INTO dbo.Customers (CustomerId, FirstName, LastName, City, State, Email, CreatedDate)
VALUES
(16, N'Eli', N'Park', N'Juneau', 'AK', N'eli.park@example.com', '2026-10-21'),
(17, N'Sara', N'Bell', N'Madison', 'WI', NULL, '2026-10-21');
-- 5
SELECT CustomerId, FirstName, LastName, Email
FROM dbo.Customers
WHERE CustomerId = 15;Pour l’exercice 3, CustomerId, FirstName, LastName et CreatedDate sont NOT NULL ; les autres champs client peuvent être NULL. L’exercice 4 dépend du schéma réel : ici, la clé est attribuée manuellement. Une fois la ligne présente, passez aux bases d’UPDATE et apprenez à prévisualiser les lignes avant de les modifier.
- Nouvelles valeurs
- INSERT INTO dbo.Customers
- Nouvelle ligne ajoutée
- Vérification SELECT
- Confirmer la ligne insérée
Pour les valeurs manquantes, consultez aussi la leçon sur NULL. Retrouvez votre progression dans la feuille de route SQL Server Foundations.
Vérifiez ce que vous avez retenu
2 questions rapides
Fondamentaux de SQL Server
Leçon 16 sur 25
Ce contenu vous a-t-il été utile ?
Que pourrions-nous améliorer ?
Merci — cela m’aide à améliorer Javi Builds.
Continuer à apprendre
- Aide-mémoireVérifier l’utilisation des indexExaminez l’activité de lecture et d’écriture des index SQL Server, repérez les index à faible valeur et déterminez lesquels méritent une analyse approfondie avant toute suppression.Ouvrir l’aide-mémoire
- Feuille de routeSQL Server FoundationsApprenez à insérer une ou plusieurs lignes dans SQL Server avec une liste de colonnes explicite et une vérification par SELECT.Voir la feuille de route
Que devrais-je créer ensuite ?
Je développe Javi Builds autour des problèmes concrets rencontrés par les data engineers. Dites-moi quel sujet vous aimeriez voir ensuite.
Restez au courant
Recevez uniquement les nouvelles de Javi Builds qui vous intéressent.
Consultez votre boîte de réception
Je vous ai envoyé un lien de confirmation. Votre abonnement sera actif après confirmation.