[PYTHON] [Einführung in cx_Oracle] (12.) DB-Ausnahmebehandlung

Serialisierungstabelle

Serie: Einführung in den Inhalt von cx_Oracle

Überprüfungsumgebung

• Mit Oracle Cloud
• Oracle Linux 7.7 (VM.Standard2.1)
• Python 3.6
• cx_Oracle 8.0
• Oracle Database 19.5 (ATP, 1OCPU)
• Oracle Instant Client 18.5

cx_Oracle.DatabaseError Die Ausnahme cx_Oracle.DatabaseError ist eine Ausnahme von dem Problem, das bei der Verwendung von cx_Oracle aufgetreten ist. cx_Oracle.DatabaseError selbst ist eine Unterklasse von cx_Oracle.Error, einer Unterklasse des Python-Standardfehlers. Es gibt viele andere cx_Oracle-Ausnahmen, aber sie sind als Unterklassen einer dieser Ausnahmen definiert. Verwenden Sie cx_Oracle.DatabaseError, wenn Sie alle cx_Oracle-Ausnahmen unabhängig von Grundlagen oder Inhalten behandeln möchten.

sample12a.py

import cx_Oracle

USERID = "admin"
PASSWORD = "FooBar"
DESTINATION = "atp1_aaa"
SQL = """
        select object_id, owner, object_name, object_type
          from all_objects
         order by object_id
         fetch first 5 rows only
"""

with cx_Oracle.connect(USERID, PASSWORD, DESTINATION) as connection:
        cursor = connection.cursor()
        cursor.execute(SQL)
        for row in cursor:
                print(row)
        cursor.close()

$ python sample12a.py
Traceback (most recent call last):
  File "sample12a.py", line 13, in <module>
    with cx_Oracle.connect(USERID, PASSWORD, DESTINATION) as connection:
cx_Oracle.DatabaseError: ORA-12154: TNS:could not resolve the connect identifier specified

In sample12a.py wird ein TNS-Connector angegeben, der im Inhalt der Variablen DESTINATION in der 4. Zeile nicht vorhanden ist. Wenn Sie es ausführen, tritt daher immer ein Verbindungsfehler auf. Wenn Sie beim Codieren wie in diesem Beispiel keine spezielle Fehlerbehandlung durchführen, erhalten Sie eine Ausnahme von cx_Oracle.DatabaseError. Der Inhalt der Ausnahmemeldung ist die Oracle Database-Fehlernummer (ORA-xxxxx, Ausführungsbeispiel "ORA-12154"), die dem Fehlerinhalt entspricht, und die Fehlermeldung, die der Fehlernummer entspricht (Ausführungsbeispiel "TNS: Verbindung konnte nicht aufgelöst werden"). Kennung angegeben "). Die Fehlermeldung ist in Englisch, da die Umgebungsvariable NLS_LANG beim Ausführen dieses Beispiels nicht angegeben wurde. Wenn Sie japanische Fehlermeldungen erhalten möchten, setzen Sie bitte NLS_LANG.

Liste der Ausnahmen

Zusätzlich zu cx_Oracle.Error und cx_Oracle.DatabaseError werden Ausnahmen für einzelne Ereignisse und Ausnahmen definiert, die von der DB-API angegeben werden.

Variablen, die durch Ausnahmebehandlung behandelt werden können

Bei der Ausnahmebehandlung kann auf die folgenden schreibgeschützten Variableninformationen verwiesen werden. Diese sind zusammen im Args Taple enthalten.

Als Beispiel werden die obigen Variablen außerhalb des Beispiels verwendet, wie unten gezeigt. In diesem Beispiel wird die benutzerdefinierte Ausnahmefunktion von PL / SQL verwendet, um absichtlich den ORA-600 zu generieren, den jeder liebt (???).

sample12b.py

import cx_Oracle

USERID = "admin"
PASSWORD = "FooBar"
DESTINATION = "atp1_low"
SQL = """
declare
  e600 exception;
  pragma exception_init(e600, -600);
begin
  raise e600;
end;
"""
try:
    connection = cx_Oracle.connect(USERID, PASSWORD, DESTINATION)
    cursor = connection.cursor()
    cursor.execute(SQL)
except cx_Oracle.OperationalError as ex:
    error, = ex.args
    print("Ein Fehler ist aufgetreten. Bitte wenden Sie sich mit dem Fehlercode und der Meldung an den Administrator.")
    print("Fehlercode: ", error.code)
    print("Fehlermeldung: ", error.message)
finally:
    cursor.close()
    connection.close()

$ python sample12b.py
Ein Fehler ist aufgetreten. Bitte wenden Sie sich mit dem Fehlercode und der Meldung an den Administrator.
Fehlercode:  600
Fehlermeldung:  ORA-00600:Interner Fehlercode,Streit: [600], [], [], [], [], [], [], [], [], [], [], []
ORA-06512:Zeile 6