Общие сведения об использовании SQL Gateway

Общая схема сессии SQL Gateway такова:
1.	Устанавливается соединение с источником данных ODBC и открывается handle соединения, 
2.	Создаются и подготавливаются один или более statement handle, 
3.	Выполняется (один или более) запросов (команд) к базе данных,
4.	Удаляются данные, использованные для соединения,
5.	Закрывается соединение

Одновременно может быть открыто несколько сессий, однако все они организуются по 
описанной схеме.
Каждый из описанных этапов основывается на предыдущем. Так, когда вы устанавливаете 
соединение с источником данных, вы обращаетесь непосредственно к функции Gateway DLL, 
которая возвращает handle соединения. Затем, при подготовке команды (statement), вы
 используете handle соединения в качестве одного из параметров функции DLL, которая 
возвращает handle команды (statement).

Если вы уже знакомы с ODBC API, то наверняка обратите внимание на то, что функции  SQL 
Gateway API во многом соответствуют функциям ODBC API. Это действительно так. Фактически, 
SQL Gateway является переходным модулем, позволяющим COS-программе обращаться к ODBC API 
посредством вызова внешних функций, представленных в CGATE.DLL. Поэтому принципы работы 
определяются ODBC API и в случае недостатка информации или возникновения каких-либо 
вопросов часто бывает очень полезно ознакомиться с ODBC Programmer's Reference в MSDN или 
подобной документации.
Еще раз повторю описание сессии SQL Gateway, используя на этот раз названия функций:
-	Connect или DSNConnect – выполнение соединения
-	AllocStatement – создание новой команды
-	Prepare (а также Tables, Columns и др.) – подготовка команды
-	BindParameters, SetParameter – подготовка параметров, если надо
-	Execute – исполнение команды
-	Fetch, FetchRows, GetData, GetOneRow – получение данных
-	GetParameter – получение возвращаемых значений, если есть
-	UnBindParameter – освобождение памяти, занятой параметрами
-	DropStatement – удаление команды
-	Disconnect – разрыв соединения

Перечисленные функции являются, на мой взгляд, самыми важными, поэтому на них в дальнейшем 
следует обратить особое внимание. Еще раз подчеркиваю, что практически все функции SQL 
Gateway API оформлены в виде методов класса %SQLGatewayConnection, иногда, правда, с 
легкими отличиями в названиях или (почему-то) в порядке аргументов.