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

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

Назначение
 

Метод 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", "MANAGER", 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 установочного каталога СУБД ЛИНТЕР.

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