Błąd ORA-00904 invalid identifier w Oracle i jak go naprawić

Oracle
16/11/2026
Tomasz Chwasewicz
Błąd ORA-00904 invalid identifier w Oracle i jak go naprawić

ORA-00904: invalid identifier to błąd Oracle, który oznacza, że w poleceniu SQL pojawiła się nazwa kolumny lub inny identyfikator, którego baza nie może znaleźć albo uznaje za niepoprawny. Administratorzy baz danych Oracle znają go na pamięć, bo pojawia się bardzo często. Zwykle przyczyna jest prosta, na przykład literówka albo brak kolumny w tabeli. Są jednak mniej oczywiste sytuacje, w których ten sam błąd pojawia się, chociaż zapytanie wydaje się poprawne.

Ogólne przyczyny ORA-00904 we wszystkich wersjach Oracle

Znaczenie ORA-00904. Oracle zgłasza ORA-00904, gdy natrafi na niepoprawny identyfikator, najczęściej nazwę kolumny. Zwykle oznacza to jedną z dwóch sytuacji: (a) zapytanie odwołuje się do kolumny lub aliasu, które nie istnieją we wskazanych tabelach, albo (b) identyfikator nie spełnia zasad nazewnictwa Oracle. Komunikat błędu zwykle podaje problematyczny identyfikator w cudzysłowie, na przykład:

ORA-00904: "EMPID": invalid identifier

Oznacza to, że Oracle nie rozpoznał identyfikatora EMPID.

Zasady nazewnictwa w Oracle

Oracle ma ścisłe zasady dla identyfikatorów, czyli nazw kolumn, tabel i innych obiektów. Poprawny identyfikator musi spełniać te warunki:

  • Zaczyna się od litery. Identyfikator nie może zaczynać się od cyfry ani znaku specjalnego.
  • Zawiera tylko litery, cyfry i znaki $, _ oraz #. Każdy inny znak, także spacja, jest niedozwolony, chyba że nazwa jest w cudzysłowie.
  • Nie przekracza maksymalnej długości. Do Oracle 12c Release 1 identyfikator może mieć najwyżej 30 znaków. Od Oracle 12c Release 2 limit wynosi 128 znaków. Nazwa dłuższa niż limit danej wersji jest niepoprawna.
  • Nie jest słowem zastrzeżonym, chyba że jest w cudzysłowie. Oracle ma wiele słów zastrzeżonych, na przykład SELECT, WHERE czy NUMBER. Użycie takiego słowa jako nazwy kolumny lub tabeli bez cudzysłowu kończy się błędem ORA-00904. Słowami zastrzeżonymi są też AUDIT i COMMENT, więc kolumna o nazwie COMMENT bez cudzysłowu wywoła ten błąd.

Identyfikatory w cudzysłowie i wielkość liter

Zwykle identyfikatory w Oracle nie rozróżniają wielkości liter, bo Oracle zapisuje je wielkimi literami. Kolumna utworzona jako CustomerName lub customername jest zapisana jako CUSTOMERNAME i można się do niej odwołać jako customername. Jeśli jednak identyfikator utworzono w cudzysłowie, wielkość liter ma znaczenie i trzeba się do niego odwoływać dokładnie tak, jak go utworzono, razem z cudzysłowem. Częsty błąd to utworzenie identyfikatora w cudzysłowie, a potem odwołanie się do niego bez cudzysłowu albo z inną wielkością liter. Oracle traktuje wtedy nazwę jako inny identyfikator i zgłasza ORA-00904. "MyColumn" to inny identyfikator niż MYCOLUMN.

Różnice między wersjami. Poza zwiększeniem limitu długości z 30 do 128 znaków przyczyny ORA-00904 są takie same we wszystkich wersjach Oracle. Różnić się mogą słowa zastrzeżone, bo nowe wersje dodają nowe słowa kluczowe, oraz narzędzia, z których niektóre podają więcej szczegółów o błędzie. Jeśli podejrzewasz problem ze słowem zastrzeżonym lub zasadami nazewnictwa, sprawdź dokumentację Oracle dla swojej wersji. Opis błędu w dokumentacji Oracle potwierdza, że przyczyną jest niepoprawny lub brakujący identyfikator.

Typowe sytuacje, w których pojawia się ORA-00904

Poniżej najczęstsze sytuacje, w których pojawia się ORA-00904. Wynikają ze zmian w schemacie, problemów w zapytaniu albo błędów składni.

Literówka w nazwie kolumny lub brak kolumny

Najczęstsza przyczyna to odwołanie do kolumny, która nie istnieje w tabeli lub widoku. Powodem może być zwykła literówka albo usunięcie lub zmiana nazwy kolumny w schemacie. Jeśli tabela EMP ma kolumnę EMPNO, a zapytanie brzmi SELECT empid FROM emp;, Oracle zgłosi ORA-00904 dla "EMPID". Tak samo DELETE FROM emp WHERE empid = 123; zakończy się błędem, jeśli kolumna empid nie istnieje. Często zdarza się to po zmianach w schemacie, gdy kolumnę przemianowano lub usunięto, albo przez pomyłkę w zapytaniu.

Nieistniejąca kolumna w poleceniach DML (INSERT, UPDATE)

Każde polecenie INSERT, UPDATE lub DELETE, które wymienia nieistniejącą kolumnę, zgłosi ORA-00904. Na przykład UPDATE scott.emp SET salary=1000 WHERE empno=1234; zakończy się komunikatem "SALARY": invalid identifier, jeśli kolumna w tabeli EMP nazywa się SAL albo kolumny SALARY w ogóle nie ma. To samo dotyczy polecenia INSERT z nieistniejącą kolumną na liście. Najczęściej winne są literówki albo pomylenie nazw logicznych z rzeczywistymi nazwami kolumn w bazie.

Słowo zastrzeżone użyte jako identyfikator

Jeśli słowo zastrzeżone Oracle zostanie użyte jako nazwa kolumny lub tabeli bez cudzysłowu, Oracle uzna je za niepoprawny identyfikator. Zdarza się to często przy przenoszeniu zapytań z innych baz danych albo przez przypadek. Próba utworzenia tabeli z kolumną COMMENT lub AUDIT zakończy się błędem ORA-00904. W jednym z przypadków definicja kolumny AUDIT VARCHAR2(1000) wywołała ORA-00904 dokładnie w tej linii. Komunikat nie mówi wprost o słowie zastrzeżonym, ale wskazuje problematyczny identyfikator. Często mylone słowa to COMMENT, CHECK, LEVEL, PRIOR, RESOURCE i inne.

Wielkość liter i nazwy w cudzysłowie

Jeśli tabelę lub kolumnę utworzono z nazwą w cudzysłowie, z rozróżnianiem wielkości liter albo ze znakami specjalnymi, każde zapytanie musi używać tej samej wielkości liter i cudzysłowu. W przeciwnym razie pojawi się ORA-00904. Jeśli tabelę utworzono poleceniem CREATE TABLE bad_design("MixedCaseColumn" NUMBER);, to zapytanie SELECT MixedCaseColumn FROM bad_design; zakończy się błędem. Poprawna wersja to SELECT "MixedCaseColumn" FROM bad_design;

Dobra praktyka to unikanie identyfikatorów w cudzysłowie, jeśli nie są konieczne.

Błędne użycie aliasów w zapytaniach

Aliasu zdefiniowanego w klauzuli SELECT nie można użyć w klauzuli WHERE ani GROUP BY tego samego zapytania, bo Oracle analizuje te klauzule wcześniej. Oracle nie rozpozna wtedy aliasu i zgłosi dla niego ORA-00904. Zapytanie SELECT (col1+col2) AS total FROM my_table WHERE total > 100; zakończy się komunikatem "TOTAL": invalid identifier, bo w chwili analizy klauzuli WHERE alias total nie jest jeszcze znany. Rozwiązaniem jest powtórzenie wyrażenia albo użycie podzapytania lub widoku. Jeśli alias ma nazwę w cudzysłowie, w ORDER BY i innych miejscach trzeba używać dokładnie tej samej nazwy z cudzysłowem. Oto przykład takiego problemu:

SELECT column_name AS "column_id"

FROM my_table

ORDER BY column_id; -- tu Oracle zgłasza ORA-00904

Oracle zgłasza błąd, bo alias column_id zdefiniowano w cudzysłowie, więc rozróżnia on wielkość liter, a column_id bez cudzysłowu w ORDER BY do niego nie pasuje. Poprawka to użycie cudzysłowu: ORDER BY "column_id". W Oracle można używać aliasów bez cudzysłowu w ORDER BY, ale jeśli alias zdefiniowano w cudzysłowie lub z mieszaną wielkością liter, trzeba go podać w cudzysłowie.

Błędne użycie klauzuli USING w złączeniu

W złączeniu z klauzulą USING(kolumna) ta kolumna staje się wspólnym identyfikatorem i należy się do niej odwoływać bez nazwy tabeli. Poprzedzenie jej aliasem tabeli kończy się błędem niepoprawnego identyfikatora. Na przykład:

SELECT a.id, b.data

FROM tableA a JOIN tableB b USING(id);

Tutaj w liście SELECT powinno być samo id, a nie a.id ani b.id. Odwołanie a.id lub b.id w klauzuli SELECT albo WHERE jest w tej sytuacji niepoprawne. Oracle zgłasza w tej sytuacji zwykle błąd ORA-25154 (column part of USING clause cannot have qualifier). Poprawka jest ta sama: usuń nazwę tabeli lub alias sprzed tej kolumny.

Błędy składni SQL (literówki, zbędne przecinki)

Czasem ORA-00904 to skutek uboczny błędu składni, przez który Oracle odczytuje coś jako identyfikator. Klasyczny przykład to zbędny przecinek na końcu listy kolumn. W poleceniu CREATE TABLE Test (ID NUMBER, NAME VARCHAR2(50), ); po ostatnim przecinku Oracle oczekuje kolejnej nazwy kolumny i zgłasza ORA-00904, bo brakuje identyfikatora. Podobnie jeśli w klauzuli WHERE zabraknie apostrofów wokół tekstu (WHERE name = John zamiast WHERE name = 'John'), Oracle odczyta John jako identyfikator i najpewniej zgłosi dla niego ORA-00904. Inne pomyłki, na przykład nawiasy kwadratowe wokół nazw znane z SQL Server, Oracle również potraktuje jako niedozwolone znaki lub niepoprawne identyfikatory.

Uprawnienia i odwołania do schematu

Rzadziej ORA-00904 pojawia się, gdy użytkownik nie ma dostępu do tabeli lub kolumny. Jeśli zapytanie odwołuje się do tabeli z innego schematu bez odpowiednich uprawnień albo bez podania nazwy schematu, Oracle może uznać kolumnę za niepoprawną, bo nie znajduje tabeli lub kolumny. Brak uprawnień zwykle daje błąd ORA-00942 (table or view does not exist), ale jeśli tabela jest ukryta za synonimem lub widokiem, brakująca kolumna może dać ORA-00904. Rozwiązaniem jest odwołanie się do właściwego schematu i nadanie użytkownikowi uprawnienia SELECT.

Jak naprawić błąd ORA-00904 krok po kroku

ORA-00904 potrafi irytować, ale systematyczne sprawdzenie zwykle szybko wskazuje przyczynę. Wykonaj kolejno poniższe kroki.

1. Przeczytaj komunikat błędu

Zanotuj identyfikator podany w komunikacie błędu, w cudzysłowie po ORA-00904. To nazwa, której Oracle nie rozpoznał, na przykład "DEPT_ID" lub EMPID. Od niej zaczynasz.

2. Porównaj identyfikator ze schematem

Sprawdź, czy kolumna lub identyfikator rzeczywiście istnieje we wskazanej tabeli.

  • Literówki. Porównaj identyfikator z rzeczywistymi nazwami kolumn. Łatwo pomylić nazwę, na przykład EMPNAME zamiast ENAME, a Oracle akceptuje tylko dokładną nazwę. Jeśli znajdziesz literówkę, popraw zapytanie.
  • Zmiany w schemacie. Jeśli identyfikator kiedyś istniał, a kolumnę przemianowano lub usunięto, zmień zapytanie na nową nazwę albo dodaj brakującą kolumnę z powrotem. Jeśli z tabeli usunięto DEPT_ID, każde zapytanie, które go używa, trzeba poprawić albo odtworzyć kolumnę.

3. Sprawdź, czy identyfikator spełnia zasady nazewnictwa

Jeśli to nie literówka, sprawdź identyfikator pod kątem zasad nazewnictwa Oracle:

  • Długość. Czy nazwa nie jest za długa dla danej wersji Oracle? Limit to 30 znaków w starszych wersjach i 128 od Oracle 12.2. Jeśli nazwa przekracza limit, skróć ją albo zaktualizuj bazę, jeśli potrzebujesz dłuższych nazw.
  • Znaki. Czy nazwa zawiera spacje lub znaki specjalne? Jeśli tak, musi być w zapytaniu w cudzysłowie i musiała zostać utworzona z cudzysłowem. Jeśli obiekt utworzono bez cudzysłowu, usuń niedozwolone znaki albo zmień nazwę.
  • Słowo zastrzeżone. Sprawdź, czy identyfikator nie jest słowem zastrzeżonym SQL. Listę słów zastrzeżonych zawiera dokumentacja Oracle. Jeśli identyfikator jest na tej liście, na przykład kolumna COMMENT albo DATE, Oracle uzna go za niepoprawny, chyba że jest w cudzysłowie. Najlepiej zmienić nazwę kolumny lub tabeli na słowo niezastrzeżone. Można też za każdym razem używać cudzysłowu, ale zmiana nazwy jest bezpieczniejsza.
  • Wielkość liter. Jeśli identyfikator w komunikacie jest w cudzysłowie albo ma nietypową wielkość liter, mógł zostać utworzony w cudzysłowie. Oracle zamienia nazwy bez cudzysłowu na wielkie litery. Jeśli obiekt utworzono w cudzysłowie, z mieszaną lub małą wielkością liter, trzeba odwoływać się do niego dokładnie tak samo. Jeśli kolumnę utworzono jako "FirstName", zapytanie SELECT FirstName FROM table się nie powiedzie. Poprawnie jest SELECT "FirstName" FROM table. Można dodać cudzysłów z właściwą wielkością liter, ale lepiej odtworzyć kolumnę bez cudzysłowu. Ogólna zasada: unikaj identyfikatorów w cudzysłowie, jeśli nie są konieczne.

4. Sprawdź aliasy w zapytaniu

Jeśli błąd dotyczy aliasu, na przykład zdefiniowanego w liście SELECT, pamiętaj, że zwykle nie można go użyć w WHERE, GROUP BY ani HAVING tego samego zapytania. Oracle nie podstawia aliasu podczas analizy, więc zgłasza ORA-00904. Alias z listy SELECT można użyć w ORDER BY, bo ta klauzula jest przetwarzana później, ale nie w WHERE. Rozwiązaniem jest przebudowa zapytania. Można powtórzyć wyrażenie albo zdefiniować alias w podzapytaniu lub klauzuli WITH i odwołać się do niego na zewnątrz. Jeśli w komunikacie widać alias w cudzysłowie, używaj go wszędzie dokładnie z tym samym cudzysłowem i wielkością liter, zwłaszcza w ORDER BY.

5. Poszukaj błędów składni i zbędnych znaków

Jeśli nazwy wyglądają poprawnie, sprawdź składnię zapytania:

  • Zbędny przecinek lub brakujący element. Przecinek na końcu listy kolumn w SELECT lub CREATE TABLE sprawia, że Oracle oczekuje kolejnej nazwy. Usuń zbędny przecinek albo dodaj brakujący identyfikator.
  • Brak apostrofów wokół tekstu. Upewnij się, że wszystkie wartości tekstowe są w apostrofach. Inaczej Oracle może je odczytać jako nazwy kolumn i zgłosić ORA-00904.
  • Nawiasy kwadratowe i składnia z innych baz. Oracle SQL nie używa nawiasów kwadratowych do oznaczania identyfikatorów, to konwencja SQL Server. Ich użycie da błąd składni lub niepoprawnego identyfikatora. Usuń albo zastąp składnię, która nie pochodzi z Oracle.

6. Sprawdź schemat i uprawnienia

Upewnij się, że zapytanie działa na właściwym schemacie i na koncie, które ma dostęp do tabeli. Jeśli problem wynika z braku nazwy schematu, poprzedź nazwę tabeli nazwą schematu albo utwórz synonim. Jeśli wynika z uprawnień, nadaj odpowiednie uprawnienia albo uruchom zapytanie jako właściciel tabeli. Brak uprawnień zwykle daje ORA-00942, ale sprawdź ten punkt, jeśli wszystko inne wygląda poprawnie.

Gdy znajdziesz przyczynę, zastosuj odpowiednią poprawkę: popraw nazwę, zmień schemat, dodaj cudzysłów albo przebuduj zapytanie. Zawsze przetestuj poprawione zapytanie, żeby upewnić się, że błąd zniknął.

Jak uniknąć błędu ORA-00904

  • Używaj czytelnych i poprawnych nazw. Wybieraj nazwy kolumn i tabel zgodne z zasadami Oracle, czyli zaczynające się od litery, bez spacji i znaków specjalnych. Unikaj nazw wymagających cudzysłowu i kolidujących ze słowami zastrzeżonymi. Zamiast kolumny DATE lub COMMENT użyj ORDER_DATE lub COMMENT_TEXT.
  • Trzymaj się konwencji Oracle. Jeśli przechodzisz z innego dialektu SQL, dostosuj się do konwencji Oracle. Nie używaj nawiasów kwadratowych z SQL Server ani odwrotnych apostrofów z MySQL. Cudzysłowu używaj tylko wtedy, gdy to konieczne. Identyfikatory bez cudzysłowu, które Oracle zapisuje wielkimi literami, chronią przed pomyłkami w wielkości liter.
  • Sprawdzaj zmiany w schemacie. Przy wdrażaniu zmian, takich jak nowe kolumny czy zmiany nazw, wyszukaj w kodzie SQL odwołania do tych identyfikatorów i zaktualizuj zapytania lub kod aplikacji. To szczególnie ważne, gdy zmiana jest już w jednym środowisku, na przykład deweloperskim, a jeszcze nie w innym, na przykład produkcyjnym. Taka niezgodność może wywołać ORA-00904 w działającej aplikacji.
  • Testuj zapytania na właściwym schemacie. Jeśli przenosisz skrypt między wersjami Oracle lub schematami, uruchom go najpierw w środowisku testowym. Błędy niepoprawnego identyfikatora wyjdą wtedy wcześnie. Narzędzia takie jak SQL*Plus czy SQL Developer zwykle wskazują dokładny identyfikator i numer linii.
  • Uważaj na dynamiczny SQL. Jeśli zapytania są budowane dynamicznie, na przykład w aplikacji, upewnij się, że gotowy tekst zapytania jest poprawny. Czasem ORA-00904 pojawia się, bo przez błąd w kodzie do Oracle trafia inne zapytanie, niż się spodziewasz. Pomaga zapisanie gotowego zapytania w logu i porównanie go ze schematem.

Powiązane artykuły