Index: phpdoc/hu/functions/pgsql.xml
diff -u /dev/null phpdoc/hu/functions/pgsql.xml:1.4
--- /dev/null Thu Sep 13 03:32:23 2001
+++ phpdoc/hu/functions/pgsql.xml Thu Sep 13 03:32:23 2001
@@ -0,0 +1,1218 @@
+
+
+
+ PostgreSQL függvények
+ PostgreSQL
+
+
+
+ Postgres, amit eredetileg a UC Berkeley Computer Science
+ Department fejlesztett ki, úttörő volt az objektum-relációs adatmodellek területén, és most elérhetővé válik több kereskedelmi adatbázisban is.
+ Támogatja az SQL92/SQL3 nyelv használatát, tranzakciók integritását és a
+ típusok kiterjeszthetőségét. A PostgreSQL egy public-domain,
+ nyílt forrású leszármazottja ennek az eredeti Berkeley kódnak.
+
+
+ A PostgreSQL ingyenes. A legújabb verzió a
+ www.PostgreSQL.org címen érhető el.
+
+
+ A 6.3 verzió óta (03/02/1998) a PostgreSQL unix socketeket használ.
+ A lenti táblázat mutatja az új kapcsolatteremtési lehetőségeket.
+ Ez a socket a /tmp/.s.PGSQL.5432 néven érhető el.
+ Ezt az opciót a postmaster parancs '-i'
+ kapcsolójával érheted el, a jelentése pedig:
+ "figyeld a TCP/IP socketeket is úgy, mint a unix socketeket".
+
+ Postmaster és a PHP
+
+
+
+ Postmaster
+ PHP
+ Állapot
+
+
+
+
+ postmaster &
+ pg_connect("", "", "", "", "dbname");
+ OK
+
+
+ postmaster -i &
+ pg_connect("", "", "", "", "dbname");
+ OK
+
+
+ postmaster &
+ pg_connect("localhost", "", "", "", "dbname");
+
+ Unable to connect to PostgreSQL server: connectDB() failed:
+ Is the postmaster running and accepting TCP/IP (with -i)
+ connection at 'localhost' on port '5432'? in
+ /path/to/file.php3 on line 20.
+ vagyis:
+ Nem lehet kapcsolódni a PostgreSQL szerverhez: a connectDB() hívás
+ meghiúsult. Fut a postmaster, és fogadja a TCP/IP kapcsolatokat (-i)
+ a helyi gépen az 5432-es porton? a
+ /elérési_út/a/file.php3 a 20-as sorban
+
+
+
+ postmaster -i &
+ pg_connect("localhost", "", "", "", "dbname");
+ OK
+
+
+
+
+
+
+ A következőképp is kezdhetsz kapcsolatot:
+ $conn = pg_Connect("host=localhost port=5432
+ dbname=chris");
+
+
+ Annak érdekében, hogy használhassunk nagy objektum felületet (lo),
+ szükséges az egészet egy tranzakciós blokkba foglalni. A tranzakciós
+ blokk egy begin-nel kezdődik, és ha a tranzakció
+ érvényes, egy commit-tal vagy egy
+ end-del végződik. Ha a tranzakció meghiúsul, akkor
+ rollback vagy abort paranccsal
+ kell végződnie.
+
+
+ Nagy objektumok használata
+
+<?php
+ $database = pg_Connect ("", "", "", "", "jacarta");
+ pg_exec ($database, "begin");
+ $oid = pg_locreate ($database);
+ echo ("$oid\n");
+ $handle = pg_loopen ($database, $oid, "w");
+ echo ("$handle\n");
+ pg_lowrite ($handle, "gaga");
+ pg_loclose ($handle);
+ pg_exec ($database, "commit");
+?>
+
+
+
+
+
+
+
+ pg_Close
+ lezár egy PostgreSQL kapcsolatot
+
+
+ Leírás
+
+
+ bool pg_close
+ int connection
+
+
+
+ Hamissal tér vissza, ha a connection érvénytelen kapcsolatazonosító,
+ egyébként igazzal. Lezárja az adott azonosítójú kapcsolatot a
+ PostgreSQL adatbázissal.
+
+
+
+
+
+
+ pg_cmdTuples
+ az érintett sorok számát adja vissza
+
+
+ Leírás
+
+
+ int pg_cmdtuples
+ int result_id
+
+
+
+ A pg_cmdTuples az INSERT, UPDATE vagy DELETE
+ kérések által érintett sorokat adja vissza. Ha egyetlen sor sem
+ érintett, az eredmény 0 lesz.
+
+ pg_cmdtuples
+
+<?php
+$result = pg_exec($conn, "INSERT INTO verlag VALUES ('Autor')");
+$cmdtuples = pg_cmdtuples($result);
+echo $cmdtuples . " <- cmdtuples affected.";
+?>
+
+
+
+
+
+
+
+
+ pg_Connect
+ megnyit egy kapcsolatot
+
+
+ Leírás
+
+
+ int pg_connect
+ string host
+ string port
+ string options
+ string tty
+ string dbname
+
+
+
+ Sikeres végrehajtás esetén egy kapcsolat-azonosítóval tér vissza,
+ vagy hamissal, ha a kapcsolat nem hozható létre. Kapcsolatot nyit
+ egy PostgreSQL adatbázishoz. Az összes argumentum változó-interpolált,
+ beleértve a porszámot is. Az options és a tty argumentumok opcionálisak,
+ vagyis elhagyhatók. Ez a függvény egy kapcsolat-azonosítóval tér vissza,
+ mely más PostgreSQL függvények használatához szükséges. Egyszerre
+ több kapcsolatot is tudsz nyitni.
+
+
+ Kapcsolat létrehozására alkalmas az alábbi parancs is:
+ $conn = pg_connect("dbname=marliese port=5432");
+ A dbname és a
+ port paraméter mellett még használható a
+ host,
+ tty,
+ options,
+ user és a
+ password.
+
+
+ Lásd még a pg_pConnect függvényt.
+
+
+
+
+
+
+ pg_DBname
+ adatbázis neve
+
+
+ Leírás
+
+
+ string pg_dbname
+ int connection
+
+
+
+ Az adott kapcsolatazonosítójú PostgreSQL adatbázisnevével tér vissza, vagy hamissal, ha a kapcsolat-azonosító érvénytelen.
+
+
+
+
+
+
+ pg_ErrorMessage
+ hibaüzenet
+
+
+ Leírás
+
+
+ string pg_errormessage
+ int connection
+
+
+
+ Egy hibaüzenetet tartalmazó stringgel tér vissza, vagy hamissal, ha gáz van.
+ Returns a string containing the error message, false on failure.
+ A hibáról részletes leírást valószínűleg nem sikerül kapnod ezzel a
+ pg_errormessage függvénnyel, ha egy hiba történt a legutolsó adatbázisművelet során, amely számára létezik egy érvényes kapcsolat, ez a függvény a backend server által generált üzenetet írja ki.
+
+
+
+
+
+
+ pg_Exec
+ végrehajt egy kérést
+
+
+ Leírás
+
+
+ int pg_exec
+ int connection
+ string query
+
+
+
+ Egy eredményindexszel tér vissza, ha a kérés teljesíthető, vagy hamissal, ha a
+ kapcsolat-azonosító érvénytelen, vagy nem teljesíthető a kérés.
+ A hibára vonatkozó részleteket a
+ pg_ErrorMessage függvény segítségével
+ nyerhetünk, ha a kapcsolat létezik.
+ Egy SQL kérést küld a kapcsolat-azonosítóban meghatározott
+ PostgreSQL adatbázisnak. A kapcsolat-azonosítónak egy valós
+ pg_Connect által visszaadott azonosítónak
+ kell lennie. E függvény visszatérési értéke indexül szolgál más
+ PostgreSQL függvények segítségével történő információeléréshez.
+
+
+ A PHP/FI 1-gyel tért vissza, ha a kérés nem szolgáltatott adatot.
+ (pl.: insert vagy update) és 1-nél nagyobb számot olyan selecteknél
+ is, ami üres halmazzal tért vissza.
+ No such assumption can be made in PHP. [Nincs ilyen feltételezés a PHP-ben???]
+
+
+
+
+
+
+
+
+ pg_Fetch_Array
+ beolvas egy sort egy tömbbe
+
+
+ Leírás
+
+
+ array pg_fetch_array
+ int result
+ int row
+ int
+ result_type
+
+
+
+
+ Az adatbázis következő sorával tér vissza tömb formában, vagy hamissal,
+ ha már nincs több sor.
+
+
+ A pg_fetch_array függvény a
+ pg_fetch_row kiterjesztett változata.
+ Amellett, hogy a tömb numerikusan indexelhető, az adatokat asszociatív
+ indexszel is tárolja a mezőneveket használva kulcsnak.
+
+
+ A harmadik, result_type nevű argumentum a következő
+ értékeket veheti fel: PGSQL_ASSOC, PGSQL_NUM, and PGSQL_BOTH.
+
+
+ A result_type paraméter a PHP 4.0-ás
+ változatában került a nyelvbe.
+
+
+
+
+ Jó tudni, hogy a
+ pg_fetch_array használata NEM jelentősen lassabb,
+ mint a pg_fetch_row használata, míg az eredmény érthetőbb.
+
+
+ További részletekért lásd még a
+ pg_fetch_row
+ függvényt.
+
+
+ A pg_fetch_array használata
+
+<?php
+$conn = pg_pconnect("","","","","publisher");
+if (!$conn) {
+ echo "Hiba történt.\n";
+ exit;
+}
+
+$result = pg_Exec ($conn, "SELECT * FROM authors");
+if (!$result) {
+ echo "Hiba történt.\n";
+ exit;
+}
+
+$arr = pg_fetch_array ($result, 0);
+echo $arr[0] . " <- array\n"; #hiba < kell!!!
+
+$arr = pg_fetch_array ($result, 1);
+echo $arr["author"] . " <- array\n"; # itt is
+?>
+
+
+
+
+
+
+
+ pg_Fetch_Object
+ sor beolvasása objektumként
+
+
+ Leírás
+
+
+ object pg_fetch_object
+ int result
+ int row
+ int
+ result_type
+
+
+
+
+ Egy objektummal tér vissza, aminek a tulajdonságai megegyeznek a beolvasott
+ sor mezőivel, hamissal, ha nincs több sor.
+
+
+ pg_fetch_object hasonló a
+ pg_fetch_array-hoz, egy különbséget kivéve -
+ objektummal tér vissza, nem tömbbel. Vagyis adatot csak mezőnevekkel érhetsz
+ el, indexszel (számokkal) nem (a számok ugyanis illegális mezőnevek).
+
+
+ A harmadik, result_type nevű argumentum a következő
+ értékeket veheti fel: PGSQL_ASSOC, PGSQL_NUM, and PGSQL_BOTH.
+
+
+ A result_type paraméter a PHP 4.0-ás
+ változatában került a nyelvbe.
+
+
+
+
+ Sebesség szempontjából, a függvény azonos a
+ pg_fetch_array függvénnyel, és majdnem olyan gyors, mint a
+ pg_fetch_row (a különbség jelentéktelen).
+
+
+ Lásd még a pg_fetch_array és a
+ pg_fetch_row függvényeket.
+
+ pg_fetch_object alkalmazása
+
+<?php
+$database = "verlag";
+$db_conn = pg_connect ("localhost", "5432", "", "", $database);
+if (!$db_conn): ?>
+ <H1>Nem lehet kapcsolódni a <? echo $database ?> nevű adatbázishoz.</H1> <?
+ exit;
+endif;
+
+$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor");
+$row = 0; // A postgresnek kell egy sorszámláló, ami más adatbáziskezelőnél talán nem
+
+while ($data = pg_fetch_object ($qu, $row)):
+ echo $data->autor." (";
+ echo $data->jahr ."): ";
+ echo $data->titel."<BR>";
+ $row++;
+endwhile; ?>
+
+<PRE><?php
+$fields[] = Array ("autor", "Author");
+$fields[] = Array ("jahr", " Year");
+$fields[] = Array ("titel", " Title");
+
+$row= 0; // A postgresnek kell egy sorszámláló, ami más adatbáziskezelőnél talán nem
+while ($data = pg_fetch_object ($qu, $row)):
+ echo "----------\n";
+ reset ($fields);
+ while (list (,$item) = each ($fields)):
+ echo $item[1].": ".$data->$item[0]."\n";
+ endwhile;
+ $row++;
+endwhile;
+echo "----------\n"; ?>
+</PRE> <?php
+pg_freeResult ($qu);
+pg_close ($db_conn);
+?>
+
+
+
+
+
+
+
+
+ pg_Fetch_Row
+ következő sor beolvasása numerikusan indexelt tömbbe
+
+
+ Leírás
+
+
+ array pg_fetch_row
+ int result
+ int row
+
+
+
+ A beolvasott sorral tér vissza numerikusan indexelt (hagyományos)
+ tömb formájában, vagy hamissal, ha nincs több sor.
+
+
+ A pg_fetch_row függvény betölti a megadott
+ eredmény-azonosítónak megfelelő sort. Az eredményt eredmény formában
+ adja vissza. Az egyes oszlopokat indexszel (számmal) lehet elérni.
+ Az első oszlop indexe 0.
+
+
+ A pg_fetch_row egymás utáni alkalmazásával az
+ eredményhalmaz következő sorát kapjuk, amíg van következő sor, majd
+ hamist, ha már nincs több sor.
+
+
+ Lásd még a pg_fetch_array,
+ pg_fetch_object és a
+ pg_result függvényeket.
+
+ pg_fetch_row alkalmazás
+
+<?php
+$conn = pg_pconnect("","","","","publisher");
+if (!$conn) {
+ echo "Gáz van.\n";
+ exit;
+}
+
+$result = pg_Exec ($conn, "SELECT * FROM authors");
+if (!$result) {
+ echo "Baj van, nagy baj van.\n";
+ exit;
+}
+
+$row = pg_fetch_row ($result, 0);
+echo $row[0] . " <- row\n"; # < helyett valami más kell
+
+$row = pg_fetch_row ($result, 1);
+echo $row[0] . " <- row\n"; # itt is
+
+$row = pg_fetch_row ($result, 2);
+echo $row[1] . " <- row\n"; # detto
+?>
+
+
+
+
+
+
+
+
+ pg_FieldIsNull
+ Megvizsgálja, hogy egy mező NULL-e
+
+
+ Leírás
+
+
+ int pg_fieldisnull
+ int result_id
+ int row
+ mixed field
+
+
+
+ Megviszgálja, hogy egy adott sorban az adott mező NULL-e, vagy sem.
+ 0-t ad vissza, ha a mező nem NULL, 1-et, ha NULL. A mező számmal,
+ vagy mezőnévvel adható meg. A sorok számozása 0-val kezdődik.
+
+
+
+
+
+
+ pg_FieldName
+ Egy mező nevét mondja meg
+
+
+ Leírás
+
+
+ string pg_fieldname
+ int result_id
+ int field_number
+
+
+
+ A pg_FieldName függvény az adott eredményazonosító
+ és oszlopszám alapján megmondja az oszlop nevét. Az oszlopszámozás
+ 0-val kezdődik.
+
+
+
+
+
+
+ pg_FieldNum
+ Adott mező oszlopszámát mondja meg
+
+
+ Leírás
+
+
+ int pg_fieldnum
+ int result_id
+ string field_name
+
+
+
+ A pg_FieldNum függvény adott eredmény-azonosítójú
+ eredmény adott nevű oszlopának a sorszámát adja vissza. A sorszámozás
+ 0-tól indul. Hiba esetén -1-gyel tér vissza.
+
+
+
+
+
+
+ pg_FieldPrtLen
+ Nyomtatott hosszal tér vissza
+
+
+ Leírás
+
+
+ int pg_fieldprtlen
+ int result_id
+ int row_number
+ string field_name
+
+
+
+ A pg_FieldPrtLen függvény egy eredmény adott
+ sorának, adott mezejének nyomtatott hosszát (hány darab karakter)
+ adja vissza. A sorok számozása 0-val kezdődik. A függvény -1-gyel
+ tér vissza hiba esetén.
+
+
+
+
+
+
+ pg_FieldSize
+
+ Adott mező belső tárolási méretét adja
+
+
+
+ Leírás
+
+
+ int pg_fieldsize
+ int result_id
+ int field_number
+
+
+
+ A pg_FieldSize az adott eredmény adott mezejének
+ belső tárolási méretét (byteban) adja vissza. A mezők számozása 0-val
+ kezdődik. A -1 hosszú mező változó hosszúságú mezőt jelent. A függvény
+ hiba esetén hamisat ad vissza.
+
+
+
+
+
+
+ pg_FieldType
+
+ Az adott mezú típusát adja vissza
+
+
+
+ Leírás
+
+
+ int pg_fieldtype
+ int result_id
+ int field_number
+
+
+
+ A pg_FieldType függvény az adott azonosítójú
+ eredményhalmaz adott mezejének típusát leíró stringgel tér vissza.
+ A mezők számozása 0-tól indul.
+
+
+
+
+
+
+ pg_FreeResult
+ Adatbázishoz kapcsolódó memória felszabadítása
+
+
+ Leírás
+
+
+ int pg_freeresult
+ int result_id
+
+
+
+ A pg_FreeResult függvényt csak akkor kell
+ meghívnod, ha félsz attól, hogy túl sok memóriát használ a
+ scripted, míg fut. Az összes felhasznált memória automatikusan
+ felszabadul, amikor a script futása véget ér. Azonban, ha
+ biztos vagy benne, hogy az eredény már nem fog kelleni,
+ meghívhatod a
+ pg_FreeResult függvényt az eredmény-azonosítóval,
+ és az eredményhalmazhoz tartalmazó memória felszabadul.
+
+
+
+
+
+
+ pg_GetLastOid
+ Az utolsó objektumazonosítót adja
+
+
+ Leírás
+
+
+ int pg_getlastoid
+ int result_id
+
+
+
+ A pg_GetLastOid függvény egy
+ pg_Exec-kel végrehajtott SQL INSERT-hez
+ rendelt Oid (Object identifier - objektum azonosító) visszanyerésére
+ használható. Ez a függvény pozitív egésszel tér vissza, ha egy valós
+ Oid-ről van szó. Ha hiba történt, vagy az utolsó művelet, amit a
+ pg_Exec-kel végeztek nem INSERT, a függvény -1-gyel
+ tér vissza.
+
+
+
+
+
+
+ pg_Host
+ A hostnevet adja vissza
+
+
+ Leírás
+
+
+ string pg_host
+ int connection_id
+
+
+
+ A pg_Host függvény az adott kapcsolat-azonosítójú
+ PostgreSQL host nevét adja vissza.
+
+
+
+
+
+
+ pg_loclose
+ Bezár egy nagy objektumot
+
+
+ Leírás
+
+
+ void pg_loclose
+ int fd
+
+
+
+ A pg_loclose bezár egy Inversion Large
+ Object-et. Az fd paraméter a
+ pg_loopen-ből származó nagy objektum leírója.
+
+
+
+
+
+
+ pg_locreate
+ létrehoz egy nagy objektumot
+
+
+ Leírás
+
+
+ int pg_locreate
+ int conn
+
+
+
+ A pg_locreate létrehoz egy
+ Inversion Large Object-et és a nagy objektum oid-jével tér vissza.
+ A conn paraméter határozza meg a kapcsolat
+ azonosítóját. A PostgreSQL hozzáférési módok: INV_READ, INV_WRITE, és
+ INV_ARCHIVE nem támokatottak, az objektum mindig írási és olvasási
+ joggal kerülnek létrehozásra. Az INV_ARCHIVE pedig el lett távolítva
+ a nyelvből (a 6.3-as verziótól).
+
+
+
+
+
+
+ pg_loexport
+ Nagy objektumot file-ba exportál
+
+
+ Leírás
+
+
+ bool pg_loexport
+ int
+ oid
+
+ int
+ file
+
+ int
+ connection_id
+
+
+
+
+ Az oid argumentum határozza meg az exportálandó
+ objektum azonosítóját, és a filename argumentum
+ határozza meg a file útvonalát és nevét. FALSE-szal tér vissza hiba esetén,
+ egyébként TRUE-val. Ne feledd, hogy a PostgreSQL-ben nagy objektumokat
+ csak tranzakciókon belül lehet kezelni.
+
+
+
+
+
+
+ pg_loimport
+ nagy objektumot importál fileból
+
+
+ Leírás
+
+
+ int pg_loimport
+ int
+ file
+
+ int
+ connection_id
+
+
+
+
+ A filename paraméter határozal meg az importálandó
+ file útvonalát és nevét. FALSE-szal tér vissza, ha hiba történt,
+ az éppen most létrehozott objektum azonosítójával, ha a művelet sikerült.
+ Ne feledd, hogy a PostgreSQL-ben nagy objektumokat
+ csak tranzakciókon belül lehet kezelni.
+
+
+
+
+
+
+ pg_loopen
+ megnyit egy nagy objektumot
+
+
+ Leírás
+
+
+ int pg_loopen
+ int conn
+ int objoid
+ string mode
+
+
+
+ pg_loopen megnyit egy Inversion Large Object-et
+ és a nagy objektum file leírójával tér vissza. A file leíróban információ
+ van a kapcsolatról. Ne zárd le a kapcsolatot, míg le nem zárod a nagy objektum
+ file leíróját.
+ Az objoid paraméter egy valós nagy objektum oid-jét
+ határozza meg, és a mode paraméter lehet
+ "r", "w", vagy "rw".
+
+
+
+
+
+
+ pg_loread
+ nagy objektumot olvas be
+
+
+ Leírás
+
+
+ string pg_loread
+ int fd
+ int len
+
+
+
+ A pg_loread beolvas legfeljebb
+ len byte-ot olvas be a nagy objektumból,
+ és stringként adja vissza.
+ Az fd paraméter a file leírót határozza meg
+ és a len ##parameter előtt hiányzik egy space
+ paraméter határozza meg a maximális
+ megengedett nagy objektum szegmens méretét.
+
+
+
+
+
+
+ pg_loreadall
+ egy egész nagy objektumot olvas be
+
+
+ Leírás
+
+
+ void pg_loreadall
+ int fd
+
+
+
+ A pg_loreadall fügvény egy nagy objektumot olvas
+ be, és közvetlenül kiírja a böngészőbe, miután minden szükséges
+ fejlécet kiírt. Főleg bináris jellegű adat kiírására szánták. (pl.: képek, hang)
+
+
+
+
+
+
+ pg_lounlink
+ töröl egy nagy objektumot
+
+
+ Leírás
+
+
+ void pg_lounlink
+ int conn
+ int lobjid
+
+
+
+ A pg_lounlink függvény törli a
+ lobjid-vel azonosított nagy objektumot.
+
+
+
+
+
+
+ pg_lowrite
+ nagy objektumot ír
+
+
+ Leírás
+
+
+ int pg_lowrite
+ int fd
+ string buf
+
+
+
+ A pg_lowrite függvény kiír egy nagy objektumba
+ egy változóból maximum buf bytetot, és a
+ ténylegesen kiírt byteok számával tér vissza, vagy false-szal, ha hiba történt.
+ Az fd paraméter a nagy objektum
+ pg_loopen hívásából származó file azonosító.
+
+
+
+
+
+
+ pg_NumFields
+ Mezők száma
+
+
+ Leírás
+
+
+ int pg_numfields
+ int result_id
+
+
+
+ A pg_NumFields függvény a PostgreSQL eredményben
+ levő mezők (oszlopok) számát adja vissza. Az argumentumnak valós,
+ pg_Exec-ből származó eredmény-azonosítónak kell
+ lennie. A függvény hiba esetén -1-gyel tér vissza.
+
+
+
+
+
+
+ pg_NumRows
+ Sorok száma
+
+
+ Leírás
+
+
+ int pg_numrows
+ int result_id
+
+
+
+ A pg_NumRows függvény a PostgreSQL eredményhalmaz
+ sorainak számát adja vissza. Az argumentumnak valós,
+ pg_Exec-ből származó eredmény-azonosítónak kell
+ lennie. A függvény hiba esetén -1-gyel tér vissza.
+
+
+
+
+
+
+ pg_Options
+ Returns options
+
+
+ Leírás
+
+
+ string pg_options
+ int connection_id
+
+
+
+ A pg_Options függvény egy stringgel tér vissza,
+ amiben az adott PostgreSQL azonosító kapcsolat opcióit tartalmazza.
+
+
+
+
+
+
+ pg_pConnect
+
+ Tartós adatbázis-kapcsolatot hoz létre
+
+
+
+ Leírás
+
+
+ int pg_pconnect
+ string host
+ string port
+ string options
+ string tty
+ string dbname
+
+
+
+ Siker esetén egy kapcsolat-indexszel tér vissza, vagy hamissal,
+ ha a kapcsolat nem hozható létre. Tartós kapcsolatot nyit a
+ PostgreSQL adatbázishoz. Minden paraméternek idézőjelezettnek
+ kell lennie, beleértve a portszámot. Az options és a tty paraméterek
+ elhagyhatók. A függvény egy olyan kapcsolat-azonosítóval tér vissza,
+ amely szükséges más PostgreSQL függvények végrehajtásához.
+ Egyszerre több tartós kapcsolatod is lehet nyitva egyszerre. [Hát igen,
+ ez a Postgres még a valós életet is túlszárnyalja...]
+ Lásd még a pg_Connect függvényt.
+
+
+ Kapcsolat a következő módon is létrehozható:
+ $conn = pg_pconnect("dbname=marliese port=5432");
+ Egyéb paraméterek dbname és
+ port are[???] host,
+ tty, options,
+ user és password.
+
+
+
+
+
+
+ pg_Port
+ Melyik porton van a kapcsolat
+
+
+ Leírás
+
+
+ int pg_port
+ int connection_id
+
+
+
+ A pg_Port függvény az adott PostgreSQL kapcsolat-azonosítójú
+ összeköttetés portszámát adja meg.
+
+
+
+
+
+
+ pg_Result
+ Egy eredényazonosító alapján ad vissza értékeket
+
+
+ Leírás
+
+
+ mixed pg_result
+ int result_id
+ int row_number
+ mixed fieldname
+
+
+
+ A pg_Result függvény a pg_Exec-ból
+ származó értékeket szolgáltat.
+ A row_number és a
+ fieldname paraméterek határozzák meg, hogy az
+ eredmény mely oszlopát adja vissza a függvény. A sorok számozása 0-val
+ kezdődik. A mezők megnevezése helyett a mezők sorszámát is használhatjuk.
+ Ekkor számként kell megadni az oszlopszámot (nem idézőjelben). A mezők számozása
+ is 0-val kezdődik.
+
+
+ A PostgreSQL-nek nagyon sok beépített típusa van, és csak a legalapvetőbbekre
+ van támogatás. Az integerek, booleanok, és oid-ek minden fajtája egészként
+ adódik vissza. A floatok, realek pedig double-ként jelennek meg.
+ Minden egyéb típus, beleértve a tömböket is, formázott stringként adódnak vissza.
+ A stringek ugyanolyan formában adja vissza, mint azt a psql
+ program [az alapértelmezett PostgreSQL program].
+
+
+
+
+
+
+ pg_trace
+ PostgreSQL szerver kapcsolatot követ nyomon
+
+
+ Leírás
+
+
+ bool pg_trace
+ string
+ filename
+
+ string
+ mode
+
+ int
+ connection
+
+
+
+
+ Engedélyezi a PostgreSQL felület kommunikációinak nyomkövetését egy
+ fileba. Ahhoz, hogy megértsd az eredményeket, meg kell barátkoznod
+ a PostgreSQL kommunikációs protokolljával.
+ Ha nem ismeret a protokollt, hasznos lehet akkor is nyomon követni
+ a szerverhez küldött kérések hibáit; például
+ 'grep '^To backend' trace.log' paranccsal megnézni, hogy milyen kéréseket
+ küldtek a PostgreSQL szervernek.
+
+
+ A filename és a mode paraméterek
+ azonosak a fopen függvényéhez
+ (a mode alapértelmezése 'w'),
+ connection határozza meg a nyomon követendő
+ kapcsolatot; az utoljára megnyitot kapcsolat az alapértelmezett.
+
+
+ TRUE-val tér vissza, ha a filename paraméterben
+ megadott filet meg lehet nyitni loggolásra, egyébként FALSE-szal tér vissza.
+
+
+ Lásd még a fopen és a pg_untrace
+ függvényeket.
+
+
+
+
+
+
+ pg_tty
+ A tty nevét adja vissza
+
+
+ Leírás
+
+
+ string pg_tty
+ int connection_id
+
+
+
+ A pg_tty függvény a tty nevét adja vissza, amelyre
+ az adott azonosítójú kapcsolat
+ szerver oldali nyomkövetésének kimenete kerül.
+
+
+
+
+
+
+ pg_untrace
+ Abbahagyja az adott kapcsolat nyomkövetését
+
+
+ Leírás
+
+
+ bool pg_untrace
+ int
+ connection
+
+
+
+
+ A pg_trace által elindított nyomkövetést szünteti meg.
+ A connection paraméter határozza meg, hogy mely
+ kapcsolat nyomkövetését kell abbahagyni. Az alapértelmezés az utoljára
+ megnyitott kapcsolat.
+
+
+ Mindig TRUE-val tér vissza.
+
+
+ Lásd még a pg_trace függvényt.
+
+
+
+
+
+
+
