// SQL Server-Fehlerreferenz

SQL Server-Fehler 8178: Parameterisierte Abfrage erwartet einen Parameter

Eine parametrisierte Abfrage (sp_executesql) deklariert einen Parameter, der vom Aufruf nicht bereitgestellt wurde, normalerweise ein NULL-Wert, den die Client-Bibliothek ausgelassen hat.

Fehlernummer
8178
Schweregrad
16
Kategorie
Namen und Objekte
Fehlermeldung
The parameterized query '%.*ls' expects the parameter '%.*ls', which was not supplied.

Was es bedeutet

Client-Bibliotheken senden parametrisierte SQL-Abfragen über sp_executesql mit einer Liste der deklarierten Parameter und deren Werte. Wenn ein deklarierter Parameter keinen Wert hat, wird in SQL Server der Fehler 8178 ausgelöst. In .NET ist eine klassische Ursache das Setzen des Werts eines Parameters auf null, was „nicht bereitgestellt“ bedeutet; ein Datenbank-NULL muss sein DBNull.Value.

Häufige Ursachen

  • Ein Parameterwert von null in ADO.NET anstelle von DBNull.Value.
  • Ein im SQL-Text deklarierter, aber nie zum Befehl hinzugefügter Parameter.
  • Eine Diskrepanz zwischen Parameternamen im SQL und denen, die dem Befehl hinzugefügt wurden.

Wie du es behebst

  1. Übergib DBNull.Value für NULLs in ADO.NET, oder überlass es der Bibliothek (zum Beispiel konvertiert Dapper null für dich).

  2. Stelle sicher, dass jeder @parameter im SQL-Text einen Wert hat, mit passenden Namen.

  3. Gib in T-SQL jeden deklarierten Parameter an.

    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;

Zugehörige Fehler

Weitere Namens- und Objektfehler

Der Code und der Meldungstext stammen aus der Microsoft Database Engine-Ereignisse und Fehlernachschlagewerk. Durchstöbere die vollständige SQL Server-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit SQL Server in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für SQL Server und die anderen Datenbanken, mit denen du arbeitest.