:= 950; BEGIN DELETE FROM

Transcription

1 Cursori în PLSQL La fiecare execuţie a unei instrucţiuni SQL serverul Oracle deschide o zonă de memorie în care este analizată şi executată instrucţiunea. Această zonă de memorie se numeşte cursor. Există două tipuri de cursori: - cursor implicit; - cursor explicit. Cursor implicit Un cursor implicit este deschis ori de câte ori un bloc PLSQL execută o instrucţiune SQL. Acest cursor poate fi referit cu ajutorul identificatorului SQL şi este gestionat automat de PLSQL. Interacţiunea cu un cursor implicit se poate face doar prin intermediul a patru atribute ce permit evaluarea rezultatului execuţiei ultimei utilizări a cursorului implicit. Aceste atribute sunt: a) SQL%ROWCOUNT - este o valoare întreagă, reprezentând numărul de linii afectate de cea mai recentă instrucţiune SQL. b) SQL%FOUND - este TRUE dacă cea mai recentă instrucţiune SQL a afectat una sau mai multe linii. c) SQL%NOTFOUND - este TRUE dacă cea mai recentă instrucţiune SQL nu a afectat nici o linie. d) SQL%ISOPEN - are întotdeauna valoarea FALSE deoarece PLSQL închide cursorul implicit imediat după utilizare. Exemplul următor şterge acele linii din tabelul emp pentru care sal = 950. Pe ecran se va afişa numărul de linii şterse. v_sal NUMBER := 950; DELETE FROM emp WHERE sal = v_sal; DBMS_OUTPUT.PUT_LINE( Numar linii sterse: SQL%ROWCOUNT); Numar linii sterse: 2 PLSQL procedure successfully completed Cursor explicit Un cursor explicit se va utiliza pentru a procesa, linie cu linie, rezultatul execuţiei unei instrucţiuni SELECT multi-linie (instrucţiunea returnează mai multe linii). Un cursor explicit poate fi controlat conform următoarei diagramei din figura se declară cursorul (se furnizează numele său şi interogarea cu care va fi utilizat). 2. se deschide cursorul. Instrucţiunea OPEN execută interogarea şi realizează legătura cu eventualele variabile referite. Liniile identificate de interogare formează mulţimea activă şi sunt gata pentru a fi extrase. 3. se extrag datele din cursor. Instrucţiunea FETCH încarcă linia curentă din cursor în variabile. Fiecare extragere determină cursorul să-şi avanseze pointerul la următoarea linie din mulţimea activă. În diagrama anterioară fiecare extragere testează dacă mai există linii neparcurse încă. Dacă da, încarcă linia curentă în variabile, dacă nu, închide cursorul. 4. se închide cursorul. Instrucţiunea CLOSE eliberează mulţimea activă de linii.

2 1. creează o zonă identifică încarcă linia testează existenţa eliberează SQL identificată mulţimea curentă în altor linii; mulţimea printr-un nume activă variabile se întoarce la activă (rezultatul FETCH dacă mai interogării) există linii Figura 1. Controlul unui cursor explicit În continuare vom analiza cei patru paşi enumeraţi anterior. 1. Declararea unui cursor Declararea unui cursor se face în secţiunea declarativă a unui bloc PLSQL cu ajutorul următoarei sintaxe: CURSOR nume_cursor IS instructiune_select; unde: nume_cursor instructiune_select este un identificator PLSQL este o instrucţiune SELECT FĂRĂ clauză INTO În instrucţiunea SELECT se poate face referire la alte variabile, dar acestea trebuie declarate înaintea cursorului. v_deptno dept.deptno%type; CURSOR c2 IS SELECT * FROM dept WHERE deptno = v_deptno; 2. Deschiderea unui cursor Instrucţiunea ce realizează deschiderea unui cursor este OPEN nume_cursor; 2. OPEN 3. FETCH OPEN este o instrucţiune ce realizează următoarele operaţii: EMPTY? 4. CLOSE - alocă dinamic memorie pentru o zonă de memorie context ce poate conţine informaţii importante pentru procesare; - validează corectitudinea instrucţiunii SELECT; - leagă variabilele de intrare (setează valoarea variabilelor de intrare); - identifică mulţimea rezultat mulţimea de linii ce satisfac criteriul de selecţie. Execuţia acestei instrucţiuni nu conduce la extragerea liniilor din rezultat în variabile; - poziţionează pointerul înaintea primei linii din mulţimea activă. Notă: - dacă interogarea nu returnează nici o linie în momentul deschiderii cursorului, PLSQL nu va genera nici o excepţie; No Yes

3 - în cazul cursorilor declaraţi cu clauză FOR UPDATE instrucţiunea OPEN blochează accesul la liniile returnate. 3. Extragerea datelor dintr-un cursor Instrucţiunea FETCH extrage câte o linie din mulţimea activă. După fiecare extragere, cursorul avansează la următoarea linie din mulţime. FETCH nume_cursor INTO <var1, var2, nume_inregistrare> unde: nume_cursor este numele unui cursor; var1, var2 sunt variabile de ieşire ce memorează rezultatele; nume_inregistrare este numele înregistrării în care sunt stocate datele extrase. Înregistrarea poate fi declarată utilizând atributul %ROWTYPE. Indicaţii: - includeţi acelaşi număr de variabile în clauza INTO a instrucţiunii FETCH câte coloane sunt precizate în lista ţintă a instrucţiunii SELECT şi asiguraţi-vă că tipurile de date sunt compatibile; - corespondenţa între variabile şi coloane se face pe baza poziţiei în cele două liste; - ca alternativă la utilizarea variabilelor se poate declara o variabilă de tip înregistrare pe baza cursorului, clauza INTO referind înregistrarea; - obligatoriu trebuie realizat un test pentru a verifica dacă mai există linii în cursor. Dacă un FETCH nu mai extrage nici o linie înseamnă că nu mai există linii de procesat şi nu se va genera nici o eroare. Operaţiile realizate de instrucţiunea FETCH sunt: - avansează pointerul la următoarea linie din mulţimea activă; - citeşte datele din linia curentă în variabile de ieşire PLSQL; v_empno emp.empno%type; v_ename emp.ename%type; i NUMBER := 1; OPEN c1; FOR i IN LOOP FETCH c1 INTO v_empno, v_ename; CLOSE c1; Acest exemplu memorează în variabilele v_empno şi v_ename numărul de înregistrare şi numele fiecărui angajat din tabelul emp. 4. Închiderea unui cursor Închiderea unui cursor se realizează cu instrucţiunea CLOSE nume_cursor; Această instrucţiune dezactivează cursorul, mulţimea activă devine nedefinită, iar zona context este eliberată. Încercarea de a extrage date dintr-un cursor închis va rezulta în ridicarea excepţiei

4 INVALID_CURSOR. Ca şi în cazul cursorilor impliciţi, există patru atribute ce pot fi utilizate pentru a obţine informaţii în legătură cu starea unui cursor. Atribut Tip Descriere %ISOPEN boolean evaluat TRUE dacă este deja deschis cursorul %NOTFOUND boolean evaluat TRUE dacă cea mai recentă instrucţiune FETCH nu returnează nici o linie %FOUND boolean evaluat TRUE dacă cea mai recentă instrucţiune FETCH returnează o linie %ROWCOUNT number indică numărul total de linii extrase până în momentul respectiv Notă: Într-o instrucţiune SQL nu se poate face referire la atributul unui cursor. Metoda cea mai uzuală de a procesa mai multe linii dintr-un cursor este de a utiliza o buclă pentru a extrage câte o linie la fiecare iteraţie. După procesarea ultimei linii, un nou FETCH va determina evaluarea atributului %NOTFOUND la valoarea TRUE. Astfel, valoarea acestui atribut ar trebui utilizată pentru părăsirea buclei, întrucât nu mai există alte linii de procesat. Modul de utilizare a atributelor %NOTFOUND şi %ROWCOUNT pentru specificarea condiţiei de ieşire din buclă este ilustrat în următorul exemplu: v_empno emp.empno%type; v_ename emp.ename%type; i NUMBER := 1; OPEN c1; LOOP FETCH c1 INTO v_empno, v_ename; EXIT WHEN c1%rowcount > 10 OR c1%notfound; CLOSE c1; Cursori şi înregistrări Am văzut cum datele returnate de o interogare pot fi stocate, linie cu linie, în variabile PLSQL. Se poate defini o variabilă înregistrare pe baza coloanelor dintr-un cursor explicit şi apoi utiliza pentru memorarea unei linii din cursor. Avantajul constă în aceea că valorile fiecărei linii vor fi încărcate direct în câmpurile corespunzătoare din înregistrare. Exemplul următor declară cursorul c1 şi înregistrarea inreg_emp, având structura unei linii din cursor. inreg_emp c1%rowtype; -- inregistrarea va avea doua OPEN c1; FETCH c1 INTO inreg_emp; -- campuri: empno si ename

5 Bucla cursor FOR O buclă cursor FOR procesează liniile unui cursor explicit, realizând următoarele operaţii: - cursorul este deschis automat; - este extrasă, automat, câte o linie la fiecare iteraţie; - cursorul este închis automat după ce au fost procesate toate liniile; Sintaxa pentru o astfel de buclă FOR este: FOR nume_inreg IN nume_cursor LOOP instructiune1 instructiune2 unde: nume_inreg nume_cursor este numele unei înregistrări declarate implicit; este identificatorul cursorului. FOR inreg_emp IN c1 LOOP -- deschidere implicita şi FETCH implicit IF inreg_emp.empno = 7839 THEN END IF; -- inchidere automata cursor Notă: Se poate înlocui cursorul c1 din exemplul de mai sus cu o subinterogare SQL. Dezavantajul acestei variante constă în imposibilitatea de a mai testa atributele cursorului, cursorul nefiind declarat. -- deschidere implicita şi FETCH implicit FOR inreg_emp IN ( FROM emp) LOOP IF inreg_emp.empno = 7839 THEN -- inchidere automata cursor Cursori expliciţi cu parametri PLSQL permite declararea unui tip de cursor, numit cursor cu parametri, care returnează diferite mulţimi active în funcţie de valorile parametrilor. Parametrii permit pasarea de valori unui cursor atunci când acesta este deschis, valori ce vor fi utilizate în execuţia interogării asociate. Sintaxa ce permite declararea unui cursor explicit cu parametri este următoarea: CURSOR nume_cursor [(nume_parametru tip_date, )] IS instructiunesql unde: nume_cursor este un identificator PLSQL

6 nume_parametru este numele parametrului. Sintaxa asociată unui parametru este următoarea: nume_parametru [IN] nume_tip [<:= DEFAULT> expr] tip_date instructiunesql este un tip scalar de date este o instrucţiune SELECT fără clauză INTO Observaţii: - fiecărui parametru formal din declaraţia cursorului trebuie să-i corespundă un parametru actual în instrucţiunea OPEN. - tipurile de date ale parametrilor sunt aceleaşi ca în cazul variabilelor scalare, dar fără a preciza dimensiunea. - numele parametrilor sunt utilizate pentru referiri în interogarea asociată cursorului. În exemplul următor este ilustrat modul de declarare a unui cursor cu doi parametri. CURSOR c1 (v_deptno NUMBER, v_job VARCHAR2) IS FROM emp WHERE deptno = v_deptno AND job = v_job; OPEN c1(10, 'CLERK'); Valorile pasate parametrilor unui cursor pot proveni şi de la variabile PLSQL sau variabile ale mediului gazdă. job_emp emp.job%type := 'CLERK'; v_ename emp.ename%type; CURSOR c1 (v_deptno NUMBER, v_job VARCHAR2) IS FROM emp WHERE deptno = v_deptno AND job = v_job; job_emp := ANALYST ; OPEN c1(10, job_emp); De asemenea se pot pasa parametri unui cursor utilizat în buclă cursor FOR: CURSOR c1 (v_deptno NUMBER, v_job VARCHAR2) IS SELECT FOR inreg_emp IN c1(10, CLERK ) LOOP FOR inreg_emp IN c1(20, ANALYST ) LOOP

7 Variabila inreg_emp va baleia două mulţimi active diferite: mulţimea angajaţilor ce lucrează în departamentul 10 şi au funcţia CLERK (corespunzătoare primei bucle cursor FOR), respectiv mulţimea angajaţilor ce lucrează în departamentul 20 şi au funcţia ANALYST (corespunzătoare celei de a doua bucle cursor FOR). Clauza FOR UPDATE Utilizarea clauzei FOR UPDATE în instrucţiunea SQL asociată unui cursor va avea ca efect blocarea liniilor ce urmează a fi actualizate sau şterse. SELECT FROM FOR UPDATE [OF referinta_coloana] [NOWAIT] unde: referinta_coloana NOWAIT este o coloană din tabelul supus interogării. Se poate utiliza şi o listă de coloane. returnează o eroare Oracle dacă liniile sunt blocate de o altă sesiune Dacă interogarea implică o joncţiune între mai multe tabele, se pot bloca linii dintr-un anumit tabel doar dacă FOR UPDATE face referire la o coloană din acel tabel. Clauza FOR UPDATE se va plasa la sfârşitul instrucţiunii SELECT, chiar şi după clauza ORDER BY, dacă aceasta există. FROM emp FOR UPDATE NOWAIT; Exemplul anterior utilizează opţiunea NOWAIT pentru a preveni situaţia în care ar trebui să aşteptăm un timp nedefinit dacă liniile sunt deja blocate de altă sesiune. Pentru astfel de situaţii este indicată utilizarea opţiunii NOWAIT în instrucţiunea SELECT FOR UPDATE şi testarea, într-o buclă, a codului de eroare returnat de încercarea nereuşită de a bloca liniile. Clauza WHERE CURRENT OF În cazul în care se doreşte referirea liniei curente dintr-un cursor explicit se va utiliza clauza WHERE CURRENT OF. Instrucţiunile UPDATE şi DELETE ce conţin această clauză fac referire la ultima linie procesată de instrucţiunea FETCH. WHERE CURRENT OF nume_cursor Exemplu SELECT FROM emp FOR UPDATE NOWAIT; FOR inreg_emp IN c1 LOOP UPDATE WHERE CURRENT OF c1; COMMIT; În exemplul de mai sus, instrucţiunea SQL UPDATE va opera asupra ultimei linii extrase din

8 cursor. Observaţi prezenţa clauzei FOR UPDATE în instrucţiunea SELECT asociată cursorului. (se blochează liniile tabelului emp ce vor fi actualizate cu scopul de a elimina posibilitatea ca alt utilizator să opereze simultan pe tabelul emp). Probleme 1. Implementaţi un bloc PLSQL ce realizează un top al angajaţilor din tabelul emp în raport cu salariile lor. a) cereţi utilizatorului introducerea unui număr n de la tastatură; b) extrageţi numele şi salariile primelor n persoane din tabelul emp având cele mai mari salarii; c) se presupune că nu există doi angajaţi cu acelaşi salariu; d) informaţiile vor fi inserate în tabelul TOP_SAL; e) testaţi blocul scris pentru diverse valori ale lui n: n = 0, n > nr_total_angajati. Introduceti numarul de angajati din top: 5 PLSQL procedure successfully completed Nume Salariu KING 5000 SCOTT 3000 FORD 3000 JONES 2975 BLAKE Aceeaşi problemă ca la punctul 1, dar considerând cazul în care mai mulţi angajaţi au acelaşi salariu. Dacă în TOP_SAL apare o persoană, atunci trebuie să apară toate persoanele având acelaşi salariu. De exemplu, dacă n = 2 atunci în TOP_SAL trebuie să apară KING, SCOTT şi FORD, iar dacă n = 3 atunci trebuie să participe la top persoanele KING, SCOTT, FORD şi JONES. Introduceti numarul de angajati din top: 2 PLSQL procedure successfully completed Nume Salariu KING 5000 SCOTT 3000 FORD Scrieţi un bloc PLSQL pentru a extrage din baza de date toate departamentele împreună cu angajaţii din fiecare departament. Rezultatele vor fi inserate în tabelul MESAJE. Utilizaţi un cursor pentru a extrage numărul fiecărui departament şi pasaţi fiecare număr de departament altui cursor care va extrage angajaţii din departamentul respectiv. REZULTAT KING - Departament 10 CLARK - Departament 10 MILLER - Departament 10 JONES - Departament 20 FORD - Departament 20 SMITH - Departament 20 SCOTT - Departament 20 ADAMS - Departament 20 BLAKE - Departament 30 MARTIN - Departament 30 ALLEN - Departament 30 TURNER - Departament 30 JAMES - Departament 30 WARD - Departament 30