I denne leksjonen skal se på hvordan vi bruker innebygde og brukerdefinerte funksjoner.

Transkript

1 Avdeling for informatikk og e-læring, Høgskolen i Sør-Trøndelag Leksjon 04:Funksjoner Kjell Toft Hansen Lærestoffet er utviklet for faget LO177D Databaseprogrammering med PLSQL 1. Funksjoner I denne leksjonen skal se på hvordan vi bruker innebygde og brukerdefinerte funksjoner. Innhold 1.1. INNLEDNING INNEBYGDE FUNKSJONER Numeriske funksjoner Tekstfunksjoner Datofunksjoner Konverteringsfunksjoner Funksjonen DECODE Funksjonen CASE BRUKERDEFINERTE FUNKSJONER To-do-liste Kontroll av datatyper med brukerdefinerte funksjoner Deterministisk funksjon LITTERATUR SOM ER BRUKT Innledning En funksjon i SQL er en grunnleggende SQL-komponent som applikasjoner kan bruke gjennom SQL-spørringer. ANSIISO standarden for SQL definerer mange grunnleggende innebygde SQL funksjoner som en del av språket. Mange databasetjenere tilbyr også tilleggsfunksjoner. PLSQL tilbyr bruk av svært optimaliserte innebygde funksjoner som bør brukes når det er behov, istedenfor å forsøke å kode dem gjennom brukerdefinerte funksjoner Innebygde funksjoner Bruk av innebygde funksjoner kan minimalisere trafikken på nettverket og bedre den totale ytelsen. Istedenfor å simulere disse innebygde funksjonene med koding for hånd av PLSQLfunksjoner, er det ofte mye bedre å bruke de innebygde funksjonene. Selv i det tilfellet hvor en innebygd funksjon ser ut til å bli en «overkill», er det ofte bedre å bruke den enn å kode deler av funksjonaliteten.

2 Funksjoner side 2 av Numeriske funksjoner Numeriske funksjoner er redskap for manipulering av matematiske uttrykk og returnerer numeriske verdier. Noen av de mest vanlige funksjoner er COUNT, AVG, SUM, MAX og MIN. Under har vi et eksempel hvor vi bruker den numeriske funksjonen ROUND. Den runder av en numerisk verdi og fjerner desimaler. select delnr, pris, round(pris) avrundet_pris from prisinfo order by pris; Spørringens resultattabell blir: DELNR PRIS AVRUNDET_PRIS 51173, , , , , , , , , , , , , rows returned Et annet eksempel på en innebygd funksjon er RANDOM. Den bruker vi til å finne tilfeldige tall. La oss bruke den til å finne seks tilfeldige tall mellom 1 og 49: select r from ( select r from ( select rownum r from all_objects where rownum < 50) order by dbms_random.value) where rownum <= 6; Systemtabellen ALL_OBJECT er både sikker og hensiktsmessig til dette formålet. Den inneholder i det minste 1000 rader og alle brukere har tilgang til den.

3 Funksjoner side 3 av 11 Resultattabellen fra spørringen blir: R rows returned Tekstfunksjoner Tekstfunksjoner opererer på tekstverdier som skal legges inn i tabellene og på spørringer. Avhengig av hvilken type funksjon, så vil vi få forskjellig typer resultatverdier. Her følger et eksempel på bruken av funksjonen UPPER, som returnerer store bokstaver. select upper(beskrivelse) stor_bokstav from delinfo; Resultattabellen av spørringen blir da: STOR_BOKSTAV BINDERS KONTORSTOL LINJALSETT PULT SKRIVEBORD SKRIVEUNDERLAG SVARTE KULEPENNER BL ULEPENNER 8 rows returned Funksjonen CONCAT trekker sammen tekst fra ulike kolonner. Funksjonen NVL gir oss muligheten til å få ut en kommentar hvor verdien i tabellen har NULL verdi. Eksemplet som følger viser bruken av begge funksjonene. select upper (concat(concat(adresse,' '),levby)) adresse, upper(nvl(fylke,'fylke mangler')) fylke from levinfo; ADRESSE SKOLEGATA 3 OSLO VEIEN 178 TRONDHEIM VILLA VILLEKULLA TRONDHEIM AVENY 56 OSLO STORGT 56 GJENNOMVEIEN 78 6 rows returned FYLKE FYLKE MANGLER S-TR NDELAG S-TR NDELAG FYLKE MANGLER AKERSHUS TELEMARK

4 Funksjoner side 4 av 11 Det er også funksjoner som manipulerer en delstreng. Funksjonen RTRIM fjerner uønskete tegn fra en tekststreng. I eksempelet under ønsker vi å fjerne endingen «er» fra beskrivelsen til en del med del nummer 202. select delnr, rtrim(beskrivelse,'er') beskrivelse from delinfo where delnr = 202; DELNR BESKRIVELSE 202 Bl ulepenn En annen tekststrengfunksjon er SUBSTR. Den kutter kolonnebredden i resultattabellen. I tabellen Delinfo har vi satt av plass til 30 tegn i kolonnen beskrivelse. Den lengste tekststrengen som er lagt inn er på 15 tegn. Mao så vil resultattabellen sette av plass til 15 tomme tegn hvis vi ikke bruker SUBSTR. select delnr, substr(beskrivelse, 1, 15) beskrivelse from delinfo; Resultattabellen blir: DELNR BESKRIVELSE Binders 1 Kontorstol Linjalsett 3 Pult 4 Skrivebord 1909 Skriveunderlag 201 Svarte kulepenn 202 Bl ulepenner 8 rows returned Funksjonen USERENV kan brukes til å finne ut standardspråk. select userenv('language')språk from dual; Resultattabellen blir i vårt tilfelle: SPRÅK NORWEGIAN_NORWAY.WE8MSWIN1252 Tabellen Dual er en standard Oracle tabell som blir brukt som en dummytabell for å evaluere om en betingelse er sann. Når vi tester vår funksjon mot tabellen Dual, så gir tabellen en resultattabell. Vi bruker bare denne tabellen når resultattabellen skal inneholde metadata.

5 Funksjoner side 5 av Datofunksjoner Datofunksjoner brukes ved uttrykk som behandler tid. Under følger et eksempel på bruken av funksjonene SYSDATE og LAST_DATE. SYSDATE gir dagens dato og LAST_DATE gir siste dag i den måneden. select sysdate, last_day(sysdate) siste_dato, last_day(sysdate)-sysdate dager_igjen from dual; Resultattabellen etter kjøring av spørringen blir: SYSDATE SISTE_DATO DAGER_IGJEN Følgende spørring kan brukes til å opprette et utsnitt (eng. view) som kan hjelpe programutviklere til å finne riktig start- og siste dag i en spesifikk måned: select trunc(trunc(sysdate,'month')-1,'month') første_dag_siste_måned, trunc(sysdate,'month') siste_dag_siste_måned, trunc(sysdate,'month')første_dag_i_inneværende_måned, last_day(trunc(sysdate,'month')) siste_dag_i_inneværende_måned from dual; Når vi kjører spørringen får vi følgende resultattabell: FØRSTE_DAG_SISTE_ MÅNED SISTE_DAG_SISTE_ MÅNED FØRSTE_DAG_I_INNEVÆRENDE _MÅNED SISTE_DAG_I_INNEVÆRENDE _MÅNED Konverteringsfunksjoner Konverteringsfunksjoner brukes for å konvertere en datatype til en annen. Funksjonen TO_CHAR konverterer en datatype, i vårt eksempel en datotype til teksttype. select sysdate, to_char(sysdate, 'dd-mm-yyyy hh24:mi:ss') dato_tidspunkt from dual; SYSDATE DATO_TIDSPUNKT :31:39 I eksempelet under konverterer vi numeriske verdier til tekstverdier. select pris, to_char(pris, '9g990d99mi') tekststreng from prisinfo order by pris; I parameteren til funksjonen står tallet 9 for siffer, d for desimaltegn, g for tusenskille og 0 for første 0-verdi.

6 Funksjoner side 6 av 11 PRIS TEKSTSTRENG,35 0,35,44 0,44,57 0,57,85 0,85 1,5 1,50 1,5 1,50 1,6 1,60 1,76 1,76 1,9 1,90 2,6 2,60 3 3,00 6,5 6,50 7,35 7, ,00 219,99 219, , , , , ,00 20 rows returned Funksjonen DECODE Funksjonen DECODE tillater bruk av IF-THEN logikk. DECODE gir som resultat en verdi fra en kolonne eller funksjon som er basert på en betingelse. Syntaksen ser ut som følger: select decode(verdi, if1, then1, [if2, then2, ]else) from ; Verdi er navnet på en kolonne eller en funksjon og for hver IF som inngår i setningen, så gir tilsvarende THEN resultatet hvis betingelsen er sann. Hvis ingen av betingelsene er sanne, så vil ELSE -verdien bli resultatet. La oss se på et eksempel. select delnr, decode(delnr, 1,'Kontorstol', 3, 'Pult', 'Ukjent') navn from delinfo; DELNR NAVN 1 Kontorstol 3 Pult 4 Ukjent 201 Ukjent 202 Ukjent 1909 Ukjent Ukjent Ukjent 8 rows returned

7 Funksjoner side 7 av Funksjonen CASE Funksjonen CASE er svært like funksjonen DECODE. CASE er et nyttig redskap når vi har behov for å gruppere data. Syntaksen ser ut som følger: case when betingelse 1 then uttrykk 1 when betingelse 2 then uttrykk 2 [else] uttrykk 2a end La oss se på et eksempel. Vi ønsker å skrive ut antall leverandører gruppert på status mellom 0 og 30 og mellom 30 og 50. select sum(case when status between 0 and 30 then 1 else 0 end) as "0 til 30", sum(case when status between 31 and 50 then 1 else 0 end) as "31 til 50" from leverandor; Resultattabellen etter spørringen er utført, blir som følger: 0 til til Funksjonen SUM blir brukt for hver gruppering av data. CASE blir deretter plassert på innsiden av summeringsfunksjonen. Hvis en leverandørstatus tilfredsstiller betingelsen i WHEN-setningen, så blir verdien 1 lagt til. Hvis statusen ikke tilfredsstiller betingelsen, så blir verdien 0 lagt til Brukerdefinerte funksjoner Oracle gir også muligheten til å opprette såkalte brukerdefinerte funksjoner. Slike funksjoner er svært lik lagrete prosedyrer i syntaks og struktur, bortsett fra at en funksjon må returnere en verdi. En funksjon kan ha ingen eller flere parametere og en setning som returnerer en verdi. Datatypen til returverdien må deklareres i funksjonens hode. En funksjon brukes ikke alene, men i sammenheng med en SELECT-setning, blokk, prosedyre eller trigger. Syntaksen til en brukerdefinert funksjon ser slik ut: create or replace function <funksjonsnavn> [parameterliste] return datatype is hovedprogram return (returverdi);

8 Funksjoner side 8 av 11 La oss lage en funksjon som finner hvor mange deler som er lagt inn i tabellen Delinfo: create or replace function hvor_mange_deler return number is antall number; select count(*) into antall from delinfo; return(antall); end hvor_mange_deler; Function created. Funksjonens navn ble lagret lokalt. For å teste om funksjonen fungerer, skriver vi spørringen: select hvor_mange_deler from dual; HVOR_MANGE_DELER 8 Men dette er ikke den vanlige måten å bruke en brukerdefinert funksjon på. Vanligvis vil de bli brukt i en lagret prosedyre. I prosedyren som følger tar vi i bruk den brukerdefinerte funksjonen. create or replace procedure utskrift is ant number; ant := hvor_mange_deler(); dbms_output.put_line(ant); end utskrift; Nå kjører vi prosedyren: utskrift; Resultatet blir: 8 Statement processed.

9 Funksjoner side 9 av 11 Under har vi laget en funksjon som finner antallet produkt en bestemt leverandør har levert. Denne funksjonen benytter en parameter. create or replace function ant_produkt(lev_nr leveranse.lno%type) return number is totalt number; select count(*) into totalt from leveranse where lno = lev_nr; return totalt; Function created. Vi tar funksjonen i bruk i følgende prosedyre: create or replace procedure finn_ant_produkt(lev_nr in leveranse.lno%type) is antall number; antall := ant_produkt(lev_nr); dbms_output.put('antall produkt er: '); dbms_output.put_line(antall); Nå kjører vi prosedyren: finn_ant_produkt('l1'); Vi får følgende resultat: Antall produkt er: 5 Statement processed To-do-liste Følgende liste representerer anbefalinger med hensyn til funksjonsstrukturen: Bruk helst ikke OUT eller IN OUT i funksjonens parameterliste. Alle data som skal returneres må deklareres i funksjonens RETURN-setning. Lag bare én RETURN-setning i den delen av funksjonen som skal kjøres, og den skal komme helt til slutt. Hvis funksjonen skal returnere flere verdier, så bruk en sammensatt datatype (eng. record, object, collection) eller bruk OUT eller IN OUT i argumentet. Det er mange fordeler ved bruk av brukerdefinerte funksjoner. Resultatet av en funksjon kan for eksempel legges direkte inn som parameter i utskriftskommandoen til DBMS_OUTPUT. PUT LINE. Til slutt kan det nevnes at den også kan legges direkte inn i en algoritme som for eksempel i en iterasjon.

10 Funksjoner side 10 av Kontroll av datatyper med brukerdefinerte funksjoner. Når vi oppretter tabeller hender det ofte at både numeriske verdier og datoer blir lagret som tekststrenger (VARCHAR). Hvis vi senere skal bruke disse verdiene og er usikre på i hvilket dataformat de er lagret, kan vi lett opprette en brukerdefinert funksjon til å finne det ut for oss. La oss se på et eksempel: create or replace function er_numerisk(streng in varchar2) return boolean as tall number; tall := streng; return true; exception when others then return false; Denne funksjonen returnerer TRUE (sann) hvis inndatastrengen kan konverteres til et tall med bruk av NLS-instillingen til kjørende sesjon (eng. session). Vi kan også lage noe tilsvarende for hvis ønsket er en datoverdi: create or replace function er_dato(streng in varchar2, inn_format in varchar2 := null) return boolean as dato date; dato := to_date(streng, inn_format); return true; exception when others then return false; Deterministisk funksjon En deterministisk funksjon er en funksjon som alltid returnerer samme svar forutsatt samme innverdier. La oss se på et kjørbart eksempel hvor vi bruker en deterministisk funksjon. Vi har opprettet en tabell Tbl_t som har to kolonner (navn, id) som begge har datatypen VARCHAR2. Vi ønsker å lage en spørring som skriver ut innholdet fra tabellen bare for id-verdier som er gyldige heltall. Tabellen Tbl_t har følgende data: NAVN ID ab 10 cd 1- ef 1a gh 12 ij 1.0

11 Funksjoner side 11 av 11 Vi ønsker at spørringen skal gi følgende resultattabell: NAVN ID ab 10 gh 12 Alle verdier som ikke har heltallsformat skal avvises. For å få dette til lager vi en brukerdefinert deterministisk funksjon som returnerer kun to verdier: enten 1 (som betyr ja fordi innverdi er et heltall) eller NULL (som betyr nei fordi innverdi ikke er et heltall). Funksjonen vil se slik ut: create or replace function finn_tall(p_streng in varchar2) return number deterministic as l_num number; l_num := p_streng; return 1; exception when others then return null; Så må vi opprette en indeks på kolonnen som vi leter etter heltall i: create index tbl_t_ind on tbl_t(finn_tall(id)); Indeksen vil bli meget kompakt fordi Oracle sine b-tre indekser ikke oppretter rader som inneholder NULL verdier. Detter fører til at de radene i tabellen som ikke inneholder et heltall ikke vil bli representert i indeksen. Deretter lager vi en spørring som finner de aktuelle radene via indeksen: select * from tbl_t where finn_tall(id) = 1; Vi får følgende resultattabell fra spørringen: NAVN ID ab 10 gh Litteratur som er brukt Gennick, J., Luers, T. (2000): Sams Teach Yourself PLSQL TM in 21 Days, Second Edition, Sams. Palinski, J. A. (2002): Oracle SQL and PLSQL Handbook, A Guide for Data Administrators, Developers, and Business Analysts, Addison Wesley. Rosenzweig, B., Silvestrova, E. (2003): Oracle PLSQL, Interactive Workbook, Second Edition, Prentice Hall.