Externe Prozeduren unter Windows mit dem Freeware-Compiler MinGW

Transkript

1 Externe Prozeduren unter Windows mit dem Freeware-Compiler MinGW Autor: Jens-Uwe Petersen, Trivadis GmbH DOAGNews Q1_2004 Dieses Werk ist urheberrechtlich geschützt. Die dadurch begründeten Rechte, insbesondere die der Übersetzung, des Nachdrucks, des Vortrags, der Entnahme von Abbildungen und Tabellen, der Funksendung, der Mikroverfilmung oder der Vervielfältigung auf anderen Wegen und der Speicherung in Datenverarbeitungsanlagen, bleiben, bei auch nur auszugsweiser Verwertung, vorbehalten. Eine Vervielfältigung dieses Werkes oder von Teilen dieses Werkes ist auch im Einzelfall nur in den Grenzen der gesetzlichen Bestimmungen des Urheberrechtes der Bundesrepublik Deutschland vom 9. September 1965 in der jeweils geltenden Fassung zulässig. Sie ist grundsätzlich vergütungspflichtig. Zuwiderhandlungen unterliegen den Strafbestimmungen des Urheberrechtsgesetzes.

2 Einleitung Es ist immer wieder ärgerlich, dass Microsoft seine Betriebssysteme im Gegensatz zu anderen Herstellern ohne Compiler ausliefert. Das separat von Microsoft zu erwerbende VisualStudio ist sicherlich ein sehr leistungsfähiges Produkt, aber auch sehr ressourcenintensiv (Preis, Einarbeitung, Plattenplatz). Für jemanden, der nur gelegentlich (und g schwind wie man im Schwäbischen sagt) ein paar Sourcen kompilieren möchte, ist das einfach zu aufwendig. Ursprünglich hatte ich für diese Zwecke den Compiler LCC-Win32 verwendet, der aber seit Anfang des Jahres nur noch für private Zwecke kostenlos ist. Auf der Suche nach einer Alternative bin ich dann recht schnell auf MinGW ("Minimalistic GNU for Windows") gestossen. MinGW basiert auf dem populären Gnu-Compiler GCC, erweitert um eine Reihe von Headerund Include-Dateien um native Windows-Applikationen erstellen zu können. Die folgenden Beispiele gehen davon aus, dass MinGW im Verzeichnis c:\programme\mingw installiert wurde und ORACLE_HOME unter c:\oracle\9i liegt. Erstes Beispiel Als erstes versuchen wir, das mit der Datenbank mitgelieferte Beispiel im Verzeichnis %ORACLE_HOME%\rdbms\extproc zum Laufen zu bekommen, das das Maximum zweier Werte ermittelt. Fügen Sie das MinGW\bin-Verzeichnis dem Suchpfad hinzu. PATH=c:\programme\MinGW\bin;%PATH% Um die Datei zu kompilieren auf DOS-Ebene in das Verzeichnis wechseln und den Compiler starten. Durch den Parameter shared wird gleich die DLL erzeugt. cd %ORACLE_HOME%\rdbms\extproc gcc -shared -o extern.dll extern.c Nun muss datenbankseitig noch die dazugehörige Wrapper-Funktion UseIt angelegt werden. Dies geschieht mit dem Skript extern.sql aus dem gleichen Verzeichnis. Gleich nach dem Anlegen wird UseIt auch ausgeführt, sodass als Ausgabe in etwa folgendes erscheinen sollte:

3 execute UseIt; The maximum of 1 and 2 is 2 PL/SQL-Prozedur wurde erfolgreich abgeschlossen. Unter Oracle9i Release 2 kann es zur Fehlermeldung ORA "Extproc agent: Invalid DLL Path" kommen, da hier standardmäßig nur DLLs in %ORACLE_HOME%\bin (Windows) bzw. %ORACLE_HOME%\lib (Unix) ausgeführt werden. In diesem Falle müssen Sie die LISTENER.ORA entsprechend anpassen. Für die Testumgebung mag es evntl. angehen die Verwendung aller DLLs erlauben: (ENVS="EXTPROC_DLLS=ANY") In Produktionsumgebungen sollte man aber aus Sicherheitsgründen unbedingt nur die wirklich benötigten DLLs freigeben. Für unsere Beispiele wären dies: (ENVS="EXTPROC_DLLS= c:\oracle\9i\rdbms\extproc\extern.dll;c:\programme\mingw\projects\callback") Für weitere Informationen dazu siehe Metalink Note Falls andere Fehler auftreten sollten, ist wahrscheinlich der Listener nicht richtig konfiguriert, dann siehe beispielsweise Metalink Note , das im Beispielverzeichnis enthaltene Readme.doc oder Kapitel 10 im Application Developers Guide. Zweites Beispiel Als nächstes wollen wir uns einem etwas komplexeren Beispiel zuwenden, das die Callback Möglichkeiten demonstrieren soll und unter %ORACLE_HOME%/rdbms/plsql/demo zu finden ist. Die beiden Dateien, die uns hier interessieren, heißen extproc.sql und extproc.c Um die Sourcen übersichtlich an einem Ort zu haben, erstellen wir im Projektverzeichnis von MinGW ein neues Verzeichnis callback.

4 cd c:\programme\mingw\projects\ mkdir callback cd callback copy %ORACLE_HOME%\plsql\demo\extproc.*. Dieses Beispiel verwendet die Oracle-Library oci.dll. Da die Libraries von Microsoft nicht kompatibel zu denen von MinGW sind, muss die Library erst konvertiert werden. reimp c:\oracle\9i\oci\lib\msvc\oci.lib Die erzeugte Textdatei OCI.def enthält eine Liste der enthaltenen Funktionen (und wird nicht weiter benötigt), liboci.a ist die konvertierte Library, die am besten ins lib-verzeichnis von MinGW kopiert wird. Jetzt noch schnell die DLL erzeugen: gcc -shared -o extproc.dll extproc.c -L. -loci -Ic:\oracle\9i\oci\include Dann in der Datenbank die Objekte anlegen: SQLPLUS SCOTT/TIGER CREATE OR REPLACE LIBRARY demolib IS 'c:\programme\mingw\projects\callback\extproc.dll'; Und zu guter Letzt kann nun das Ergebnis validiert werden: scott@tvd9i> set serveroutput on; scott@tvd9i> execute demopack.demo_procedure; ENAME : ALLEN JOB : SALESMAN SALARY : 1600 COMMISSION : 300 Percent Commission : 18,75 ENAME : MARTIN JOB : SALESMAN

5 SALARY : 1250 COMMISSION : 1400 Percent Commission : 112 Return value from CheckEmpName : 0 old_ename value on return : ANIL ENAME : 7369 HIREDATE : Employee Experience Test Passed. *************************************** Zusammenfassung Es wurde gezeigt, dass es auch unter Windows ohne großen Aufwand möglich ist, DLLs zu erzeugen und als externe Prozeduren einzusetzen. Was es für Schwierigkeiten mit windowseigenen Libraries wie z.b. kernel32.dll geben kann und wie Native Compilation mit MinGW eingesetzt wird, wird in weiteren Artikeln erklärt werden. Und damit wünsche ich Ihnen fehlerfreie Kompilate und erfolgreiches Outsourcen von Prozeduren... Jens-Uwe Petersen jens.petersen@trivadis.com Trivadis GmbH Max-Lang-Straße Leinfelden-Echterdingen Tel: Fax: