Oracle functionality
Tento český překlad již není aktuální - aktuální dokumentace je k dispozici v repozitáři projektu (v anglickém jazyce).
V jednu chvíli to vypadalo, že se vývojáři snaží z PostgreSQL udělat kopii Oracle. Do PostgreSQL naimplementovali řadu NON ANSI funkcí, které nabízí Oracle. Tato doba je ale již minulostí. Do distribuce se funkce, která není definovaná ANSI SQL, prakticky nemá šanci dostat. Řešením je použití EnterpriseDB, která má za cíl kompatibilitu s Oraclem, nebo použití doplňujícího balíku funkcí Orafce. Kromě řady základních uživateli PostgreSQL požadovaných funkcí obsahuje také část frameworku PLVision, a balíčky dbms_alert, dbms_output a dbms_pipe. Cílem není plná kompatibilita s Oraclem, to ani není technicky možné, ale rozšíření PostgreSQL o pokročilé funkce, které nabízí RDBMS Oracle. Řadu příkladů můžete nalézt v dokumentu Napište si debugger PL/pgSQL aneb pokročilé techniky programování v PostgreSQL.
Základní funkce
Funkce pro práci s typem date
Většina těchto funkcí má jako jeden z parametrů období, které je určené znakovým kódem z následující tabulky:
SELECT add_months(date '2005-05-31',1); -- > 2005-06-30 SELECT last_day(date '2005-05-24'); -- > 2005-05-31 SELECT next_day(date '2005-05-24', 'monday'); -- > 2005-05-30 SELECT months_between(date '1995-02-02', date '1995-01-01'); -- > 1.0322580645161 SELECT trunc(date '2005-07-12', 'iw'); -- > 2005-07-11 SELECT round(date '2005-07-12', 'yyyy'); -- > 2006-01-01
| Y,YY,YYY,YYYY,SYYY,SYEAR | rok |
| I,IY,IYY,IYYY | iso rok |
| Q, | kvartál |
| WW | týden, první den v týdnu odpovídá prvnímu dnu v roce |
| IW | týden, prvním dnem je pondělí |
| W | týden, prvním dnem je první den v měsíci |
| DAY,DY,D | týden, první dnem v týdnu je neděle |
| MONTH,MON,MM,RM | měsíc |
| CC,SCC | století |
| DDD,DD,J | den |
| HH,HH12,HH24 | hodina |
| MI | minuta |
Funkce round zaokrouhluje na 1. července pro roční období, 16-tý den pro měsíc a čtvrtek pro týden.
| add_months(date, integer) date | Přičte n měsíců |
| last_date(date) date | Vrací poslední den v měsíci |
| next_day(date, text) date | Vrací první následující den v týdnu po určeném dnu, např. první následující čtvrtek |
| months_between(date, date) float8 | Vrací počet měsíců mezi dvěma dny. Výpočet je založen na měsíci s 31 dny. |
| trunc(date, text) date | Ořízne datum podle zadaného formátu |
| round(date, text) date | Zaokrouhlí datum podle zadaného formátu |
Byla provedena verifikace těchto funkcí s Oraclem 10i.
Funkce nlssort
PostgreSQL nyní umožňuje třídit pouze podle jednoho, předem vybraného, pravidla. Toto omezení by mělo být odstraněno ve verzi 8.2 se zavedením tzv. COLLATE. Do té doby můžete použít funkci nlssort, která umožňuje použít další pravidla (předpokladem je nainstalování požadované národní podpory (locales)). Funkci můžeme volat buďto s parametrem určujícím pravidlo pro třídění, nebo tento parametr nastavit předem voláním funkce set_nls_sort. Funkci nlssort pracuje korektně, pouze když používáte locales s relevantním kódováním. Je chybou mít data v kódování latin2 a třídit podle německého locales s kódováním latin1. Naopak je korektní používat české i německé řazení s kódováním UTF8. Pro tuto funkci se použil kód Jana Pazdziory z balíčku nls_string.
SELECT * FROM peoples ORDER BY nlssort(surname, 'de_DE.UTF-8');
SELECT set_nls_sort('cs_CZ.UTF-8');
SELECT * FROM peoples ORDER BY nlssort(surname);
Funkce pro práce s řetězci
Tyto funkce byly do balíku zahrnuty jen s účelem zjednodušit portování aplikací z Oracle. K těmto funkcím zpravidla existují ANSI SQL ekvivalenty.
| instr (text, text, [int[, int]]) | Hledá n-tý výskyt vzoru v řetězci |
| reverse (text) | Zrcadlově převrátí řetězec |
| oracle.substr (text, [int [,int]]) | Vrací část řetězce (PostgreSQL popdporuje funkci substr nekompatibilní s Oraclem |
Ostatní funkce
Tyto funkce byly do balíku zahrnuty jen s účelem zjednodušit portování aplikací z Oracle. Místo nich používejte univerzálnější a ANSI standardní funkci COALESCE.
| nvl (anyelement, anyalement) | Vrací první neprázdný parametr |
| nvl2 (anyelement, anyememet, anyelement) | Vrací první neprázdný parametr |
| concat (text, text) | Slučuje řetězce. Oproti operátoru || ignoruje NULL |
DBMS_ALERT
Tento balík podporuje asynchronní vyžádanou notifikaci. Funkcionalita je velice podobná PostgreSQL SQL notifikaci realizovanou prostřednictvím příkazů LISTEN/NOTIFY. dbms_alert představuje řešení, které je 100% realizováno na straně serveru, LISTEN/NOTIFY je vyžaduje podporu klientské aplikace (a tudíž jej nemůže použít např. v PL uložených procedurách). Notifikaci si uživatelská session musí vyžádat registrací zpráv, o které má zájem. To je hlavní rozdíl vůči dbms_pipe, což je také řešení intersession komunikace, které je ale broadcast a kde zprávu převezme pouze první session, která se k ní dostane. dbms_alert doručí zprávu všem zaregistrovaným příjemcům. Jinak, dbms_pipe se používá hlavně pro obousměrnou komunikaci mezi dvěma uživatelskými sessions, a dbms_alert pro jednosměrnou komunikaci jedné session s dalšími.
-- session pavel
pavel# SELECT dbms_alert.register('ahoj');
pavel# SELECT * FROM dbms_alert.waitany(NULL);
-- session root
root# SELECT dbms_alert.signal('ahoj','Gertrudo');
Funkce
| dbms_alert.register(name text) | Zaregistruje si posílání oznámení o výskytu události name |
| dbms_alert.remove(name text) | Odtraní registraci příjmu oznámení události name |
| dbms_alert.removeall() | Odstraní všechny registrace |
| dbms_alert.signal(name text, message text) | Signalizuje událost |
| dbms_alert.waitany(OUT name text, OUT message text, OUT status integer, n float8) | Čeká max. n sekund na libovolnou signalizovanou událost |
| dbms_alert.waitone(name text, OUT message text, OUT status integer, n float8) | Čeká max. n sekund na signalizovanou událost name |
| dbms_alert.set_defaults | Není implementováno |
Událost se signalizuje v okamžiku ukončení transakce, bohužel nikoliv po dokončení transakce, tak jak je to v případě LISTEN/NOTIFY nebo originálního Oracle. V čem může být problém: a) falešná signalizace - je signalizována událost ale není zajištěno dokončení transakce (při výjimce v AFTER TRIGGERu), b) pokud je signalizována změna v datech, tak tato změna ještě nemusí být pro příjemce viditelná (pro tento účel je doporučeno zavolat po funkcích waitany nebo waitone funkci pg_sleep(n) - počkat 0.1 až 1 sec dle zatížení systému). Odložená transakce může mít ještě jeden negativní dopad. Transakce, které opakovaně signalizují libovolnou událost během jedné transakce, mohou pak v okamžiku commitu, zahltit sdílenou pamět. Pokud by docházelo k této situaci, pak zvedněte limity v pipe.h a přeložte znovu knihovnu.
DBMS_OUTPUT
Tento balík zajišťuje v Oraclu notifikaci z PL/SQL. V PostgreSQL můžeme nalézt analogii v příkazu RAISE NOTICE. Na rozdíl od PostgreSQL se jedná o server side řešení, kdy skripty běžící na serveru plní session proměnné. Po dokončení běhu skriptu si klient vyzvedne obsah proměnných a zobrazí je obsluze. PostgreSQL má notifikaci řešenou na úrovni protokolu, kde server posílá na klienta asynchronní zprávu, a je jen na klientu, jestli tuto zprávu zobrazí nebo nikoliv. Pokud by se tento balíček používal pouze pro notifikace, tak pak by pravděpodobně nebyl důvod pro to, ho zahrnout do tohoto frameworku. Kromě notifikace se ale může použít i jako implementace fronty (FIFO) v PL/pgSQL, a to díky tomu, že PL procedury mohou nejen do této fronty zpráv zapisovat, ale mohou z ní i číst (fronta zpráv může docela dobře zastoupit dočasnou tabulku).
-- new session
select dbms_output.enable();
select dbms_output.put_line('first_line');
select dbms_output.put_line('next_line');
select * from dbms_output.get_lines(0);
-- new sesion
select dbms_output.serveroutput('on');
select dbms_output.put_line('first_line');
Stejně jako u Oracle je implementována redukce signálů událostí, tj. pokud v rámci jedné transakce signalizujete opakovaně stejnou událost se stejným parametrem (stejný signál), tak se tyto opakující se signály zruší a příjemce získá pouze unikátní signály.
Funkce
| dbms_output.enable([buffer_size int4]) | Zapíná podporu dbms_output, volitelná buffer_size nastavuje maximální velikost vyrovnávací paměti |
| dbms_output.disable() | Vypíná podporu dbms_output, příkazy put, put_line, new_line nebudou mít žádný efekt |
| dbms_output.serveroutput(bool) | Zapíná požadavek na zobrazení výstupu klientovi, zároveň zapíná podporu dbms_output |
| dbms_output.put(text) | Vloží text do výstupního bufferu |
| dbms_output.put_line(text) | Vloží řádek (text včetně symbolu pro konec řádku) |
| dbms_output.new_line() | Vloží symbol konce řádku |
| dbms_output.get_line(OUT line text, OUT status int4) | Přečte jeden řádek z bufferu. Pokud je buffer prázdný, pak status = 0 nebo status = 1 |
| dbms_output.get_lines(OUT lines text[], INOUT numlines int4) | Přečte pole řádku z bufferu. Parametr numlines obsahuje max. počet řádků, pak skutečný počet řádků |
UTL_FILE
Tento balíček obsahuje sadu funkcí podporující operace (čtení a záps) s textovými soubory. Do jisté míry kopíruje styl C knihovny pro práci se streamy (FILE) a víceméně obaluje tuto knihovnu. Adresáře ze kterých lze soubory číst nebo zapisovat jsou omezeny a proto je použití knihovny při rozumné konfiguraci bezpečné. API věrně odpovídá Oracle. Pokud se vyskytují rozdíly, tak důvodem je chybějící podpora předávání parametrů referencí v PostgreSQL. Limity jsou stejné. Max. 10 otevřených souborů v rámci jedné session. Textový řádek může být dlouhý max. 32K. Při odhlášení uživatele dochází k ukončení procesu PostgreSQL a tím i k automatickému zavření všech otevřených souborů. Je třeba dbát na explicitní zavírání souborů. Pokud je ukončena funkce, obsahující proměnnou s deskriptorem souboru ztrácíme možnost explicitního zavření souboru. Jediným řešením je spustit funkci utl_file.fclose_all(), která zajistí uzavření všech otevřených souborů v rámci session,
CREATE OR REPLACE FUNCTION read_file(loc text, filename text)
RETURNS SETOF text AS $$
DECLARE
f utl_file.file_type;
BEGIN
f := utl_file.fopen(loc, filename, 'r');
LOOP
RETURN NEXT utl_file.get_line(f);
END LOOP;
EXCEPTION
WITH NO_DATA_FOUND THEN
f := utl_file.fclose(f);
RETURN;
WITH OTHERS THEN
IF utl_file.is_open(f) THEN
f := utl_file.fclose(f);
END IF;
RAISE EXCEPTION '%', SQLERRM;
END;
$$ LANGUAGE plpgsql VOLATILE;
Funkce
| utl_file.fclose(file utl_file.file_type) file utl_file.file_type | Uzavře soubor přiřazený k deskriptoru file a uvolňuje tento deskriptor. V případě úspěchu vrací NULL, což je ekvivalent volného deskriptoru souboru. Pokud používáte funkci is_open je třeba po zavření souboru nastavit proměnnou nesoucí deskriptor souboru na hodnotu NULL. |
| utl_file.fclose_all() | Zavře všechny otevřené soubory v rámci jedné session. Jelikož nemění obsah proměnných nesoucích deskriptory souborů, stane se jejich obsah po provedení tohoto příkazu nekonzistentní (správně by měli obsahovat hodnotu NULL), a nemá smysl používat funkci is_open. |
| utl_file.fflush(file utl_file.file_type) | Zajistí uložení obsahu vyrovnávací paměti na disk. |
| utl_file.fopen(adresar text, nazev text, rezim text [, max_velradku]) file utl_file.file_type | Vrací deskriptor otevřeného souboru. Soubor lze otevřít v režimech "r" čtení, "w" zápis a "a" append. V případě chyby vyvolá výjimku. Tato funkce umožní přístup pouze k souborům z adreářů vyjmenovaných v tabulce utl_file.utl_file_dir. |
| utl_file.get_line(file utl_file.file_type) text | Přečte jeden řádek z textového souboru. V případě, že je řádek delší než nastavený limit (výchozí nastavení 1KB) vyvolá výjimku. Výjimku NO_DATA_FOUND vyvolá také v případě, že je soubor prázdný nebo se již přečetl celý. Vrácený řetězec neobsahuje znak konce řádku. |
| utl_file.get_nextline(file utl_file.file_type) text | Obdoba předchozí funkce. V případě, že se pokoušíte číst z přečteného souboru, vrací NULL. |
| utl_file.is_open(file utl_file.file_type) boolean | Vrací true pokud je descriptor souboru je platný. Ve skutečnosti se neověřuje, zda-li je skutečně file odkaz na platný descriptor souboru pomocí prostředků operačního systému, ale jednoduše se testuje, zda-li proměnná file obsahuje hodnotu NULL nebo nikoliv. |
| utl_file.new_line(file utl_file.file_type [, radku int]) | Vloží symbol pro nový řádek so souboru. Volitelně lze určit, kolik těchto symbolů se vloží. |
| utl_file.put(file utl_file.file_type, buffer text) | Vloží obsah bufferu do souboru. Kontroluje se maximální délka řádku. |
| utl_file.put_line(file utl_file.file_type, buffer text) | Za vložený text přidá ještě symbol nového řádku. |
| utl_file.putf(file utl_file.file_type, format text, arg1..arg5 text) | Vloží formátovaný text. Formátovací řetězec může obsahovat symbol %s, za který se dosadí obsah n-tého parametru. Jejich počet je omezen na pět. |
Rozdíly vůči Oracle
- utl_file.fclose(file utl_file.file_type) .. výsledek je třeba předat do proměnné obsahující desc. souboru
- utl_file.get_line(file utl_file.file_type) .. vrací text, v Oracle procedura
- utl_file.get_nextline(file utl_file.file_type) .. stejné jako předchozí funkce, jen v případě EOF vrací NULL (get_line je ukončeno výjimkou NO_DATA_FOUND)
DBMS_PIPE
Funkce z balíčku dbms_pipe umožňují asynchronní intersession komunikaci. PostgreSQL nemá žádný analogický mechanismus, kterým by umožnil přenos dat z jedné session do druhé. Zpráva může být prázdná nebo může obsahovat libovolný počet položek (omezeno velikostí dostupné sdílené paměti). Funkce z tohoto balíčku lze použít k testování (přenos ladících hlášení), k synchronizaci aplikací a také k simulaci architektury klient-server pro PL/pgSQL aplikace. Hlavní rozdíly od služeb dbms_alert, které také zajišťují intersession komunikaci jsou:
- nedochází k redukci zpráv,
- nečeká se na dokončení transakce,
- zprávu získá pouze první příjemnce,
- zprávy jsou přenášeny binárně v odpovídajících datových formátech (pokud spolu komunikují dvě sessions s rozdílným kódováním, a přenášíte text, je na Vás, abyste si zajistili odpovídající překódování na kódování příjemce)
Podporováno je dělení rour na privátní a veřejné, na explicitně vytvořené a implicitní. S veřejnými rourami může pracovat kdokoliv, s privátními pouze jejich zřizovatel. Pokud odešleme zprávu do dosud neregistrované roury, automaticky se vytvoří implicitní roura. Ta zaniká okamžitě po jejím vyprázdnění. Explicitní roury existují trvale (do explicitního zrušení, nebo do restartu serveru).
-- Session A
SELECT dbms_pipe.pack_message(CURRENT_DATE);
SELECT dbms_pipe.pack_message('Servus, Rupert');
SELECT dbms_pipe.send_message('boo',4,10);
-- Session B
SELECT dbms_pipe.receive_message('boo',4);
SELECT dbms_pipe.unpack_message_date();
SELECT dbms_pipe.unpack_message_text();
Oracle dokáže pracovat s proměnnými i referenčně a také dokáže přetěžovat OUT parametry funkcí. To v PostgreSQL není možné, přímo z názvu funkce (vyjímkou jsou record funkce) musí být zřejmý výstupní datový typ. Proto v balíčku je originální funkce unpack_message nahrazena sadou funkcí unpack_message_text, unpack_message_date, unpack_message_timestamp, unpack_message_number, unpack_message_bytea a unpack_message_record. Lze přenášet pouze hodnoty typu record s definovaným typem (viz. příklad).
CREATE TYPE info AS (x integer, y integer);
CREATE OR REPLACE FUNCTION send_info(x int, y int)
RETURNS void AS $$
DECLARE i info;
BEGIN i.x := x; i.y := y;
PERFORM dbms_pipe.pack_message(i);
PERFORM dbms_pipe.send_message('info');
END;
$$ LANGUAGE plpgsql;
CREATE OR REPLACE FUNCTION get_info()
RETURNS info AS $$
DECLARE i info;
BEGIN
PERFORM dbms_pipe.receive_message('boo');
SELECT INTO i * FROM dbms_pipe.unpack_message_record() AS (x integer, y integer);
RETURN i;
END;
$$ LANGUAGE plpgsql;
Rozdíly vůči Oracle:
- Omezení kapacity roury není v bytech, ale v počtu zpráv
- Můžete poslat zprávu s nulovým timeoutem
- Můžete poslat prázdnou zprávu
- Funkce next_item_type může vracet dále TIMESTAMP (13) a RECORD(24)
- Formát RAW není podporován, místo toho je podpora BYTEA(23)
Funkce
| dbms_pipe.pack_message(value text|date|timestamp|numeric|record|bytea) | Do lokálního odchozího bufferu přidá obsah. |
| dbms_pipe.unpack_message_text() text | Z lokálního bufferu získá hodnotu typu text. |
| dbms_pipe.unpack_message_date() date | Z lokálního bufferu získá hodnotu typu date. |
| dbms_pipe.unpack_message_timestamp() timestamp | Z lokálního bufferu získá hodnotu typu timestamp. |
| dbms_pipe.unpack_message_number() numeric | Z lokálního bufferu získá hodnotu typu numeric. |
| dbms_pipe.unpack_message_record() record | Z lokálního bufferu získá hodnotu typu record. Pravděpodobně bude nutné provést přiřazení typu (viz ukázka). |
| dbms_pipe.unpack_message_bytea() bytea | Z lokálního bufferu získá hodnotu typu bytea. |
| dbms_pipe.send_message(pipe text [,timeout int] [,limit int]) int | Pokusí se odeslat zprávu (obsah lokálního bufferu) do roury pipe. Pokud roura daného jména dosud neexistuje, bude vytvořena. Pokud se nepovede odeslat zprávu v timeoutu vrací hodnotu 1, jinak hodnotu 0. Timeout je zadán v sec. Limit v maximálním počtu zpráv, které může roura držet. Přípustná je i hodnota 0. Implicitně vytvořená roura je vždy veřejná. |
| dbms_pipe.receive_message(pipe text [,timeout int]) int | Pokusí se získat zprávu z roury pipe. Pokud zprávu nezíská v timeoutu vrací hodnotu 1, jinak 0. Timeout se zadává v sec (def. hodnota odpovídá 1 roku) |
| dbms_pipe.create_pipe(pipe text, limit int [,private bool]) dbms_pipe.create_pipe(pipe text [,limit int]) |
Vytvoří explicitní rouru. Pokud jsou zadány parametry roury, nastaví je (limit v počtu zpráv, a private - omezení přístupu). |
| dbms_pipe.remove_pipe(pipe text) | Odstraní rouru |
| dbms_pipe.reset_buffer() | Reset vyrovnávací paměti (obsahuje neodeslané zabalené nebo přijate nerozbalené hodnoty) |
| dbms_pipe.purge(pipe text) | Vyprázdní rouru |
| dbms_pipe.next_item_type() int | Vrací typ následující hodnoty (0 žádná další, 9 numeric, 11 text, 12 date, 13 timestamp, 23 bytea, 24 record) |
| dbms_pipe.unique_session_name() text | Vrací unikátní identifikátor session ve tvaru PG$PIPE$id$pid (id - identif. proceu používající sdílenou paměť pro implementaci rour, pid - identifikátor procesu) |
Pohled dbms_pipe.db_pipes
Statistika existujících front je k dispozici v pohledu dbms_pipe.db_pipes.
postgres=# select * from dbms_pipe.db_pipes; name | items | size | limit | private | owner ------+-------+------+-------+---------+------- boo | 1 | 32 | | f | (1 row)
PLVdate
Tato sada funkcí je součástí frameworku PLVision (pravděpodobně nejrozšířenější knihovna PL/SQL funkcí, která nepochází z dílen Oracle). Tyto funkce dovolují provádět výpočty nad kalendářem pracovních dnů. Kalendář lze velice snadno modifikovat, např. přizpůsobit pro neevropské prostředí (vypuštění velikonoc, pracovní sobota, atd.). Pro usnadnění práce distribuce obsahuje kalendáře pro Českou republiku, všechny sousední země a některé dálší. Do kalendáře můžeme vložit vlastní svátky (každoroční) nebo vlastní mimopracovní dny.
SELECT plvdate.plvdate.default_holydays('czech');
SELECT plvdate.add_bizdays(CURRENT_DATE, 10);
SELECT plvdate.isbizday('2006-12-25');
SELECT plvdate.set_nonbizday('Friday');
Funkce
| add_bizdays(day date, days int) date | Přičte n pracovních dnů |
| plvdate.nearest_bizday(day date) date | Vrací nejbližší pracovní den |
| plvdate.next_bizday(day date) date | Vrací další pracovní den |
| plvdate.bizdays_between(day1 date, day2 date) int | Vrátí počet pracovních dnů mezi dnem1 a dnem2 |
| plvdate.prev_bizday(day date) date | Vrací předchozí pracovní den |
| plvdate.isbizday(date) bool | Testuje, zda-li se jedná o pracovní den |
| plvdate.set_nonbizday(dow varchar) | Nastaví den v týdnu jako mimopracovní |
| plvdate.unset_nonbizday(dow varchar) | Nastaví den v týdnu jako pracovní |
| plvdate.set_nonbizday(day date) | Nastaví den v roce jako mimopracovní |
| plvdate.unset_nonbizday(day date) | Nastaví den v roce jako pracovní |
| plvdate.set_nonbizday(day date, repeat bool) | Nastaví den jako mimopracovní, pokud je repeat true, tak se den bere jako svátek |
| plvdate.unset_nonbizday(day date, repeat bool) | Nastaví den jako pracovní, pokud je repeat true, tak se den bere jako svátek |
| plvdate.use_easter() | Kalendář počítá s Velikonocemi |
| plvdate.unuse_easter(); | Kalendář nepočítá s Velikonocemi |
| plvdate.use_easter(useit boolean); | |
| plvdate.using_easter() bool | Vrací true, pokud kalendář počítá s Velikonocemi |
| plvdate.include_start() | bizdays_between počítá i s prvním dnem |
| plvdate.noinclude_start(); | |
| plvdate.include_start(include boolean); | |
| plvdate.including_start() bool; | |
| plvdate.plvdate.default_holydays(country text); | Načte předdefinovaný kalendář - czech, german, slovakia, ... |
Funkce pro práci se řetězci PLVstr a znaky PLVchr
PLVision obsahuje několik desítek funkcí pro operace s řetězci a znaky. Balíku orafce obsahuje pouze ty obecnější, vynechává např. funkce pro podporu parsování zdrojového kódu PL procedur. Bezesporu nejzajímavější vlastností implementovaných funkcí je podpora negativního pozicování. Pokud jako pozici uvedeme záporné číslo, pak se pozice v řetězci nebude vztahovat k začátku řetězce, ale k jeho konci.
plvstr.left('abcdef',2) -> ab
plvstr.left('abcdef',-2) -> abcd
plvstr.substr('abcdef',1,1) -> a
plvstr.substr('abcdef',-1,1) -> f
plvstr.substr('abcde',-2,1) -> d
Funkce
| plvstr.normalize(str text) | Bílé znaky nahradí mezerami, skupiny mezer nahradí mezerou |
| plvstr.is_prefix(str text, prefix text, cs bool) | Vrací true, pokud je prefix prefixem řetězce str. Parametr cs - case sensitive |
| plvstr.is_prefix(str text, prefix text) | Vrací true, pokud je prefix prefixem řetězce str |
| plvstr.is_prefix(str int, prefix int) | Vrací true, pokud je prefix prefixem čísla str |
| plvstr.is_prefix(str bigint, prefix bigint) | Vrací true, pokud je prefix prefixem čísla str |
| plvstr.substr(str text, start int, len int) | Vrací len znaků začínající od pozice start |
| plvstr.substr(str text, start int) | Vrací řetězec znaků od pozice start až do konce |
| plvstr.instr(str text, patt text, start int, nth int) | Hledá vzor v řetězci, nth kolikátý výskyt |
| plvstr.instr(str text, patt text, start int) | Hledá vzor v řetězci |
| plvstr.instr(str text, patt text) | Hledá vzor v řetězci |
| plvstr.lpart(str text, div text, start int, nth int, all_if_notfound bool) | Vrací znaky nalevo od nalezeného vzoru div, hledání začne na pozici start, hledá n-tý výskyt vzoru, pokud je all_if_notfound true, pak když nenajde vzor vrací celý řetězec jinak NULL |
| plvstr.lpart(str text, div text, start int, nth int) | Vrací znaky nalevo od nalezeného vzoru div, hledání začne na pozici start, hledá n-tý výskyt vzoru |
| plvstr.lpart(str text, div text, start int) | Vrací znaky napravo od nalezeného vzoru div, hledání začne na pozici start |
| plvstr.lpart(str text, div text) | Vrací znaky nalevo od nalezeného vzoru div |
| plvstr.rpart(str text, div text, start int, nth int, all_if_notfound bool) | Vrací znaky nalevo od nalezeného vzoru div, hledání začne na pozici start, hledá n-tý výskyt vzoru, pokud je all_if_notfound true, pak když nenajde vzor vrací celý řetězec jinak NULL |
| plvstr.rpart(str text, div text, start int, nth int) | Vrací znaky nalevo od nalezeného vzoru div, hledání začne na pozici start, hledá n-tý výskyt vzoru |
| plvstr.rpart(str text, div text, start int) | Vrací znaky nalevo od nalezeného vzoru div, hledání začne na pozici start |
| plvstr.rpart(str text, div text) | Vrací znaky nalevo od nalezeného vzoru div |
| plvstr.lstrip(str text, substr text, num int) | Odstraní n opakování vzoru substr z řetězce zleva |
| plvstr.lstrip(str text, substr text) | Odstraní opakovaný vzor substr z řetězce zleva |
| plvstr.rstrip(str text, substr text, num int) | Odstraní n opakování vzoru substr z řetězce zprava |
| plvstr.rstrip(str text, substr text) | Odstraní opakovaný vzor substr z řetězce zprava |
| plvstr.rvrs(str text, start int, _end int) | Otočí část řetězce od start do _end |
| plvstr.rvrs(str text, start int) | Otočí část řetězce od pozice start do konce |
| plvstr.rvrs(str text) | Otočí řetězec |
| plvstr.left(str text, n int) | Vrací prvních n znaků zleva. Pokud je n záporné, vrací znaky od začátku řetězce do n znaků zprava |
| plvstr.right(str text, n int) | Vrací prvních n znaků zprava . Pokud je n záporné, vrací znaky od konce řetězce do n znaků zleva |
| o plvchr.nth(str text, n int) | Vrací n-tý znak v řetězci |
| plvchr.first(str text) | Vrací první znak |
| plvchr.last(str text) | Vrací poslední znak |
| plvchr.is_blank(c int) | Je znak prázdným znakem? |
| plvchr.is_blank(c text) | Je znak prázdným znakem? |
| plvchr.is_digit(c int) | Je znak číslicí? |
| plvchr.is_digit(c text) | Je znak číslicí? |
| plvchr.is_quote(c int) | Je znak apostrofem? |
| plvchr.is_quote(c text) | Je znak apostrofem? |
| plvchr.is_other(c int) | Je něčím jiným, ne ASCII7 znak |
| plvchr.is_other(c text) | Je něčím jiným, ne ASCII7 znak |
| plvchr.is_letter(c int) | Je znak písmenem? |
| plvchr.is_letter(c text) | Je znak písmenem? |
| plvchr.char_name(c text) | Vrací název znaku, zajímavé zejména pro bílé znaky |
| plvchr.quoted1(str text) | Vloží text mezi |
| plvchr.quoted2(str text) | Vloží text mezi '"' |
| plvchr.stripped(str text, char_in text) | Odstraní z řetězce všechny znaky z char_in |
PLVsubst
Funkce z tohoto balíčku umožňují snadnou substituci určitých symbolů v řetězci. Např. pro transformaci nápovědy, chybových hlášení, záznamů v logu atd. Výchozí substituční symbol je '%s'. Tento symbol lze v rámci sezení změnit. Data lze předávat buďto jako pole nebo v jako řetězec obsahující seznam hodnot oddělených specifickým symbolem (výchozí hodnotou je symbol ',').
postgres=# select plvsubst.string('Jmenuji se %s %s', ARRAY['Pavel','Stěhule']);
string
---------------------------
Jmenuji se Pavel Stěhule
(1 row)
Funkce
| plvsubst.setsubst ([varchar = '%s']) | Nastaví substituční symbol platný v dané session |
| plvsubst.subst () | Vrátí aktuální substituční symbol |
| plvsubst.string (text, text[] [, text = '%s']) | Nahradí všechny výskyty substitučního symbolu prvky pole |
| plvsubst.string (text, text [, text = ',' [, text = '%s']]) | Nahradí všechny výskyty substitučního symbolu prvky seznamu |
DBMS_UTILITY
Funkce
| dbms_utility.format_call_stack() | Vrací víceřádkový řetězec obsahující obsah zásobníku volání. |
PLVlex
Obsahuje pouze jednu funkci vracející tabulku obsahující množinu tokenů zadaného SQL řetězce. Hodnoty code v různých verzích PostgreSQL mohou být rozdílené.
postgres=# SELECT * FROM plvlex.tokens('SELECT t.* FROM tabulka t WHERE t.i = 10',true, true);
pos | token | code | class | separator | mod
-----+---------+------+---------+-----------+------
0 | select | 527 | KEYWORD | |
7 | t | | IDENT | |
8 | . | 46 | OTHERS | | self
9 | * | 42 | OTHERS | | self
11 | from | 377 | KEYWORD | |
16 | tabulka | | IDENT | |
24 | t | | IDENT | |
26 | where | 591 | KEYWORD | |
32 | t.i | | IDENT | |
36 | = | 61 | OTHERS | | self
38 | 10 | | NCONST | | i
(11 rows)
Funkce
| plvlex.tokens (text, bool, bool) | Provede lexikální analýzu SQL řetězce. Druhým argumentem určujeme, zda se mají přeskakovat bílé znaky, třetím, zda má dojít ke generování kvalifikovaných identifikátorů. |
Instalace
Předpokladem je, že máte k dispozici zdrojové kódy PostgreSQL. Do poddresáře contrib rozbalte archiv se zdrojovými kódy orafce..tgz. Z příkazové řádky přejděte do tohoto adresáře. Spusťe překlad a instalaci příkazem make install. Poté restartujte server PostgreSQL. Spusťe si sql konzoli psql nad databázi, kde chcete používat funkce Oracle a naimportujte registrační skript orafunc.sql.
cp orafce-2.0.1-preview.tgz /usr/loca/src/pgsql/contrib cd /usr/local/src/pgsql/contrib tar xvfz orafce-2.0.8-pre.tgz cd orafce make install /etc/init.d/postgres restart # make installcheck psql mojedb \i orafunc.sql select next_day(current_date,'saturday');
Pro verzi 8.2 je k dispozici rpm balíček (ke stažení z http://developer.postgresql.org/~devrim/rpms/other/orafce/).
Hlášení chyb
Pokud zjistíte chybu u některé funkce, prosím, pošlete mail s popisem chyby a příkladem, na kterém je zřejmé, jak se chyba projevuje Pavlu Stěhulemu