PG_UPDATE action

Function
Modification of an already existing row in the specified table.
Declaration
 PG_UPDATE handleIdent_Int, pageNrIdent_Int, rowInPageIdent_Int, rowIdent, retCodeIdent_Int [ORAHINT hintIdent_Str]
Parameters
handleIdent_IntinIdentifier of the Int type (handle) of the connection with a table (returned by the action PG_CONNECT).
pgNrIdent_Int_IntinIdentifier of the Int type of the page, where the modified row is placed in.
rowInPageIdent_IntinIdentifier of the Int type of the serial number of a row modified on the given page.
rowIdentinOne structure row identifier (new row value).
retCodeIdent_IntoutIdentifier of the Int type - action success.
hintIdent_StrinExpression of the String type that defines Oracle SQL hint. It is used as an instruction for the performance optimizer of the SQL command. The value is used without the opening and terminating characters /*+ <orahint> */.
The example is mentioned here.
Return code
The value of the parameter transHandle_Int. See the table of error codes. It is possible to get extended error information.
Description
Table must be opened with the access _DB_MODIFY. The action will modify a row given by the serial number (the identifier rowInPageIdent_Int, numbering from 1 ...) on a page with the given serial number (the identifier pageNrIdent_Int, numbering from 1...).

For using the function on Microsoft SQL Server platform, there must be defined the primary key or at least unique index for a table from the platform. For the platform Sybase and Oracle, the function works without these limitations.

Warning
If the row position (page, row in a page) is given by the ordering (the clause ORDER BY) and a change will influence items determining this ordering, the row may, using the action PG_UPDATE, change its position. The similar feature occurs also in regarding to the condition of a row selection (
WHERE
).
Example
Work with a database table (actions PG_ ...).
Related topics
DB_TRANS_OPEN
DB_TRANS_COMMIT
DB_TRANS_ROLLBACK
DB_TRANS_CLOSE

PG_CONNECT
PG_DISCONNECT
PG_READ
PG_INSERT
PG_DELETE

All database related actions.

Related pages:

Script actions

Napíšte komentár