Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
Akcia DB_TRANS_OPEN
Funkcia
Akcia vytvorí nové Pripojenie na databázu.
Deklarácia
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
DB_TRANS_OPEN dbObjIdent, handleIdent_Int, retCodeIdent_Int [TIMEOUT timeoutSec_Int] |
Parametre
| dbObjIdent | in | Odkaz na objekt typu Databáza. |
| handleIdent_Int | out | Identifikátor pre jednoznačné číslo (handle) Pripojenia. |
| retCodeIdent_Int | out | Identifikátor - návratový kód. |
timeoutSec_Int | in | Identifikátor - timeout na príkazy v sekundách. |
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.
Poznámka: Maximálny počet spojení nakonfigurovaný na objekte Databáza je možné obmedziť parametrom Maximum spojení, pričom hodnota 0 obmedzenie vypína. Ak proces D2000 DBManager spotrebuje všetky spojenia, tak ďalšie volania DB_TRANS_OPEN snažiace sa o vytvorenie spojenia vrátia chybu DBM_MAX_CONNECTIONS v premennej _ERR_NR_TRANS_EX.
Poznámka: Maximálny počet spojení nakonfigurovaný na objekte Databáza je možné obmedziť parametrom Maximum spojení, pričom hodnota 0 obmedzenie vypína. Ak proces D2000 DBManager spotrebuje všetky spojenia, tak ďalšie volania DB_TRANS_OPEN snažiace sa o vytvorenie spojenia vrátia chybu DBM_MAX_CONNECTIONS v premennej _ERR_NR_TRANS_EX.
Popis
Identifikátor pre číslo Pripojenia, alebo handle sa používa pri:
Návratový kód popisuje úspešnosť akcie (_ERR_NO_ERROR).
Ak je zadaná nenulová hodnota parametra timeoutSec_Int, tak všetky príkazy vykonávané v rámci tejto transakcie, ktoré budú trvať dlhšie, budú zrušené a rozšírená informácia o chybe vráti v premennej _ERR_NR_TRANS_EX chybu USER_EXPIR_TIME. Zároveň je inkrementovaná hodnota v stĺpci AbortCnt v systémovej štruktúre SV._System_DBMDbPerf. Toto chovanie je zatiaľ implementované iba pre databázu PostgreSQL.
Poznámka: Zrušenie príkazu je realizované PostgreSQL funkciou pg_cancel_backend. Po zrušení príkazu je transkcia naďalej použiteľná.
Príklad
Súvisiace odkazy
DB_TRANS_COMMIT
DB_TRANS_ROLLBACK
DB_TRANS_CLOSE
DB_CONNECT
DB_DELETE
DB_DISCONNECT
DB_INSERT
DB_INSUPD
DB_READ
DB_READ_BLOB
DB_UPDATE
DB_UPDATE_BLOB
PG_CONNECT
PG_DISCONNECT
PG_READ
PG_INSERT
PG_DELETE
PG_UPDATE
SQL_CONNECT
SQL_DISCONNECT
SQL_EXEC_DIRECT
SQL_EXEC_PROC
SQL_PREPARE
SQL_BINDIN
SQL_FETCH
SQL_FREE
Všetky databázové akcie
DB_TRANS_ROLLBACK
DB_TRANS_CLOSE
DB_CONNECT
DB_DELETE
DB_DISCONNECT
DB_INSERT
DB_INSUPD
DB_READ
DB_READ_BLOB
DB_UPDATE
DB_UPDATE_BLOB
PG_CONNECT
PG_DISCONNECT
PG_READ
PG_INSERT
PG_DELETE
PG_UPDATE
SQL_CONNECT
SQL_DISCONNECT
SQL_EXEC_DIRECT
SQL_EXEC_PROC
SQL_PREPARE
SQL_BINDIN
SQL_FETCH
SQL_FREE
Všetky databázové akcie