[Introduction à cx_Oracle] Présentation de cx_Oracle

Qu'est-ce que cx_Oracle

cx_Oracle est un module d'accès SQL de Python à Oracle Database. Créé par Oracle. Il est conçu pour être aussi conforme que possible avec PEP 249 (Python Database API Specification v2.0). La version de cx_Oracle au 1er juin 2020 (initialement publiée dans cet article) est la 7.3. Il fonctionne sur Python 2.7 ou version ultérieure, ou Python 3.5 ou version ultérieure. La licence est une licence BSD. La partie d'accès à la base de données utilise ODPI-C (Oracle Database Programming Interface for C), une bibliothèque d'accès à la base de données Oracle pour le langage OSS C fournie par Oracle, au lieu de Pro * C. cx_Oracle a les fonctions principales suivantes.

• Accès SQL de base (DML / DDL / DCL) --Exécution de PL / SQL (PL / SQL anonyme, programme stocké)
• Support pour SODA (Simple Oracle Document Access, API pour accéder au magasin de documents JSON)
• Prise en charge de la base de données XML (type XML)
• Prise en charge des fonctions d'objet
• Fourniture d'un pool de connexions côté client
• Prise en charge d'autres fonctions Oracle Database (démarrage / arrêt de l'instance, etc.)

sources de base de cx_Oracle

Tous sont basés en anglais.

• Documentation officielle
• GitHub

Installation de cx_Oracle

Préparation

Un client Oracle est requis pour utiliser cx_Oracle. Il n'y a aucun problème avec Instant Client. Il n'y a pas d'équivalent à Thin Driver en Java. La version d'Oracle Client est compatible avec les versions 11.2 et supérieures. Du côté du serveur de base de données Oracle de destination de la connexion, la version prise en charge par le client Oracle que vous utilisez sera disponible. Avant de tester une application qui utilise cx_Oracle, assurez-vous que vous pouvez accéder à la base de données Oracle à partir de la machine sur laquelle vous souhaitez installer cx_Oracle, par exemple en utilisant SQL * Plus ou SQL Developer.

Installation

Il peut être installé à l'aide d'un gestionnaire de paquets comme pip ou conda. Voici un exemple d'installation avec pip.

pip install cx_Oracle

Exemple d'application

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)

Ce qui suit est un niveau inutile pour ceux qui ont créé des applications qui accèdent à Oracle Database dans d'autres langues, mais chaque ligne est brièvement expliquée en fonction du numéro de commentaire dans la source.

1. Vous devez importer cx_Oracle.
2. Connectez-vous à la base de données et établissez une session.
3. Créez un objet curseur pour gérer les instructions SQL.
4. Exécutez l'instruction SQL.
5. Puisque nous émettons une instruction SELECT cette fois, nous extrayons le contenu de l'ensemble de résultats.
6. L'enregistrement est tapé en arrière.
7. Déconnectez la session.