Akcia PG_UPDATE


Funkcia
Modifikácia existujúceho riadku v tabuľke.
Deklarácia
PG_UPDATE handleIdent_Int, pageNrIdent_Int, rowInPageIdent_Int, rowIdent, retCodeIdent_Int [ORAHINT hintIdent_Str]

Parametre
handleIdent_Int in Identifikátor typu Int - (handle) spojenia s tabuľkou (získaný akciou PG_CONNECT).
pgNrIdent_Int_Int in Identifikátor typu Int - stránka obsahujúca riadok, ktorý sa bude modifikovať.
rowInPageIdent_Int in Identifikátor typu Int - poradové číslo riadku na stránke.
rowIdent in Identifikátor jedného riadku štruktúry - nová hodnota riadku.
retCodeIdent_Int out Identifikátor typu Int - návratový kód.
hintIdent_Str in Výraz typu String, ktorý definuje Oracle SQL hint. Ten je použitý ako inštrukcia pre optimalizátor výkonu SQL príkazu. Zapisuje hodnotu bez obaľujúcich znakov /*+ <orahint> */.
Príklad použitia je uvedený tu.

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
Tabuľka musí byť otvorená s prístupom _DB_MODIFY. Akcia zmení riadok daný poradovým číslom (identifikátor rowInPageIdent_Int, číslovanie od 1 …) na stránke s daným poradovým číslom (identifikátor pageNrIdent_Int, číslovanie od 1 …).

Pre použitie akcie na platforme Microsoft SQL Server, musí mať tabuľka databázy z tejto platformy definovaný primárny kľúč alebo aspoň unikátny index. Na platformách Sybase a Oracle akcia pracuje aj bez týchto obmedzení.
Upozornenie
Ak je poloha riadku (stránka, riadok v stránke) daná usporiadaním (klauzula ORDER BY) a zmena sa dotkne položiek určujúcich toto usporiadanie, riadok môže akciou PG_UPDATE zmeniť svoju polohu. Podobná vlastnosť sa vyskytuje aj vzhľadom na podmienku výberu riadkov (WHERE).

Súvisiace stránky:

Napíšte komentár