Oracle PL/SQL-paket: Typ, Specifikation, Kropp [Exempel]

Vad är paketet i Oracle?

Oracle PL / SQL paketet är en logisk gruppping av relaterade underprogram (procedur/funktion) till ett enda element. Ett paket kompileras och lagras som ett databasobjekt som kan återanvändas senare.

Komponenter i paket

Ett PL/SQL-paket har två komponenter.

• Paketspecifikation
• Paketkropp

Paketspecifikation

Paketspecifikationen består av en deklaration från alla offentliga variabler, markörer, objekt, procedurer, funktioner och undantag.

Nedan följer några egenskaper hos paketspecifikationen.

• Elementen som deklareras i specifikationen kan nås utanför paketet. Sådana element kallas publika element.
• Paketspecifikationen är ett fristående element, vilket innebär att den kan existera ensam utan en paketkropp.
• Närhelst ett paket hänvisas till skapas en instans av paketet för den specifika sessionen.
• Efter att instansen har skapats för en session är alla paketelement som initieras i den instansen giltiga till slutet av sessionen.

syntax

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

Ovanstående syntax visar skapandet av paketspecifikationen.

Paketkropp

Paketets innehåll består av definitionen av alla element som finns i paketspecifikationen. Det kan också innehålla definitioner av element som inte deklareras i specifikationen; dessa element kallas privata element och kan endast anropas inifrån paketet.

Nedan följer egenskaperna hos en paketkropp.

• Den bör innehålla definitioner för alla underprogram/markörer som har deklarerats i specifikationen.
• Den kan också ha fler underprogram eller andra element som inte deklareras i specifikationen. Dessa kallas privata element.
• Det är ett beroende objekt, och det beror på paketspecifikationen.
• Paketets innehållsdel får statusen "Ogiltig" varje gång specifikationen kompileras. Därför måste den kompileras om varje gång efter att specifikationen har kompilerats.
• De privata elementen bör definieras först innan de används i paketets kropp.
• Den första delen av paketets innehåll är den globala deklarationsdelen. Denna inkluderar variabler, markörer och privata element (framåtdeklaration) som är synliga för hela paketet.
• Den sista delen av paketet är paketinitieringsdelen som körs en gång varje gång ett paket refereras till för första gången i sessionen.

Syntax:

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>

Ovanstående syntax visar skapandet av paketets brödtext.

Nu ska vi se hur man refererar till paketelement i programmet.

Refererande paketelement

När elementen har deklarerats och definierats i paketet måste vi referera till elementen för att använda dem.

Alla publika element i paketet kan anropas genom att anropa paketnamnet följt av elementnamnet separerat med en punkt, t.ex. . '.

Paketets publika variabler kan också användas på samma sätt för att tilldela och hämta värden från dem, dvs. . '.

Skapa paket i PL/SQL

I PL/SQL, varje gång ett paket hänvisas till eller anropas i en session, skapas en ny instans för det paketet.

Oracle tillhandahåller en möjlighet att initiera paketelement eller att utföra någon aktivitet vid tidpunkten för den här instansen skapas genom "Paketinitiering".

Detta är inget annat än ett exekveringsblock som skrivs i paketets innehåll efter att alla paketelement har definierats. Detta block kommer att exekveras varje gång ett paket refereras till för första gången i sessionen.

Skärmdumpen nedan visar hur paketinitieringsblocket placeras inuti paketets brödtext när ett paket skapas.

syntax

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

Ovanstående syntax visar definitionen av paketinitiering i paketets kropp.

Vidarebefordra deklarationer

En framåtdeklaration eller referens i paketet är inget annat än att deklarera de privata elementen separat och definiera dem i den senare delen av paketets brödtext.

Privata element kan endast refereras till om de redan är deklarerade i paketets innehåll. Av denna anledning används framåtdeklaration. Men det är ganska ovanligt att använda det, eftersom privata element oftast deklareras och definieras i den första delen av paketets innehåll.

Forward deklaration är ett alternativ som tillhandahålls av OracleDet är inte obligatoriskt, och att använda det eller inte är upp till programmerarens krav.

Skärmdumpen nedan visar hur ett privat element framåtdeklareras och senare definieras i paketets brödtext.

Syntax:

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>

Ovanstående syntax visar framåtriktad deklaration. De privata elementen deklareras separat i den främre delen av paketet, och de har definierats i den senare delen.

Användning av markörer i paketet

Till skillnad från andra element måste man vara försiktig när man använder markörer inuti paketet.

Om markören är definierad i paketspecifikationen eller i den globala delen av paketets innehåll, kommer markören, när den öppnats, att finnas kvar till slutet av sessionen.

Så man bör alltid använda markörattributet '%ISOPEN' för att verifiera markörens tillstånd innan man refererar till den.

Överbelastning

Överbelastning är konceptet att ha många delprogram med samma namn. Dessa delprogram skiljer sig från varandra genom antalet parametrar, typerna av parametrar eller returtypen. Med andra ord betraktas delprogram med samma namn men med ett annat antal parametrar, olika typer av parametrar eller en annan returtyp som överbelastning.

Detta är användbart när många delprogram behöver utföra samma uppgift, men sättet att anropa vart och ett av dem bör vara olika. I det här fallet hålls delprogramnamnet detsamma för alla, och parametrarna ändras enligt anropskommandot.

Exempel 1: I det här exemplet ska vi skapa ett paket för att hämta och ställa in värdena för en anställds information i tabellen 'emp'. Funktionen get_record returnerar posttypen för det givna anställningsnumret, och proceduren set_record infogar posttypen i tabellen 'emp'.

Steg 1) Skapande av paketspecifikation

Skärmdumpen nedan visar att paketspecifikationen för guru99_get_set skapas 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;
/

Produktion:

Package created

Code Förklaring

• Code rad 1-5: Skapar paketspecifikationen för guru99_get_set med en procedur och en funktion. Dessa två är nu publika element i detta paket.

Steg 2) Paketet innehåller en paketkropp, där själva definitionerna av alla procedurer och funktioner definieras. I detta steg skapas paketkroppen.

Skärmdumpen nedan visar definitionen av paketets guru99_get_set-kropp 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;
/

Produktion:

Package body created

Code Förklaring

• Code rad 7: Skapar paketets brödtext.
• Code rad 9-16: Definiera elementet 'set_record' som deklareras i specifikationen. Detta är samma sak som att definiera en fristående procedur i PL/SQL.
• Code rad 17-24: Definiera elementet 'get_record'. Det är samma sak som att definiera en fristående funktion.
• Code rad 25-26: Definiera paketinitieringsdelen.

Steg 3) Skapar ett anonymt block för att infoga och visa posterna genom att referera till det ovan skapade paketet.

Skärmdumpen nedan visar det anonyma blocket som anropar paketet, tillsammans med dess utdata 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;
/

Produktion:

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 Förklaring:

• Code rad 34-37: Fyller i data för variabeln posttyp i ett anonymt block för att anropa elementet 'set_record' i paketet.
• Code rad 38: Ett anrop har gjorts till 'set_record' för paketet guru99_get_set. Nu är paketet instansierat och det kommer att finnas kvar till slutet av sessionen. Paketinitialiseringsdelen körs eftersom detta är det första anropet till paketet, och posten infogas av elementet 'set_record' i tabellen.
• Code rad 41: Anropar elementet 'get_record' för att visa information om den infogade medarbetaren. Paketet refereras till för andra gången under detta anrop, men initialiseringsdelen körs inte igen, eftersom paketet redan har initialiserats i denna session.
• Code rad 42-45: Skriver ut personaluppgifter.

Beroende i paket

Eftersom paketet är en logisk gruppping av relaterade saker har den vissa beroenden. Följande är de beroenden som ska tas om hand.

• En specifikation är ett fristående objekt.
• En paketkropp är beroende av specifikationen.
• Paketets innehåll kan kompileras separat. Närhelst specifikationen kompileras måste innehållet kompileras om, eftersom det blir ogiltigt.
• Delprogrammet i paketets brödtext som är beroende av ett privat element bör definieras först efter deklarationen av det privata elementet.
• De databasobjekt som det hänvisas till i specifikationen och brödtexten måste ha giltig status vid tidpunkten för paketkompileringen.

Paketinformation

När paketet har skapats finns paketinformationen, såsom paketkälla, underprogramsinformation och överbelastningsinformation, tillgänglig i Oracle dataordbokstabeller.

Tabellen nedan visar dataordlistan och den paketinformation som finns tillgänglig i varje tabell.

UTL_FILE – En översikt

UTL_FILE är ett separat verktygspaket som tillhandahålls av Oracle för att utföra speciella uppgifter. Den används huvudsakligen för att läsa och skriva operativsystemfiler från PL/SQL-paket eller underprogram. Den har separata funktioner för att lägga in information i och hämta information från filer. Den tillåter också läsning och skrivning i den ursprungliga teckenuppsättningen.

Programmeraren kan använda detta för att skriva operativsystemfiler av alla typer, och filen kommer att skrivas direkt till databasservern. Namn och katalogsökväg nämns i skrivande stund.

Vanliga frågor