Общие сведения

  1. Взаимодействие клиентского приложения с ядром СУБД ЛИНТЕР осуществляется через два класса объектов: Connection и Cursor. Объект Cursor может быть открыт только на базе объекта Connection, так как наследует параметры, необходимые для работы с базой данных (БД).

    Объект Connection предоставляет следующие методы доступа к БД:

    Метод Описание
    Create  Создать объект Connection
    Open  Открыть соединение с СУБД ЛИНТЕР
    Close  Закрыть соединение
    Free  Освободить соединение
    GetStatus  Получить статус соединения
    GetDBInfo  Получить описание параметров БД
    SQLExecuteDirect  Выполнить подготовленный SQL-запрос
    GetRowCount  Получить количество записей выборки данных
    SQLPrepare  Транслировать SQL-запрос
    GetBindParamInfo  Получить описание параметров, которые необходимо подставить в претранслированный SQL-запрос
    SQLBindParameter  Подставить параметры в претранслированный SQL-запрос
    SQLExecute  Выполнить претранслированный SQL-запрос
    GetProcOutParams  Получить выходные параметры после выполнения хранимой процедуры
    SQLFetchRow  Получить запись выборки данных в виде массива значений
    SQLFetchHash  Получить запись выборки данных в виде ассоциированного массива
    SQLFetchManyRow  Получить порцию записей выборки данных в виде массивов значений
    SQLFetchManyHash  Получить порцию записей выборки данных в виде ассоциированных массивов
    SQLNativeSql  Получить SQL-выражение с преобразованными ESC-последовательностями
    SQLTables  Получить информацию о таблицах БД
    SQLColumns  Получить информацию о столбцах таблицы
    GetAnswerInfo  Получить информацию о структуре записи выборки данных или о конкретном столбце
    GetBlob  Получить порцию BLOB-данных
    AddBlob  Добавить порцию BLOB-данных
    DelBlob  Очистить BLOB-данные
    SetOption  Установить опцию соединения/курсора
    GetLastRowId  Получить последний ROWID в заданном соединении/курсоре
    GetLastAutoInc  Получить последний AUTOINC в заданном соединении/курсоре
  2. В случае ошибки выполнение метода прекращается.

  3. С помощью функции (GetStatus) можно получить код ошибки.

    Возможные значения кодов завершения, возвращаемые методом GetStatus:

    Возвращаемое значение Описание
    0 (NORMAL)  Нормальное завершение
    Положительное Код завершения СУБД ЛИНТЕР
    Отрицательное Код ошибки Ruby-модуля
  4. Причиной прекращения выполнения метода может быть как ошибка Ruby-модуля, так и результат обработки запроса к СУБД ЛИНТЕР. Если причиной является код завершения СУБД ЛИНТЕР, то методом GetStatus возвращается положительное значение. Все остальные (отрицательные значения) относятся к кодам завершения Ruby-модуля.

  5. Коды завершения Ruby-модулей приведены в разделе «Коды завершения Ruby-интерфейса» , коды завершения СУБД ЛИНТЕР – в документе «СУБД ЛИНТЕР. Справочник кодов завершения».