[PYTHON] [Einführung in cx_Oracle] Übersicht über cx_Oracle

Was ist cx_Oracle?

cx_Oracle ist ein Modul für den SQL-Zugriff von Python auf Oracle Database. Erstellt von Oracle. Es ist so konzipiert, dass es mit PEP 249 (Python Database API Specification v2.0) so kompatibel wie möglich ist. Die Version von cx_Oracle zum 1. Juni 2020 (ursprünglich in diesem Artikel veröffentlicht) ist 7.3. Es läuft unter Python 2.7 oder höher oder Python 3.5 oder höher. Die Lizenz ist eine BSD-Lizenz. Der DB-Zugriffsteil verwendet ODPI-C (Oracle Database Programming Interface für C), eine von Oracle bereitgestellte Oracle-Datenbankzugriffsbibliothek für die OSS C-Sprache, anstelle von Pro * C. cx_Oracle hat die folgenden Hauptfunktionen.

• Grundlegender SQL-Zugriff (DML / DDL / DCL)
• Ausführung von PL / SQL (anonymes PL / SQL, gespeichertes Programm)
• Unterstützung für SODA (Simple Oracle Document Access, API für den Zugriff auf den JSON-Dokumentenspeicher)
• Unterstützung für XML-DB (XML-Typ)
• Unterstützung für Objektfunktionen
• Bereitstellung eines clientseitigen Verbindungspools
• Unterstützung für andere Oracle-Datenbankfunktionen (Start / Stopp der Instanz usw.)

grundlegende Quellen von cx_Oracle

Alle sind englischsprachig.

• Offizielle Dokumentation
• GitHub

Installation von cx_Oracle

Vorbereitung

Ein Oracle-Client ist erforderlich, um cx_Oracle verwenden zu können. Es gibt kein Problem mit Instant Client. In Java gibt es kein Äquivalent zu Thin Driver. Die Version von Oracle Client ist mit 11.2 und höher kompatibel. Auf der Seite des Verbindungsziel-Oracle-Datenbankservers ist die Version verfügbar, die von dem von Ihnen verwendeten Oracle-Client unterstützt wird. Stellen Sie vor dem Testen einer Anwendung, die cx_Oracle verwendet, sicher, dass Sie von dem Computer, auf dem Sie cx_Oracle installieren möchten, auf die Oracle-Datenbank zugreifen können, z. B. mit SQL * Plus oder SQL Developer.

Installation

Es kann mit einem Paketmanager wie pip oder conda installiert werden. Unten finden Sie ein Beispiel für die Installation mit pip.

pip install cx_Oracle

Beispielanwendung

sample01a.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import cx_Oracle  # (1)

USERID = "admin"
PASSWORD = "FooBar"
DESTINATION = "atp1_low"
SQL = "select 12345 from dual"

connection = cx_Oracle.connect(USERID, PASSWORD, DESTINATION)  # (2)
cursor = connection.cursor()  # (3)
cursor.execute(SQL)  # (4)
for row in cursor:  # (5)
    print(row[0])  # (6)
connection.close()  # (7)

Das Folgende ist eine unnötige Ebene für diejenigen, die Anwendungen erstellt haben, die in anderen Sprachen auf Oracle Database zugreifen. Jede Zeile wird jedoch anhand der Kommentarnummer in der Quelle kurz erläutert.

1. Sie müssen cx_Oracle importieren.
2. Stellen Sie eine Verbindung zur Datenbank her und richten Sie eine Sitzung ein.
3. Erstellen Sie ein Cursorobjekt für SQL-Anweisungen.
4. Führen Sie die SQL-Anweisung aus.
5. Da wir diesmal eine SELECT-Anweisung ausgeben, extrahieren wir den Inhalt der Ergebnismenge.
6. Der Datensatz wird zurückgetippt.
7. Trennen Sie die Sitzung.