SPICKZETTEL: Wie war’s noch mal? - ORA-Fehlermeldungen identifizieren

  • Erstellt von Klaus Popp
  • Datenbank

Ob in der Datenbankadministration oder Anwendungsentwicklung – wer in Berührung mit der Oracle-Datenbank kommt, stößt hin und wieder auf Fehlersmeldungen bestehend aus "ORA-" und einer sechsstelligen Nummer. Was tun, wenn Sie einem Fehler begegnen? Vom schnellen Googeln ist abzuraten – letztendlich müsste die Vertrauenswürdigkeit der Informationen erst mal geprüft werden. Oracle liefert aber ein einfaches Tool namens oerr, das erste Hinweise liefert.


Ob in der Datenbankadministration oder Anwendungsentwicklung – wer in Berührung mit der Oracle-Datenbank kommt, stößt hin und wieder auf Fehlersmeldungen bestehend aus "ORA-" und einer sechsstelligen Nummer. Was tun, wenn Sie einem Fehler begegnen?

Vom schnellen Googeln ist abzuraten – letztendlich müsste die Vertrauenswürdigkeit der Informationen erst mal geprüft werden. Oracle liefert aber ein einfaches Tool namens oerr, das erste Hinweise liefert.

Oerr steht ausschließlich auf Unix zur Verfügung. Das Tool wird mit der Oracle-Software installiert und ist unter $ORACLE_HOME/bin zu finden. So ermitteln Sie unter Unix/Linux den Pfad zum $ORACLE_HOME:

> echo $ORACLE_HOME
/u01/app/oracle/product/12.1.0/db_1

Um den Pfad zum Oerr-Verzeichnis zu finden, geben Sie folgenden Befehl ein:

> which oerr
/u01/app/oracle/product/12.1.0/db_1/bin/oerr

Das Tool gibt eine kurze Beschreibung des Fehlers wieder und eventuell weitere Hinweise zur Ursache oder Tipps zur Fehlerbehebung. Dieselben Informationen stehen auch in der Oracle-Dokumentation als PDF oder HTML zur Verfügung.

Hier zwei Beispiele zum Aufruf:

> oerr ora 942
00942, 00000, "table or view does not exist"
// *Cause:
// *Action:

 

> oerr ora 2097
02097, 00000, "parameter cannot be modified because specified value is invalid"
// *Cause: Though the initialization parameter is modifiable, the modified
//        value is not acceptable to the parameter.
// *Action: Check the DBA guide for range of acceptable values for this
//          parameter.

Sicherlich reichen diese Hinweise nicht immer, um einen Fehler zu beheben. Weitere Hilfe erhalten Sie im My Oracle Support. Für die bekannten Fehler ORA-600 bzw. ORA-7445 hat Oracle ein zusätzliches Tool implementiert, das eine Verfeinerung der Suchergebnisse ermöglicht.

Hinweis

Für die Firefox-Nutzer sei auch auf das Plugin von DOAG-Mitglied Uwe Küchler aufmerksam gemacht. Dieses ermöglicht die Suche über das Browser-Suchfeld  oben rechts. [UPDATE 25.11.2013: Das Plugin wurde aktualisiert.]

Carsten Czarski hat darüber hinaus ein Skript geschrieben, womit oerr über SQL abgerufen werden kann. Somit steht einer Benutzung unter Windows nichts mehr im Wege.