Akcia PG_READ

Čítanie určenej stránky z tabuľky.

PG_READ handleIdent_Int, pageNrIdent_Int, locVarArrIdent, retCodeIdent_Int

handleIdent_Int	out	Identifikátor typu Int - (handle) spojenia s tabuľkou (získaný akciou PG_CONNECT).
pageNrIdent_Int	in	Identifikátor typu Int - číslo žiadanej stránky (od 1 …).
locVarArrIdent	out	Identifikátor lokálnej premennej typu Record (celej štruktúry) - výsledok čítania.
retCodeIdent_Int	out	Identifikátor typu Int - návratová hodnota (úspešnosť akcie).

Hodnota parametra retCodeIdent_Int - pozri tabuľku chybových stavov. Je možné získať rozšírenú informáciu o chybe.

Akcia prečíta určenú stránku z tabuľky, ktorá bola otvorená akciou PG_CONNECT. Číslo stránky je dané parametrom pageNrIdent_Int. Stránky v tabuľke sú číslované od jednotky (1 ...). Výkon SQL výrazu SELECT pre Oracle, uvedeného v akcii PG_CONNECT, je možné ovplyvniť aj využitím Oracle SQL hint (parameter akcie PG_CONNECT).

Ak bolo čítanie úspešné (retCodeIden_Int = _ERR_NO_ERROR), lokálna premenná locVarArrIdent_Int je naplnená výsledkom čítania (žiadanou stránkou). V prípade potreby je zmenený rozmer poľa lokálnej premennej. Typ štruktúry lokálnej premennej musí byť zhodný s typom tabuľky. Ak výsledkom čítania sú prázdne dáta (chyba _ERR_NO_DATA), lokálne pole bude redimenzované na rozmer 0.

Počet stránok (počet riadkov) sa môže počas práce s databázou meniť, v dôsledku použitia akcií PG_INSERT, PG_DELETE.

Pre MySQL databázu akcia optimálne funguje pri stránkovaní cez nasledujúcu stránku. To znamená, že je to prechod vzostupne od prvej stránky. Akýkoľvek prístup k predchádzajúcej stránke, oproti aktuálne čítanej, vyžaduje interne prestránkovať dáta od začiatku.

Príklad práce s tabuľkou (akcie PG_ ...).

DB_TRANS_OPEN
DB_TRANS_COMMIT
DB_TRANS_ROLLBACK
DB_TRANS_CLOSE

PG_CONNECT
PG_DISCONNECT
PG_INSERT
PG_DELETE
PG_UPDATE

Všetky databázové akcie