http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Pythonhttp://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Installer_les_outilsEn introduction, je parlais de jeu d'enfant. Mais avant de pouvoir s'amuser, il faut passer par la corvée de l'installation. En fait, j'exagère un peu: ici encore rien de vraiment rébarbatif. Comme à mon habitude, je vais donner ici la procédure pour Linux.

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#PythonTout d'abord, je suppose que vous avec une version de Python récente déjà installée sur votre machine. La dernière version de cx_Oracle au moment où j'écris est la 5.1.3 — compatible avec Python 2.7, 3.3 et 3.4. En ce qui me concerne, j'utiliserai ici Python 3.4.1:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Oracle_InstantClientEnsuite, en plus de python, vous aurez besoin des bibliothèques et du SDK Oracle InstantClient. Pour les obtenir, il faut vous rendre sur la page de téléchargement du site d'Oracle. Là, vous devrez choisir votre architecture et accepter la licence d'utilisation avant de pouvoir télécharger les fichiers nécessaires. Dans mon cas, il s'agit des fichiers instantclient-basic-linux.x64-12.1.0.2.0.zip et instantclient-sdk-linux.x64-12.1.0.2.0.zip.

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#cx_OracleVoilà, c'est presque fini. Il vous reste à définir la variable d'environnement ORACLE_HOME puis à rajouter le chemin vers les bibliothèque à LD_LIBRARY_PATH et vous pourrez installer cx_Oracle:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Tester_l.27installationSi tout se passe comme prévu, après quelques secondes vous serez en mesure de tester votre installation:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#UtilisationPassons maintenant au vif du sujet en tentant une première requête. Quelque chose de simple, mais qui utilise quand même une construction spécifique à Oracle, juste pour se convaincre que j'utilise bien un driver dédié:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Premi.C3.A8re_requ.C3.AAtePassons maintenant au vif du sujet en tentant une première requête. Quelque chose de simple, mais qui utilise quand même une construction spécifique à Oracle, juste pour se convaincre que j'utilise bien un driver dédié:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#R.C3.A9cup.C3.A9rer_les_lignes_comme_un_dictionnaireSi récupérer un tuple n'est pas satisfaisant, cx_Oracle vous offre la possibilité de définir votre propre format pour les lignes lues. Cela passe par la définition d'une fonction chargée de convertir le tuple original à votre guise:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Transmettre_des_donn.C3.A9es_non-ASCIIJe n'ai pas trop insisté dessus jusqu'à présent, mais il est (heureusement) possible de transmettre et recevoir des données non-ASCII avec cx_Oracle. Comme vous l'avez peut-être remarqué dans l'exemple précédent j'ai défini la variable d'environnement NLS_LANG à une valeur adaptée avant d'ouvrir la connexion à la base de données. Cela a été indispensable afin d'utiliser l'alias prénom (avec un accent) pour l'une des colonnes récupérées:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Commandes_de_d.C3.A9finitions_de_donn.C3.A9es_.28DDL_statements.29Pour continuer notre exploration de cx_Oracle, voyons maintenant comment envoyer des commandes de définition de données (CREATE, DROP, ...). Par exemple pour créer une table:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Ins.C3.A9rer_des_donn.C3.A9esEn se basant sur la table créée dans la section précédente, voyons comment transmettre une requête pour insérer des données. En soi même, cela n'a rien de spécial. Mais c'est une très bonne occasion pour évoquer quelques petites choses... Mais, tout d'abord, le code:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Utiliser_la_connexion_comme_gestionnaire_de_contexteUn gestionnaire de contexte (PEP-343  The "with" Statement) est une construction introduite avec Python 2.5 et qui permet de garantir que certaines taches seront exécutées automatiquement à la sortie d'un bloc. C'est très utile par exemple pour s'assurer qu'un fichier sera fermé quoi qu'il arrive. Ou, dans notre cas, qu'une transaction sera confirmé en cas de sortie normale du bloc. Avec le corollaire que les modifications sont annulées si l'on sort du bloc à cause d'une exception. En pratique cela s'écrit ainsi:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Supprimer_des_enregistrementsPassons maintenant à la suppression d'un enregistrement. Mais tout d'abord, je vous rassure: nous n'allons pas faire l'inventaire de toutes les commandes SQL. Vous l'avez compris, le principe restera toujours le même. Néanmoins, je vais utiliser le prétexte d'une requête DELETE pour aborder un dernier point de détail:

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#ConclusionVoilà, ce rapide tour d'horizon de cx_Oracle est terminé. Je n'ai fait qu’effleurer les possibilités de ce module. Mais cela devrait déjà être suffisant pour vous permettre de stocker et récupérer des données, ou encore de modifier le schéma de votre base. Une fois que vous serez un peu plus familiarisé avec ces fonctionnalités élémentaires, n'hésitez pas à vous plonger dans la documentation officielle: celle-ci est un peu aride, mais avec de la persévérances, vous découvrirez que cx_Oracle est suffisamment souple pour s'adapter à de nombreux besoins tout en étant adapté aux spécificités d'Oracle.

]]>http://www.chicoree.fr/w/Acc%C3%A9der_%C3%A0_une_base_de_donn%C3%A9es_Oracle_%C3%A0_partir_de_Python#Ressources