Доступные версии документации

Структура LinAPI

В LinAPI имеются три типа объектов, позволяющих работать с базой данных (БД):

  • соединения (Connections);

  • курсоры (Cursors);

  • операторы (Statements).

Соединение (Connection)

Функция LINTER_Connect устанавливает соединение с ЛИНТЕР-сервером. При создании соединения открывается один канал связи с ЛИНТЕР-сервером. Создав соединение, приложение получает доступ к БД, с которой в данный момент работает ЛИНТЕР-сервер.

Одно приложение может установить несколько соединений как с одним, так и с разными ЛИНТЕР-серверами.

Курсор (Cursor)

Функция LINTER_OpenCursor открывает курсор для указанного соединения. Курсор – это средство выполнения запросов и/или операторов. При открытии курсора открывается канал связи с ЛИНТЕР-сервером.

Этот канал является дочерним (подчиненным) каналом по отношению к соединению, для которого открывается курсор.

Таким образом, под курсором понимается некоторая область данных, описывающая состояние выполнения запроса или оператора. С одним курсором могут быть связаны несколько операторов, но курсор будет содержать состояние того запроса или оператора, который был выполнен последним.

Оператор (Statement)

Функция LINTER_CreateStatement создает оператор, который является результатом трансляции SQL-запроса. Операция трансляции проводится по каналу, открытому при создании соединения.

Запрос, поданный на трансляцию, может содержать параметры. Параметры можно рассматривать как переменные, значения которых можно изменять. Чтобы подставить в оператор конкретное значение параметра, необходимо произвести привязку буфера параметра, в который помещается значение, к оператору.

Создавать оператор имеет смысл тогда, когда предполагается его многократное выполнение или использование параметров.

Один и тот же оператор может быть связан с несколькими курсорами, относящимися к соединению, по которому был создан оператор.

Связывание курсора и оператора происходит при привязке буфера параметра запроса и при привязке буфера поля ответа.

Эта связь пассивна и активизируется только при выполнении оператора.

Каждый из описанных объектов имеет набор свойств – характеристик, по которым можно судить о его состоянии или изменять это состояние.

Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter