Identifikátor pre číslo spojenia, alebo handle sa používa pri ďalšej práci s otvorenou databázou. Návratový kód popisuje úspešnosť akcie (
_ERR_NO_ERROR).
Každé otvorenie databázy skriptom má pridelené jednoznačné číslo (identifikátor, handle). Toto je potrebné po ukončení práce s databázou zatvoriť akciou
SQL_DISCONNECT. Ak po skončení skriptu nebudú všetky databázy uzatvorené volaním akcie
SQL_DISCONNECT (tie, ktoré skript pri svojej činnosti otvoril), budú interne automaticky zatvorené. Handle platí len v rámci skriptu, ktorý databázu otvoril.
Akcia
SQL_CONNECT má vždy charakter otvorenia databázy (nie tabuľky na rozdiel od akcií
DB_CONNECT a
PG_CONNECT), lebo prostredníctvom takto vytvoreného spojenia je možné pracovať s celou databázou (všetkými v nej obsiahnutými tabuľkami). Ak sa na otvorenie použije objekt typu
Tabuľka, interne bude databáza otváraná prostredníctvom jeho rodiča, teda objektu typu
Databáza.
Otváranú databázu je možné určiť objektom typu
Databáza alebo
Tabuľka (prvý spôsob zápisu) alebo tzv. pripájacím stringom (druhý spôsob zápisu).
Pri prvom spôsobe nie je potrebné zadať meno procesu
D2000 DBManager, ktorý bude následné príkazy interpretovať, lebo toto je dané rodičovským vzťahom medzi objektom typu
Databáza a týmto procesom. Akcia
SQL_CONNECT využije z konfigurácie objektu typu
Databáza konfiguračné parametre
Užívateľ,
Heslo a
DSN.
Druhý spôsob zápisu umožňuje vytvoriť spojenie s databázou na základe znalosti
Mena,
Hesla a
DSN pomocou tzv. pripájacieho stringu (parameter
connectString). Jeho obsah je nasledovný:
"UID=meno užívateľa;PWD=heslo užívateľa;DSN=meno DSN".
Kľúčové slová
UID,
PWD a
DSN označujú hodnoty jednotlivých parametrov. Ak niektorý z nich nie je uvedený, bude nahradený prázdnym reťazcom. Pri tomto spôsobe je nutné špecifikovať odkazom proces
D2000 DBManager, ktorý bude zabezpečovať vykonávanie jednotlivých príkazov. Ďalšie voliteľné parametre pripájacieho stringu sa týkajú optimalizácie a sú popísané v kapitole
Transakčná práca s databázou.
V prípade otvárania databázy prostredníctvom objektu typu
Databáza alebo
Tabuľka, je možné uviesť parameter
transHandle_Int. Týmto budú všetky akcie
SQL_* vykonávané v rámci určitého
pripojenia. Toto pripojenie je potrebné najprv vytvoriť akciou
DB_TRANS_OPEN.
Ak klauzula
TRANS nie je uvedená, použije sa
automatické pripojenie.
V prípade otvárania databázy prostredníctvom pripájacieho stringu (parameter
connectString), proces
D2000 DBManager vždy vytvára nové pripojenie na databázu. Ak sa v pripájacom stringu nachádza kľúčové slovo
ACD (
Auto
Commit
Disable), je v rámci nového pripojenia vypnutý režim
Auto Commit, teda je potrebné "commit" vykonať manuálne pomocou SQL príkazu
COMMIT.