Error 207 – nieznana kolumna

Error 207 sygnalizuje odwołanie do kolumny, która nie istnieje w danej tabeli lub widoku bazy danych.

Co oznacza Error 207 w Microsoft SQL Server

Error 207 w Microsoft SQL Server oznacza, że aparat bazy danych nie rozpoznał nazwy kolumny użytej w instrukcji Transact-SQL. Typowy komunikat brzmi „Invalid column name 'nazwa_kolumny'”. Błąd dotyczy identyfikatora wskazującego kolumnę, której SQL Server nie znajduje w tabeli, widoku, funkcji tabelarycznej albo innym źródle danych wykorzystanym przez zapytanie. Nie jest to ogólny komunikat o uszkodzeniu tabeli ani o braku połączenia z serwerem.

Do błędu może dojść podczas kompilacji zapytania, gdy SQL Server analizuje jego składnię i wiąże użyte nazwy z obiektami bazy danych. Jeżeli nazwa została wpisana z literówką, kolumna została usunięta albo zapytanie odwołuje się do niewłaściwego zakresu tabeli, instrukcja nie zostanie poprawnie wykonana. Przykładowo zapytanie SELECT Imie FROM dbo.Pracownicy; zakończy się błędem 207, jeśli tabela zawiera kolumnę Imię, ale nie zawiera kolumny o nazwie Imie.

Najczęstsze przyczyny nieznanej kolumny

Jedną z przyczyn jest rozbieżność między kodem aplikacji a aktualnym schematem bazy danych. Program może oczekiwać kolumny dodanej w migracji, której nie wykonano na danym środowisku. Odwrotna sytuacja również powoduje problem: kod nadal używa kolumny usuniętej albo przemianowanej w tabeli. Błąd pojawia się także wtedy, gdy zapytanie wykonuje się w innej bazie lub w innym schemacie niż zakłada autor, na przykład odwołuje się do dbo.Orders, podczas gdy zmieniona wersja obiektu znajduje się w innym schemacie.

W zapytaniach wielotabelowych źródłem problemu bywa brak aliasu albo użycie aliasu, który nie został zdefiniowany. Jeżeli tabela otrzyma alias p, kolumnę należy wskazywać jako p.Nazwa, a nie przez przypadkowy alias innej tabeli. Error 207 może również wynikać z różnic w wielkości liter, gdy baza korzysta z sortowania rozróżniającego wielkość liter, czyli collation typu case-sensitive. W takim środowisku CustomerID i customerid mogą być traktowane jako różne identyfikatory.

Specyficzny przypadek występuje przy aliasach kolumn tworzonych w klauzuli SELECT. Alias zdefiniowany w tym miejscu nie jest zwykle dostępny w klauzuli WHERE tego samego poziomu zapytania, ponieważ WHERE jest logicznie przetwarzane wcześniej. Przykład SELECT Cena * 1.23 AS Brutto FROM dbo.Towary WHERE Brutto > 100; może zakończyć się Error 207. Rozwiązaniem jest powtórzenie wyrażenia, użycie podzapytania albo zastosowanie odpowiednio HAVING lub innej konstrukcji pasującej do logiki zapytania.

Jak sprawdzić źródło błędu

Diagnostykę należy rozpocząć od dokładnego odczytania nazwy wskazanej w komunikacie oraz od ustalenia, która instrukcja ją wykorzystuje. Następnie trzeba sprawdzić rzeczywisty schemat obiektu w tej bazie, na której działa aplikacja. W SQL Server można użyć między innymi zapytania SELECT COLUMN_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'dbo' AND TABLE_NAME = 'Pracownicy';. Do bardziej szczegółowej inspekcji służą również katalogi systemowe, takie jak sys.columns, sys.tables i sys.views.

Warto zweryfikować, czy połączenie wskazuje właściwą bazę danych oraz czy nazwa obiektu nie jest rozwiązywana przez synonim, widok lub procedurę o innej definicji niż oczekiwana. Pomocne jest jawne kwalifikowanie obiektów nazwą schematu, na przykład dbo.Pracownicy, oraz stosowanie aliasów tabel w sposób konsekwentny. Jeżeli problem wystąpił po wdrożeniu, należy porównać historię migracji z wersją kodu i potwierdzić, że zmiana struktury została wykonana przed uruchomieniem nowej instrukcji.

Nie należy usuwać komunikatu przez przypadkowe dodanie kolumny bez sprawdzenia modelu danych. Taka zmiana może ukryć literówkę, zaburzyć integralność aplikacji albo spowodować inne błędy zapytań. Po poprawieniu nazwy lub migracji trzeba uruchomić zapytanie z rzeczywistymi parametrami, sprawdzić wszystkie ścieżki kodu korzystające z danego obiektu oraz zweryfikować widoki i procedury zależne od zmienianej kolumny.

Znaczenie błędu dla diagnostyki laptopa i komputera

W środowisku użytkownika Error 207 zwykle pojawia się po uruchomieniu programu korzystającego z lokalnej lub firmowej bazy SQL Server, na przykład aplikacji magazynowej, księgowej, serwisowej albo systemu zarządzającego dokumentami. Sam błąd wskazuje przede wszystkim na niespójność zapytania z definicją bazy, a nie na awarię procesora, pamięci RAM czy dysku. Na komputerze może jednak ujawnić się po aktualizacji programu, przywróceniu kopii bazy, zmianie konfiguracji połączenia lub niepełnym wykonaniu instalatora.

Podczas diagnozy komputera należy zebrać pełny tekst komunikatu, nazwę aplikacji, moment wystąpienia błędu oraz informację, czy problem dotyczy jednego stanowiska, czy wszystkich użytkowników. Jeżeli błąd występuje tylko na jednym komputerze, trzeba porównać wersję aplikacji, pliki konfiguracyjne i wskazany serwer SQL z działającym stanowiskiem. Jeżeli występuje wszędzie po tej samej aktualizacji, bardziej prawdopodobna jest niezgodność wersji aplikacji ze schematem bazy lub brakująca migracja. Naprawa powinna obejmować kopię zapasową, kontrolę wersji oraz sprawdzenie zmian przez administratora odpowiedzialnego za SQL Server.