ЛИНТЕР

Установить опцию соединения (курсора)

Назначение

Метод SetOption устанавливает опцию объекта Connection или Cursor.

Синтаксис

value {< объект Connect > | < объект Cursor >}.SetOption(Option, Value)

Option: Идентификатор устанавливаемой опции (таблица 1).
Value: Значение опции.

Таблица 1. Возможные значения параметра Option

Опция	Значение опции	Описание
`FETCH_BLOB_MODE`	`true`\|`false`	Разрешает (`true`) или запрещает (`false`) вывод BLOB-данных в методах `SQLFetchRow`, `SQLFetchHash`, `SQLFetchManyRow`, `SQLFetchManyHash`. По умолчанию BLOB-данные выводятся. Опция применима к объектам `Connection`, `Cursor`.
`CHANNEL_PRIORITY`	Целочисленное значение в диапазоне 0-255	Задает приоритет канала. По умолчанию приоритет канала равен нулю. Опция применима к объектам `Connection`, `Cursor`.
`DATE_FORMAT`	Символьный литерал	Задает формат представления значений типа «дата-время» в записях выборки данных. Если формат явно не установлен, то по умолчанию используется “DD-Mon-YYYY:HH24:MI:SS”. Допустимые форматы описаны в документе «Справочник по SQL», функция `to_char()`. Опция применима к объектам `Connection`, `Cursor`.
`SET_SAVE_POINT`	Символьное значение	Устанавливает точку сохранения в текущей транзакции. Опция применима к объектам `Connection`, `Cursor`.
`SET_CURSOR_NAME`	Символьное значение (до 66 символов)	Задает имя курсора, используемого для команд позиционного обновления и удаления (`WHERE CURRENT OF`). Подробнее см. документы «Интерфейс нижнего уровня» и «Справочник по SQL». Опция применима только к объекту `Cursor`.

Возвращаемое значение

Объект Connection.

Пример

require "LinRuby"

begin
  connect = LinterConnection.Create()
  connect.Open("SYSTEM", "MANAGER8", nil, M_EXCLUSIVE | Q_ENCODE)
  puts "connection to RDBMS Linter is successed"
  connect.SQLExecuteDirect("update PERSON set FIRSTNAM='Nicolas' where rowid = 1;")
  connect.SetOption(SET_SAVE_POINT, "1")
  puts "savepoint has set"
rescue = > error
  puts error
ensure
  if connect != nil
    connect.Close()
  end
end

См. также пример demo29.rb в подкаталоге samples/ruby установочного каталога СУБД ЛИНТЕР.