Einführung in PL/SQL

Transkript

1 Einführung in PLSQL Prozedurale Erweiterung der Sprache SQL um Elemente wie Variablen, Schleifen, Bedingungen, Ausnahmebehandlung Code läuft innerhalb der Datenbank ab und ist deshalb sehr performant Zusätzlich große Anzahl an vordefinierten Bibliotheken (packages) verfügbar. Einsatzfelder: anonyme Blöcke Funktionen und Prozeduren, Methoden Trigger Andreas Schmidt Einführung in PLSQL 122

2 Struktur eines PLSQL Programms DECLARE BEGIN EXCEPTION END; -- Deklarationen -- eigentlicher -- Programmteil -- Fehlerbehandlung Deklarations und Ausnahmebehandlung sind optional beliebige Schachtelung der Blöcke ineinander möglich Deklarationsteil erlaubt Definition von Variablen, Konstanten, Cursorn, Funktionen und Prozeduren Variablen in dem Block gültig in dem sie deklariert wurden Kommentare: -- ich bin ein Kommentar * ich bin ein mehrzeiliger Kommentar * Andreas Schmidt Einführung in PLSQL 222

3 Datentypen in PLSQL BINARY_INTEGER Wertebereich NUMBER [(Länge, Nachkommastelle)] 38 Stellen Genauigkeit CHAR [(Länge)] maximale Länge von Bytes VARCHAR2 [(Länge)] BOOLEAN DATE ROWID CURSOR Beispiel DECLARE owner char(10) := ich ; tablename char(30); bytes number(10) := ; today date not Null; ok boolean; pi constant number := ; zaehler number(5) := 1; CURSOR spieler_cursor is select * from spieler order by name; Andreas Schmidt Einführung in PLSQL 322

4 Datentypen in PLSQL Namen von Tabellen und Spalten sind als vordefinierte Variable vorhanden Attribut %TYPE liefert Datentyp einer anderen Variablen oder einer Tabellenspalte Attribut %ROWTYPE liefert Datentyp einer Tabellenzeile (Zugriff auf einzelne Felder über. - Notation) Beispiele: DECLARE stadt_name Stadt.name%type; nevada Wueste%rowtype; groesse Wueste.flaeche%type; hauptstadt stadt_name%type; BEGIN... groesse := nevada.flaeche; Tabelle Wueste Spalte name in Tabelle Stadt Andreas Schmidt Einführung in PLSQL 422

5 Bildschirmausgabe PLSQL Programme erzeugen normalerweise keine Bildschirmausgabe spezielles Paket zur Bildschirmausgabe verfügbar (DBMS_OUTPUT) Bildschirmausgabe mit Prozedur: DBMS_OUTPUT.PUT_LINE(<zeichenkette>); Bildschirmausgabe kann an und ausgeschaltet werden (Default OFF) Anweisung (SQLPLUS Sitzung) 1 : SET SERVEROUTPUT ON OFF [SIZE <numbytes>] Beispiel: SQL> set serveroutput on size BEGIN DBMS_OUTPUT.PUT_LINE( Hallo designierter PLSQL Crack!! ); END; 1. SQLDeveloper: Menue >> Ansicht >> DBMS-Ausgabe (auf Pluszeichen drücken und passende Datenbankverbindung angeben) Andreas Schmidt Einführung in PLSQL 522

6 Kontrollstrukturen Zuweisungen Zuweisungsoperator := a := b * c; INTO Operator mit SELECT (nur, wenn genau ein Datensatz zurückgeliefert wird) declare anzahl_millionen_staedte number; select count(*) into anzahl_millionen_staedte from mondial.city where population > ; dbms_output.put_line('es gibt ' anzahl_millionen_staedte ' Millionenstädte in der Mondial Datenbank'); FETCH... INTO (Mit Cursor) FETCH cur_station INTO s_id, x, y; Andreas Schmidt Einführung in PLSQL 622

7 Kontrollstrukturen (bedingte Anweisungen) bedingte Verzweigung IF <bedingung> THEN <anweisungen> END IF; Alternative IF <bedingung> THEN <anweisungen> ELSE <anweisungen> END IF; mehrere Alternativen IF <bedingung 1> THEN <anweisungen> ELSIF <bedingung 2> THEN <anweisungen> ELSIF <bedingung 3> THEN <anweisungen> ELSE <anweisungen> END IF; Andreas Schmidt Einführung in PLSQL 722

8 Kontrollstrukturen (Schleifen) LOOP... END LOOP a := 0; LOOP a := a + 1; if a = 50 then exit; end if; END LOOP; FOR <zaehlbereich> LOOP... END LOOP FOR i IN LOOP insert into buch (kapitel, text) values (i, text(i)); END LOOP; Rückwärts FOR i in REVERSE loop dbms_output.put_line(i); END LOOP; WHILE <bed> LOOP... END LOOP a := 0; WHILE a <= 50 LOOP b := b + a; a := a + 1; END LOOP; Andreas Schmidt Einführung in PLSQL 822

9 Ausnahmebehandlung Behandlung von Fehlern und Ausnahmesituationen durch Exceptionhandler Tritt Aufnahme auf, so wird normaler Ablauf abgebrochen und eine Fehlerbehandlung durchgeführt. Fehlerbehandlung erfolgt in EXCEPTION- Block. Ausnahmen können vordefiniert oder benutzerdefiniert sein. Beispiel (vordefinierte Ausnahme) DECLARE eine_stadt mondial.city%rowtype; stadt_name varchar2(20) := 'Karlsruhe'; -- alternativ: 'Metropolis' 'Springfield' BEGIN SELECT * INTO eine_stadt FROM mondial.city WHERE name = stadt_name; dbms_output.put_line(eine_stadt.name ' hat ' eine_stadt.population ' Einwohner'); EXCEPTION when no_data_found then dbms_output.put_line('stadt ' stadt_name ' gibt es nicht'); when too_many_rows then dbms_output.put_line('stadt ' stadt_name ' gibt es es mehrfach'); END; Andreas Schmidt Einführung in PLSQL 922

10 vordefinierte Ausnahmen Fakultät IWI Exception Oracle Error SQLCODE ACCESS_INTO_NULL ORA COLLECTION_IS_NULL ORA CURSOR_ALREADY_OPEN ORA DUP_VAL_ON_INDEX ORA INVALID_CURSOR ORA INVALID_NUMBER ORA LOGIN_DENIED ORA NO_DATA_FOUND ORA NOT_LOGGED_ON ORA PROGRAM_ERROR ORA ROWTYPE_MISMATCH ORA STORAGE_ERROR ORA SUBSCRIPT_BEYOND_COUNT ORA SUBSCRIPT_OUTSIDE_LIMIT ORA TIMEOUT_ON_RESOURCE ORA TOO_MANY_ROWS ORA VALUE_ERROR ORA ZERO_DIVIDE ORA Erläuterungen: Andreas Schmidt Einführung in PLSQL 1022

11 Ausnahmebehandlung - eigene Ausnahmen DECLARE exep_moloch exception; eine_stadt mondial.city%rowtype; stadt_name varchar2(20) := 'San Francisco'; -- alternativ: 'Mexico City' BEGIN SELECT * INTO eine_stadt FROM mondial.city WHERE name = stadt_name; if eine_stadt.population > then raise exep_moloch; end if; dbms_output.put_line(eine_stadt.name ' hat ' eine_stadt.population ' Einwohner'); EXCEPTION when exep_moloch then dbms_output.put_line('stadt ' eine_stadt.name ' ist zu groß für mich'); when others then dbms_output.put_line('fehler: ' sqlerrm); END; Andreas Schmidt Einführung in PLSQL 1122

12 CURSOR SQL Anweisung liefert i.a. eine Menge von Tupeln zurück Cursor zur sequentiellen Abarbeitung der Ergebnismenge Deklaration: DECLARE... cursor c1 is select * from land; Zugriff auf den Inhalt mittels OPEN FETCH CLOSE Status des Cursors %ISOPEN %FOUND %NOTFOUND %ROWCOUNT Andreas Schmidt Einführung in PLSQL 1222

13 CURSOR Programmcode: declare cursor cur_french_city is select * from mondial.city c where c.country = 'F' and c.population is not null order by c.population desc; a_city mondial.city%rowtype; OPEN cur_french_city; FETCH cur_french_city INTO a_city; WHILE cur_french_city%found LOOP dbms_output.put_line('datensatz: ' cur_french_city%rowcount ' Stadt: ' a_city.name ' (' a_city.population ')'); FETCH cur_french_city INTO a_city; END LOOP; CLOSE cur_french_city; Ausgabe: Datensatz: 1 Stadt: Paris ( ) Datensatz: 2 Stadt: Marseille (800550) Datensatz: 3 Stadt: Lyon (415487) Datensatz: 4 Stadt: Toulouse (358688) Datensatz: 5 Stadt: Nice (342439) Datensatz: 6 Stadt: Strasbourg (252338) Datensatz: 7 Stadt: Nantes (244995) Datensatz: 8 Stadt: Bordeaux (210336) Datensatz: 9 Stadt: Montpellier (207996) Datensatz: 10 Stadt: Saint Etienne (199396) Datensatz: 11 Stadt: Rennes (197536) Datensatz: 12 Stadt: Le Havre (195854) Datensatz: 13 Stadt: Reims (180620)... Andreas Schmidt Einführung in PLSQL 1322

14 CURSOR Kurzform (ohne OPEN, FETCH, CLOSE) declare cursor cur_french_city is select * from mondial.city c where c.country = 'F' and c.population is not null order by c.population desc; FOR a_city in cur_french_city LOOP dbms_output.put_line('datensatz: ' cur_french_city%rowcount ' Stadt: ' a_city.name ' (' a_city.population ')'); END LOOP; Andreas Schmidt Einführung in PLSQL 1422

15 CURSOR ohne explizite Cursorvariable: FOR a_city in (select * from mondial.city c where c.country = 'F' and c.population is not null order by c.population desc) LOOP dbms_output.put_line('datensatz: ' cur_french_city%rowcount ' Stadt: ' a_city.name ' (' a_city.population ')'); END LOOP; Andreas Schmidt Einführung in PLSQL 1522

16 CURSOR mit Parametern in where Klausel können Auswahlkriterien angegeben werden Werte können beim öffnen des Cursors mit übergeben werden z.b.: OPEN cur_city('d'); Ideal bei geschachtelten Tabellen Beispiel declare cursor cur_city(country_id char) is select * from mondial.city c where c.country = country_id and c.population is not null order by c.population desc; FOR a_city in cur_city('d') LOOP dbms_output.put_line('datensatz: ' cur_city%rowcount ' Stadt: ' a_city.name ' (' a_city.population ')'); END LOOP; END; Andreas Schmidt Einführung in PLSQL 1622

17 Funktionen, Prozeduren Definition von Prozeduren und Funktionen innerhalb eines PLSQL Blocks Integration von Prozeduren und Funktionen als Datenbankobjekte Übergabeparameter können als IN, OUT und IN OUT deklariert werden. Übergabeparameter können einen Standardwert besitzen Parametertypen ohne Größenangabe Beispiel Prozedurkopf. procedure spielzug(spieler_id in integer, ziel_station in integer, ticket in varchar default 'Taxi') is -- Implementierung; Prozedur-Funktionsrumpf entspricht einem PLSQL-Block ohne Schlüsselwort DECLARE Andreas Schmidt Einführung in PLSQL 1722

18 Funktionen, Prozeduren Funktionsdeklaration entspricht Prozedurdeklaration mit Unterschied, dass Ergebnistyp der Funktion angegeben wird. Rückgabe der berechneten Ergebnisse mittels Schlüsselwort RETURN. Beispiel: function minimum(a in number, b in number) return number is if a < b then return a; else return b; end if; Aufruf: dbms_output.put_line('min. von 12 und -7:' minimum(12,-7)); Andreas Schmidt Einführung in PLSQL 1822

19 Beispiel declare m number; function minimum(a in number, b in number) return number is if a < b then return a; else return b; end if; procedure maximum(a in number, b in number, res out number) is if a > b then res := a; else res := b; end if; dbms_output.put_line('minimum von 12 und -7: ' minimum(12,-7)); maximum(2,-4, m); dbms_output.put_line('maximum von 2 und -4: ' m); Andreas Schmidt Einführung in PLSQL 1922

20 ProzedurenFunktionen als Datenbankobjekte Abspeichern von FunktionenProzeduren als benannte Datenbankobjekte FunktionenProzeduren können von SQLPLUS TOAD..., PLSQL Code oder auch über OCI, ODBC, JDBC aus aufgerufen werden. Aufruf (Definition rechte Seite); SQL> dbms_output.put_line('fak(5)=' fak(5)); Beispiel einer Funktionsdeklaration: create or replace function fak(z in integer) return number is f number := 1; for i in 2..z loop f := f * i; end loop; return f; alternative kurzform (1-Zeiler): SQL> exec dbms_output.put_line('fak(5)=' fak(5)); Andreas Schmidt Einführung in PLSQL 2022

21 ProzedurenFunktionen als Datenbankobjekte Fehler bei Definition einer ProzedurFunktion können mit dem SQLPLUS Kommando show errors angezeigt werden Aufruf von PLSQL Funktionen auch innerhalb von SQL Statements Funktionen können mit Ausführungsrechten versehen werden (Kapselung) FunktionenProzeduren können als EXTERN deklariert sein (Implementierung in Java, C++,...) Tabelle user_source enthält alll benutzerdefinierten Datenbankobjekte SQL> desc user_source Name Typ NAME VARCHAR2(30) TYPE VARCHAR2(12) LINE NUMBER TEXT VARCHAR2(4000) select text from user_source where name='fak' and type='function' order by line; Andreas Schmidt Einführung in PLSQL 2122

22 Literaturweitere Informationsquellen Einführung in PLSQL: Oracle PLSQL Programmierung, 2. Auflage; Steven Feuerstein & Bill Pribyl; Deutsche Übersetzung von Dorothea Reder; O Reilly; 2. Auflage April 2003; ISBN X; Seiten 1084; Oracle PLSQL - kurz & gut, 2. Auflage; Steven Feuerstein, Bill Pribyl & Chip Dawes; Deutsche Übersetzung von Wolfgang Gabriel & Lars Schulten; 2. Auflage September 2003; ISBN ; Seiten 134; 8.90 Overview of PLSQL (Oracle Seiten): Andreas Schmidt Einführung in PLSQL 2222