Oracle PL/SQL-pakke: Type, Spesifikasjon, Body [Eksempel]

Hva er pakken i Oracle?

Oracle PL / SQL pakken er en logisk gruppeping av relaterte underprogrammer (prosedyre/funksjon) til et enkelt element. En pakke kompileres og lagres som et databaseobjekt som kan brukes på nytt senere.

Komponenter av pakker

En PL/SQL-pakke har to komponenter.

• Pakkespesifikasjon
• Pakkekropp

Pakkespesifikasjon

Pakkespesifikasjonen består av en erklæring fra alle offentlige variabler, pekere, objekter, prosedyrer, funksjoner og unntak.

Nedenfor er noen kjennetegn ved pakkespesifikasjonen.

• Elementene som er deklarert i spesifikasjonen kan nås utenfra pakken. Slike elementer er kjent som offentlige elementer.
• Pakkespesifikasjonen er et frittstående element, som betyr at den kan eksistere alene uten en pakkeinnhold.
• Hver gang det refereres til en pakke, opprettes en instans av pakken for den bestemte økten.
• Etter at forekomsten er opprettet for en økt, er alle pakkeelementene som er initiert i den forekomsten gyldige til slutten av økten.

syntax

CREATE [OR REPLACE] PACKAGE <package_name> 
IS
<sub_program and public element declaration>
.
.
END <package name>

Syntaksen ovenfor viser opprettelsen av pakkespesifikasjonen.

Pakkekropp

Pakketeksten består av definisjonen av alle elementene som finnes i pakkespesifikasjonen. Den kan også ha definisjoner av elementer som ikke er deklarert i spesifikasjonen; disse elementene kalles private elementer og kan bare kalles fra innsiden av pakken.

Nedenfor er egenskapene til en pakkekropp.

• Den bør inneholde definisjoner for alle underprogrammene/markørene som er deklarert i spesifikasjonen.
• Den kan også ha flere underprogrammer eller andre elementer som ikke er deklarert i spesifikasjonen. Disse kalles private elementer.
• Det er et avhengig objekt, og det avhenger av pakkespesifikasjonen.
• Pakkeinnholdet får statusen «Ugyldig» hver gang spesifikasjonen kompileres. Derfor må den kompileres på nytt hver gang etter at spesifikasjonen er kompilert.
• De private elementene bør defineres først før de brukes i pakketeksten.
• Den første delen av pakkeinnholdet er den globale deklarasjonsdelen. Denne inkluderer variabler, markører og private elementer (fremoverdeklarasjon) som er synlige for hele pakken.
• Den siste delen av pakken er pakkeinitialiseringsdelen som kjøres én gang hver gang en pakke refereres til for første gang i økten.

Syntaks:

CREATE [OR REPLACE] PACKAGE BODY <package_name>
IS
<global_declaration part>
<Private element definition>
<sub_program and public element definition>
.
<Package Initialization> 
END <package_name>

Syntaksen ovenfor viser opprettelsen av pakkeinnholdet.

Nå skal vi se hvordan vi refererer til pakkeelementer i programmet.

Refererende pakkeelementer

Når elementene er deklarert og definert i pakken, må vi referere til elementene for å bruke dem.

Alle de offentlige elementene i pakken kan refereres til ved å kalle pakkenavnet etterfulgt av elementnavnet atskilt med et punktum, f.eks. . '.

De offentlige variablene i pakken kan også brukes på samme måte til å tilordne og hente verdier fra dem, f.eks. . '.

Opprett pakke i PL/SQL

I PL/SQL, hver gang en pakke refereres til eller kalles i en sesjon, opprettes en ny instans for den pakken.

Oracle gir en mulighet for å initialisere pakkeelementer eller å utføre en hvilken som helst aktivitet på tidspunktet for opprettelse av denne forekomsten gjennom "Pakkeinitialisering".

Dette er ikke annet enn en utførelsesblokk som skrives i pakketeksten etter at alle pakkeelementene er definert. Denne blokken vil bli utført hver gang en pakke refereres til for første gang i økten.

Skjermbildet nedenfor viser hvordan pakkeinitialiseringsblokken plasseres inne i pakkekroppen når en pakke opprettes.

syntax

CREATE [OR REPLACE] PACKAGE BODY <package_name>
IS
<Private element definition>
<sub_program and public element definition>
.
BEGIN
<Package Initialization> 
END <package_name>

Syntaksen ovenfor viser definisjonen av pakkeinitialisering i pakketeksten.

Videresend erklæringer

Fremoverdeklarasjon eller referanse i pakken er ikke annet enn å deklarere de private elementene separat og definere dem i den senere delen av pakkeinnholdet.

Private elementer kan bare refereres til hvis de allerede er deklarert i pakkeinnholdet. Av denne grunn brukes fremoverdeklarasjon. Men det er ganske uvanlig å bruke det, fordi private elementer som oftest deklareres og defineres i den første delen av pakkeinnholdet.

Forward erklæring er et alternativ gitt av OracleDet er ikke obligatorisk, og bruk av det eller ikke er opp til programmererens behov.

Skjermbildet nedenfor viser hvordan et privat element deklareres videre og senere defineres i pakkeinnholdet.

Syntaks:

CREATE [OR REPLACE] PACKAGE BODY <package_name>
IS
<Private element declaration>
.
.
.
<Public element definition that refer the above private element>
.
.
<Private element definition> 
.
BEGIN
<package_initialization code>; 
END <package_name>

Ovennevnte syntaks viser fremad deklarasjon. De private elementene er deklarert separat i den fremre delen av pakken, og de er definert i den senere delen.

Markørbruk i pakken

I motsetning til andre elementer, må man være forsiktig når man bruker markører inne i pakken.

Hvis markøren er definert i pakkespesifikasjonen eller i den globale delen av pakkeinnholdet, vil markøren, når den er åpnet, forbli der til slutten av økten.

Så man bør alltid bruke markørattributtet '%ISOPEN' for å bekrefte markørens tilstand før man refererer til den.

Overbelastning

Overbelastning er konseptet med å ha mange underprogrammer med samme navn. Disse underprogrammene skiller seg fra hverandre ved antall parametere, parametertyper eller returtype. Med andre ord, underprogrammer med samme navn, men med et annet antall parametere, forskjellige typer parametere eller en annen returtype, regnes som overbelastning.

Dette er nyttig når mange underprogrammer må utføre den samme oppgaven, men måten de kaller hvert av dem på bør være forskjellig. I dette tilfellet holdes underprogramnavnet det samme for alle, og parameterne endres i henhold til kallingssetningen.

Eksempel 1: I dette eksemplet skal vi opprette en pakke for å hente og angi verdiene for en ansatts informasjon i «emp»-tabellen. Funksjonen get_record returnerer posttypeutdataene for det gitte ansattnummeret, og prosedyren set_record setter inn posttypeposten i emp-tabellen.

Trinn 1) Oppretting av pakkespesifikasjon

Skjermbildet nedenfor viser pakkespesifikasjonen guru99_get_set som opprettes i Oracle.

CREATE OR REPLACE PACKAGE guru99_get_set
IS
PROCEDURE set_record (p_emp_rec IN emp%ROWTYPE);
FUNCTION get_record (p_emp_no IN NUMBER) RETURN emp%ROWTYPE;
END guru99_get_set;
/

Utgang:

Package created

Code Forklaring

• Code linje 1–5: Oppretter pakkespesifikasjonen for guru99_get_set med én prosedyre og én funksjon. Disse to er nå offentlige elementer i denne pakken.

Trinn 2) Pakken inneholder en pakketekst, hvor de faktiske definisjonene av alle prosedyrer og funksjoner er definert. I dette trinnet opprettes pakketeksten.

Skjermbildet nedenfor viser definisjonen av guru99_get_set-pakkens innhold i Oracle.

CREATE OR REPLACE PACKAGE BODY guru99_get_set
IS
PROCEDURE set_record(p_emp_rec IN emp%ROWTYPE)
IS
PRAGMA AUTONOMOUS_TRANSACTION;
BEGIN
INSERT INTO emp
VALUES(p_emp_rec.emp_name,p_emp_rec.emp_no, p_emp_rec.salary,p_emp_rec.manager);
COMMIT;
END set_record;
FUNCTION get_record(p_emp_no IN NUMBER)
RETURN emp%ROWTYPE
IS
l_emp_rec emp%ROWTYPE;
BEGIN
SELECT * INTO l_emp_rec FROM emp where emp_no=p_emp_no;
RETURN l_emp_rec;
END get_record;
BEGIN
dbms_output.put_line('Control is now executing the package initialization part');
END guru99_get_set;
/

Utgang:

Package body created

Code Forklaring

• Code linje 7: Oppretter pakkekroppen.
• Code linje 9–16: Definere elementet 'set_record' som er deklarert i spesifikasjonen. Dette er det samme som å definere en frittstående prosedyre i PL/SQL.
• Code linje 17–24: Definere elementet 'get_record'. Det er det samme som å definere en frittstående funksjon.
• Code linje 25–26: Definere pakkens initialiseringsdel.

Trinn 3) Oppretter en anonym blokk for å sette inn og vise postene ved å referere til pakken som er opprettet ovenfor.

Skjermbildet nedenfor viser den anonyme blokken som kaller pakken, sammen med utdataene i Oracle.

DECLARE
l_emp_rec emp%ROWTYPE;
l_get_rec emp%ROWTYPE;
BEGIN
dbms_output.put_line('Insert new record for employee 1004');
l_emp_rec.emp_no:=1004;
l_emp_rec.emp_name:='CCC';
l_emp_rec.salary:=20000;
l_emp_rec.manager:='BBB';
guru99_get_set.set_record(l_emp_rec);
dbms_output.put_line('Record inserted');
dbms_output.put_line('Calling get function to display the inserted record');
l_get_rec:=guru99_get_set.get_record(1004);
dbms_output.put_line('Employee name: '||l_get_rec.emp_name);
dbms_output.put_line('Employee number:'||l_get_rec.emp_no);
dbms_output.put_line('Employee salary:'||l_get_rec.salary);
dbms_output.put_line('Employee manager:'||l_get_rec.manager);
END;
/

Utgang:

Insert new record for employee 1004
Control is now executing the package initialization part
Record inserted
Calling get function to display the inserted record
Employee name: CCC
Employee number: 1004
Employee salary: 20000
Employee manager: BBB

Code Forklaring:

• Code linje 34–37: Fyller ut dataene for posttypevariabelen i en anonym blokk for å kalle 'set_record'-elementet i pakken.
• Code linje 38: Et kall har blitt gjort til 'set_record' for guru99_get_set-pakken. Nå er pakken instansiert, og den vil vare til slutten av økten. Pakkens initialiseringsdel utføres siden dette er det første kallet til pakken, og posten settes inn i tabellen av 'set_record'-elementet.
• Code linje 41: Kaller elementet 'get_record' for å vise detaljene til den innsatte ansatte. Pakken refereres til for andre gang i løpet av dette kallet, men initialiseringsdelen utføres ikke på nytt, ettersom pakken allerede er initialisert i denne økten.
• Code linje 42–45: Skriver ut de ansattes detaljer.

Avhengighet i pakker

Siden pakken er en logisk gruppeping av relaterte ting, har den noen avhengigheter. Følgende er avhengighetene som skal tas hånd om.

• En spesifikasjon er et frittstående objekt.
• En pakkes innhold er avhengig av spesifikasjonen.
• Pakketeksten kan kompileres separat. Når spesifikasjonen kompileres, må teksten kompileres på nytt, da den vil bli ugyldig.
• Delprogrammet i pakkeinnholdet som er avhengig av et privat element, bør bare defineres etter deklarasjonen av det private elementet.
• Databaseobjektene som det refereres til i spesifikasjonen og brødteksten, må ha gyldig status på tidspunktet for pakkekompileringen.

Pakkeinformasjon

Når pakken er opprettet, er pakkeinformasjonen, som pakkekilden, detaljer om underprogrammet og overbelastningsdetaljer, tilgjengelig i Oracle dataordboktabeller.

Tabellen nedenfor viser dataordlistetabellen og pakkeinformasjonen som er tilgjengelig i hver tabell.

UTL_FILE – En oversikt

UTL_FILE er en separat verktøypakke levert av Oracle å utføre spesielle oppgaver. Den brukes hovedsakelig til å lese og skrive operativsystemfiler fra PL/SQL-pakker eller underprogrammer. Den har separate funksjoner for å legge inn informasjon i og hente informasjon fra filer. Den tillater også lesing og skriving i det opprinnelige tegnsettet.

Programmereren kan bruke dette til å skrive operativsystemfiler av alle typer, og filen vil bli skrevet direkte til databaseserveren. Navnet og katalogstien er nevnt i skrivende stund.

Spørsmål og svar