Akcia SQL_FETCH

Funkcia
Akcia prečíta jeden alebo viac riadkov výsledku SQL príkazu pripraveného akciou SQL_PREPARE a prípadne parametrizovaného akciou SQL_BINDIN.
Deklarácia
SQL_FETCH handleIdent_Int, retCodeIdent_Int [, maxRowsIdent_Int]

Parametre
handleIdent_Int in Identifikátor typu Int - jednoznačné číslo (handle) spojenia s databázou.
retCodeIdent_Int out Identifikátor typu Int - návratový kód.
maxRowsIdent_Int in Identifikátor typu Int - počet naraz načítaných riadkov (ak nie je uvedený, náhradná hodnota je 1).

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 daný počet riadkov a ich hodnoty naplní do lokálnych premenných definovaných v akcii SQL_PREPARE.
Parameter maxRowsIdent_Int sa použije len pri 3 variante akcie SQL_PREPARE. Ak je hodnota parametra rôzna od 1 v prípade variantu 1, 2 alebo je menšia ako 1, akcia generuje chybu _ERR_RANGE_ERROR.
Maximálny počet vrátených riadkov je obmedzený konfiguračným parametrom databázy Maximum vrátených riadkov. Pri prekročení tohoto počtu riadkov bude do lokálnej štruktúry _locVarRecordIdent špecifikovanej vo volaní akcie SQL_PREPARE načítaných prvých Maximum vrátených riadkov a v retCodeIdent_Int sa vráti chyba _ERR_DATABASE_ROWS_LIMIT.

Ak nie je načítaný ani jeden riadok, hodnota parametra retCodeIdent_Int bude 22 (_ERR_NO_DATA).
Príklad
Príklad práce s databázou (akcie SQL_...)

 INT  _handle    ; handle to database
 INT  _retCode   ; return code
 TEXT _name      ; product name
 TEXT _type      ; product type
 
 SQL_CONNECT MyDatabase, _handle, _retCode
 SQL_PREPARE _handle, _retCode, _sqlNpar BIND _name, _type
 
 DO_LOOP
   SQL_FETCH _handle, _retCode
   EXIT_LOOP _retCode #  _ERR_NO_ERROR
   ; data processing goes here
 END_LOOP
 
 SQL_FREE _handle
 SQL_DISCONNECT _handle

Súvisiace odkazy
DB_TRANS_OPEN
DB_TRANS_COMMIT
DB_TRANS_ROLLBACK
DB_TRANS_CLOSE

SQL_CONNECT
SQL_DISCONNECT
SQL_EXEC_DIRECT
SQL_EXEC_PROC

SQL_BINDIN
SQL_PREPARE
SQL_FREE

SQL_SELECT

Všetky databázové akcie

Súvisiace stránky:

Akcie v skriptoch

Napíšte komentár