Akcia PG_READ

Funkcia
Čítanie určenej stránky z tabuľky.
Deklarácia
PG_READ handleIdent_Int, pageNrIdent_Int, locVarArrIdent, retCodeIdent_Int
Parametre
handleIdent_IntinIdentifikátor typu Int - (handle) spojenia s tabuľkou (získaný akciou PG_CONNECT).
pageNrIdent_IntinIdentifikátor typu Int - číslo žiadanej stránky (od 1 …).
locVarArrIdentoutIdentifikátor lokálnej premennej typu Record (celej štruktúry) - výsledok čítania.
retCodeIdent_IntoutIdentifikátor typu Int - návratová hodnota (úspešnosť akcie).
Návratový kód
Hodnota parametra retCodeIdent_Int - pozri tabuľku chybových stavov. Je možné získať rozšírenú informáciu o chybe.
Popis
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.
Upozornenie
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.
Poznámka
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íklad práce s tabuľkou (akcie PG_ ...).
Súvisiace odkazy
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

Súvisiace stránky:

Akcie v skriptoch

Napíšte komentár