// Référence des erreurs SQL Server

Erreur SQL Server 8178 : La requête paramétrée attend un paramètre

Une requête paramétrée (sp_executesql) déclare un paramètre que l'appel n'a pas fourni, généralement une valeur NULL que la bibliothèque client a omise.

Numéro d'erreur
8178
Sévérité
16
Catégorie
Noms et objets
Message d'erreur
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

Ce que cela signifie

Les bibliothèques clientes envoient le SQL paramétré via sp_executesql avec une liste de paramètres déclarés et leurs valeurs. Si un paramètre déclaré n'a pas de valeur, SQL Server déclenche l'erreur 8178. En .NET, une cause classique est d'affecter à la valeur d'un paramètre null, ce qui signifie « non fourni » ; un NULL de base de données doit être DBNull.Value.

Causes courantes

  • Une valeur de paramètre de null dans ADO.NET au lieu de DBNull.Value.
  • Un paramètre déclaré dans le texte SQL mais jamais ajouté à la commande.
  • Une incompatibilité entre les noms des paramètres dans le SQL et ceux ajoutés à la commande.

Comment le corriger

  1. Passez DBNull.Value pour les NULL dans ADO.NET, ou laissez la bibliothèque le faire (par exemple Dapper convertit null pour vous).

  2. Assurez-vous que chaque @parameter dans le texte SQL ait une valeur, avec des noms correspondants.

  3. En T-SQL, fournissez tous les paramètres déclarés.

    EXEC sys.sp_executesql
        N'SELECT * FROM dbo.Orders WHERE CustomerId = @c AND Status = @s',
        N'@c int, @s varchar(20)',
        @c = 42, @s = NULL;

Erreurs liées

Plus d'erreurs de noms et d'objets

Le code et le texte du message sont issus de Référence des événements et erreurs du moteur de base de données Microsoft. Parcourir la liste complète Liste des erreurs de SQL Server ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur SQL Server dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d’erreur clairs, pour SQL Server et les autres bases de données que vous utilisez.