English version Russian version

Свойства инициализации провайдера (Параметры строки подключения)

ado_exec_sp new! Extended Properties query_pool_size
array_type new! force_param_describe refresh_trans_level new!
array_vt_type force_prepare_stmt refresh_trans_type new!
auto_commit free_threading reset_ds_tr_rule new!
auto_commit_ddl garbage_collect role
auto_commit_ddl_level ib_tr_params__read_committed new! rowset__memory_usage new!
auto_commit_level ib_tr_params__repeatable_read new! rowset_file__sys_flags new!
auto_insert_field_rule ib_tr_params__serializable new! rowset_file__write_block_size new!
auto_param_describe icu_library new! rowset_vm_using
auto_update_field_rule ignore_err_param new! schema_cache
bicursor ignore_unprepare schema_sp_params new!
clear_param_info inner_trans std_exec_sp
cmessages Integrated Security new! stmt_cache__req_life_time new!
ctype keywords_list new! stmt_cache__size new!
ctype_none new! Location stmt_cache__time new!
ctype_user new! multi_stmts_exec_rules new! support_odbc_query
Data Source named_param_prefix support_square_delim_name new!
dbclient_library new! nested_trans new! temp_file_dir new!
dbclient_lock_rules new! num_buffers temp_stg__memory_usage new!
dbclient_type new! numeric_i2_rules new! tr_abort_flags new!
dbtime_rules new! numeric_i4_rules new! truncate_char
dbtimestamp_rules new! numeric_i8_rules new! unicode_mode
deferred_data new! odbc_call_sp unicode_stmt
deferred_out_param new! OLE DB Services User ID
dialect open_rowset__sql new! user_type_boolean new!
enable_db_triggers new! Password user_type_guid new!
enable_updatable_rowset new! Persist Security Info Window Handle
exec_sp_named_param Prompt


Синий цвет используется для обозначения обязательных свойств.
Зеленый цвет обозначает cвойства, специфические для IBProvider.


Password
Псевдонимы: PSWD
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Пароль, используемый при подключении к источнику даных

Persist Security Info
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v1, v2, v3.

Запоминание информации защиты:
True — провайдер имеет право возвращать пароль и сохранять его в файле
False — провайдер не может долговременно сохранять пароль

User ID
Псевдонимы: User
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Идентификатор пользователя.

new! Integrated Security
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Использование интегрированной аутентификации.
Пустая строка — Сервис аутентификации по-умолчанию
"SSPI" — Сервис аутентификации Microsoft Windows NT

При указании значения этого свойства, провайдер игнорирует значения User ID и Password.

Data Source
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Символьное имя базы данных. Например "Employee DB".
Если свойство Location не определено, то предполагается, что в Data Source указано расположение базы данных.

Location
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Расположение БД к которой нужно подключиться. Например:
  • d:\database\db1.gdb
  • localhost:d:\database\db1.gdb
  • sqlserver:d:\database\db1.gdb

Если значение этого свойства не определено, то предполагается, что расположение базы данных указано в свойстве Data Source.

Window Handle
Тип: VT_I4 / VT_I8
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Дескиптор родительского окна, который должен использовать провайдер, если ему нужно запросить у пользователя дополнительную информацию.

Prompt
Тип: VT_I2
R/W: R/W
По умолчанию:4
IBProvider v1, v2, v3.

Обращение к пользователю:
1 — Всегда запрашивать у пользователя данные инициализации
2 — Запрашивать, если необходима дополнительная информация
3 — Запрашивать, но не давать изменять, что уже указано
4 — Не запрашивать

Extended Properties
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Список неопознанных свойств в строке подключения.

OLE DB Services
Тип: VT_I4
R/W: R/W
По умолчанию:-1
IBProvider v1, v2, v3.

См. документацию по OLE DB

ctype
Псевдонимы: charset
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Используемая кодировка подключения. Например, win1251 или NONE.

Для IBProvider v3.
Поддерживаемые кодовые страницы:ASCII, BIG_5, CYRL, DOS437, DOS737, DOS775, DOS850, DOS852, DOS857, DOS858, DOS860, DOS861, DOS862, DOS863, DOS864, DOS865, DOS866, DOS869, EUCJ_0208, GBK, GB_2312, ISO8859_1, ISO8859_13, ISO8859_2, ISO8859_3, ISO8859_4, ISO8859_5, ISO8859_6, ISO8859_7, ISO8859_8, ISO8859_9, KOI8R, KOI8U, KSC_5601, NEXT, SJIS_0208, TIS620, UNICODE_FSS, UTF8, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, WIN1255, WIN1256, WIN1257, WIN1258, ICU-Charsets.

Допускается использование псевдонимов кодовых страниц.

См. также: ctype_user, ctype_none, icu_library, unicode_mode.

cmessages
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

См. isc_dpb_lc_message в описании IB API

role
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

Роль пользователя

num_buffers
Тип: VT_I4
R/W: R/W
По умолчанию:EMPTY
IBProvider v1, v2, v3.

См. isc_dbp_num_buffers в описании IB API

garbage_collect
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Разрешение/запрещение (true/false) сборки мусора.

dialect
Тип: VT_I4
R/W: R/W
По умолчанию:Равен диалекту БД
( См. информационное свойство провайдера IB Database Dialect)
IBProvider v1, v2, v3.

Диалект подключения к базе данных. Доступен при использовании клиентской части от IB6.

auto_commit
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v1, v2, v3.

Автоподтверждения операций.

См. свойство сессии Session AutoCommit.

auto_commit_level
Тип: VT_I4
R/W: R/W
По умолчанию:0x10000
IBProvider v1, v2, v3.

Уровень изоляции автоматических и COM+ транзакции
0x1000 — Read Commited (Cursor Stability)
0x10000 — Repeatable Read (Snapshot, Concurrency)
0x100000 — Serializable (Isolated, Consistency)

См. свойство сессии Autocommit Isolation Levels.

auto_commit_ddl
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v1, v2, v3.

Режим выполнения DDL запросов (CREATE/ALTER/DROP). Допустимые значения:
0 — Поддержка DDL запросов отключена.
1 — Выполнять DDL запрос в выделенной транзакции. Игнорируется в режиме автокоммита.
2 — Выполнять CommitRetaining после DDL запроса. Игнорируется в режиме автокоммита.

Если необходимо выполнять смешанную последовательность DDL и DML запросов, то установите данное свойство равным 1. По умолчанию (0), при использовании явного управления транзакциями (auto_commit=false) модификация метаданных будет выполняться только при коммите транзакции.

См. также: auto_commit, auto_commit_ddl_level, Session AutoCommit DDL, Session AutoCommit DDL Level.

auto_commit_ddl_level
Тип: VT_I4
R/W: R/W
По умолчанию:0x1000
IBProvider v1, v2, v3.

Уровень изоляции выделенной транзакции для выполнения DDL запросов. Допустимые значения:
0x1000 — Read Commited (Cursor Stability)
0x10000 — Repeatable Read (Snapshot, Concurrency)
0x100000 — Serializable (Isolated, Consistency)

См. также: auto_commit_ddl, Session AutoCommit DDL, Session AutoCommit DDL Level.

bicursor
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v1, v2, v3.

режим доступа к Rowset по умолчанию
False — однонаправленный
True — произвольный

free_threading
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

См. информационное свойство провайдера Data Source Object Threading

В Free IBProvider это свойство по умолчанию False. Введено из-за проблем с "Test Connection" в MSDASC.DataLinks.

array_vt_type
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Конвертация элементов массивов в VT совместимые типы.

См. свойство инициализации провайдера array_type.
См. свойство набора рядов array_vt_type.

inner_trans
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Разрешение на использование внутренних транзакций, например, для чтения метаданных. Уровень изоляции внутренней транзакции определяется auto_commit_level.

См. свойство сессии Session InnerTrans.

schema_cache
Тип: VT_I2
R/W: R/W
По умолчанию:1
IBProvider v1, v2, v3.

Кэширование метаданных
0 — Запрещено
1 — Глобальное
2 — Локальное для сессии


См. свойство сессии Session Schema Cache.

truncate_char
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Разрешение усечения хвостовых пробелов типа CHAR.

См. свойство набора рядов truncate_char.

support_odbc_query
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v1, v2, v3.

Поддержка запросов, содержащих ODBC литеры.

См. свойство набора рядов support_odbc_query.

force_prepare_stmt
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v1, v2, v3.

Принудительная подготовка запросов и формирование описаний параметров при установке текста запроса.

См. свойство набора рядов force_prepare_stmt.

unicode_mode
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Представление текстовых данных в виде UNICODE символов.

Для версий IBProvider v1/v2.
Режим UNICODE поддерживается только для следующих кодировок: NONE, UNICODE_FSS, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, DOS437, DOS850, DOS852, DOS857, DOS860, DOS861, DOS863, DOS865, CYRL. Выделенные кодовые страницы конвертируются в UNICODE провайдером самостоятельно. Остальные - посредством MultiByteToWideChar/WideCharToMultiByte. Если unicode_mode установлено в false, то за корректность конвертации текста отвечает клиент. Не рекомендуется изменять это свойство.

Для IBProvider v3.
Этот провайдер имеет поддержку UNICODE режима для всех кодовых страниц и дополнительное свойство инициализации ctype_user. Вы можете менять значение этого свойства без каких либо проблем.

См. свойство инициализации провайдера ctype_user.

unicode_stmt
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Транслирование текста SQL-запроса из UNICODE.
True — C использованием кодовой страницы подключения.
False — C использованием текущей кодовой страницы ОС (CP_ACP).

std_exec_sp
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Способ интерпретации запроса "exec SP".

См. свойство набора рядов std_exec_sp.

odbc_call_sp
Тип: VT_I4
R/W: R/W
По умолчанию:
ibp v1/v2 — 0
ibp v3 — 2
IBProvider v1, v2, v3.

Способ интерпретации ODBC-запросов на выполнение хранимой процедуры.

См. свойство набора рядов odbc_call_sp.

clear_param_info
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Разрешение очищать список описаний параметров при установке в команду нового текста запроса. Если клиент сначала устанавливает описания параметров, а потом текст запроса - то описания будут потеряны. В этом случае могут возникнуть или ошибка выполнения команды, или дополнительные расходы на автоматическое формирование списка описаний параметров.

См. свойство инициализации провайдера auto_param_describe.
См. свойство набора рядов clear_param_info.

auto_param_describe
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Если при выполнении параметризованного запроса пользователь не установил описания параметров, то провайдер автоматически сформирует их, выполнив запрос к серверу. См. свойство набора рядов auto_param_describe

force_param_describe
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Неявное получение описаний параметров и их использование для передачи значений параметров с теми типами, которые ожидает сервер базы данных. См. свойство набора рядов force_param_describe

named_param_prefix
Тип: VT_BSTR
R/W: R/W
По умолчанию:":"
IBProvider v1, v2, v3.

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

query_pool_size
Тип: VT_I2
R/W: R/W
По умолчанию:0
IBProvider v2, v3.

Максимальное количество подготовленных запросов используемых обновляемым набором рядов для записи изменений в базу данных. См. свойство набора рядов query_pool_size

auto_insert_field_rule
Тип: VT_I2
R/W: R/W
По умолчанию:0
IBProvider v2, v3.

Правило генерации SQL-запроса для вставки нового ряда в таблицу базы данных. См. свойство набора рядов auto_insert_field_rule

auto_update_field_rule
Тип: VT_I2
R/W: R/W
По умолчанию:0
IBProvider v2, v3.

Правило генерации SQL-запроса на модификацию ряда в таблице базы данных. См. свойство набора рядов auto_update_field_rule

ignore_unprepare
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v1, v2, v3.

Разрешение на игнорирование команды UnPrepare SQL-запроса. См. свойство набора рядов ignore_unprepare

rowset_vm_using
Тип: VT_I4
R/W: R/W
По умолчанию:-1
IBProvider v1, v2, v3.

Объем памяти в килобайтах под кэш результирующего множества, начиная с которого будет использоваться менеджер памяти на базе VirtualAlloc/VirtualFree и SEH. При отрицательном значении этого свойства будет всегда использоваться менеджер памяти на базе HeapAlloc/HeapFree.

Использование менеджера на базе VirtualAlloc/VirtualFree и SEH позволяет более эффективно использовать память процесса и уменьшает её дефрагментацию.

Для работы с провайдером из под отладчиков Delphi, BCB, Visual Studio необходимо отключить обработку исключения Access Violation или добавить в строку подключения rowset_vm_using=-1.

См. также: свойство набора рядов rowset_vm_using, Memory Usage.

new! dbclient_type
Тип: VT_BSTR
R/W: R/W
По умолчанию:ib
IBProvider v3.

Тип клиента сервера базы данных. Допустимые значения:
ib — Клиент к Interbase 4/5/6. Библиотека по умолчанию - gds32.dll
fb — Клиент Firebird v1. Библиотека по умолчанию - gds32.dll
fb1.5 — Клиент Firebird v1.5. Библиотека по умолчанию - fbclient.dll

Изменить значение по умолчанию можно, указав допустимое значение в параметре реестра:
HKEY_CLASSES_ROOT\CLSID\{769A1280-04BF-11D8-AE8B-00A0C907DB93}\def_dbclient_type

См. также: dbclient_library, dbclient_lock_rules

new! dbclient_library
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

DLL с серверным клиентом.

См. также: dbclient_type, dbclient_lock_rules

new! nested_trans
Тип: VT_BOOL
R/W: R/W
По умолчанию:false
IBProvider v3.

Разрешение/Запрещение вложенных транзакций.

new! schema_sp_params
Тип: VT_I4
R/W: R/W
По умолчанию:2
IBProvider v3.

Определяет режимы формирования схем PROCEDURE_PARAMETERS, PROCEDURE_COLUMNS. Возможные значения:
0 — Все OUT-параметры хранимых процедур публикуются в схеме PROCEDURE_COLUMNS.
1 — Все OUT-параметры хранимых процедур публикуются в PROCEDURE_PARAMETERS вместе с IN-параметрами. Это текущая реализация провайдеров v1 и v2.
2 — Провайдер самостоятельно определяет какие хранимые процедуры возвращают множества (в этом случае OUT-параметры попадают в PROCEDURE_COLUMNS), а какие возвращают OUT-параметры (OUT-параметры попадают в PROCEDURE_PARAMETERS).

new! ado_exec_sp
Тип: VT_I4
R/W: R/W
По умолчанию:2
IBProvider v3.

Способ интерпретации запроса "exec SP". Допустимые значения:
0 — Трансляция запроса "exec SP" в "select * from SP"
1 — Трансляция запроса "exec SP" в "execute procedure SP"
2 — Провайдер самостоятельно определяет способ запуска хранимой процедуры

Это свойство замещает устаревшее свойство std_exec_sp

См. свойство набора рядов ado_exec_sp

exec_sp_named_param
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v1, v2, v3.

Способ представления параметров при трансляции запроса "exec SP". Допустимые значения:
True — Трансляция в запрос с именованными параметрами: "execute procedure SP (:param1, param2 ...)".
False — Трансляция в запрос с неименованными параметрами: "execute procedure SP (?,? ...)".

См. свойство набора рядов exec_sp_named_param.

new! ignore_err_param
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v1, v2, v3.

Битовая маска игнорирования ошибок в параметрах команды.
1 — Игнорировать IN-параметр с неизвестным именем.
2 — Игнорировать IN-параметр с некорректным порядковым номером

См. свойство набора рядов ignore_err_param

new! support_square_delim_name
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v1, v2, v3.

Поддержка имен объектов БД в квадратных скобках
0 — Поддержка отключена.
1 — Обрабатываются все квадратные скобки.
2 — [v3] Парсер пытается различать имена объектов и индексы массивов.

Парсер квадратных скобок игнорирует комментарии и текстовые значения

См. свойство набора рядов support_square_delim_name

new! keywords_list
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Режим формирования списка ключевых слов, возвращаемого IDBInfo::GetKeywords
0 — Согласно стандарту OLEDB.
1 — Включать в список все зарезервированные ключевые слова.

new! tr_abort_flags
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Битовая маска режимов отката транзакций
1 — Откат неактивной транзакции без ошибок.

См. свойство сессии Session Transaction Abort Flags

new! enable_db_triggers
Тип: VT_BOOL
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Разрешение или запрещение триггеров уровня базы данных (FB2.1). Требуется клиент сервера Firebird.

new! array_type
Тип: VT_I4
R/W: R/W
По умолчанию:1
IBProvider v3.

Правила представления колонок и параметров, содержащих массивы
0 — Колонки и параметры с оригинальным типом элементов массива.
1 — Используется VARIANT-совместимый тип элементов массива.
2 — Используется массив вариантов. VBScript-совместимый режим.
17 — Подобно "1", но массив будет помещен в VARIANT.
18 — Подобно "2", но массив будет помещен в VARIANT. VBScript-совместимый режим.

Это свойство замещает array_vt_type

См. свойство набора рядов array_type

new! reset_ds_tr_rule
Тип: VT_I4
R/W: R/W
По умолчанию:1
IBProvider v1, v2, v3.

Правило повторного использования источника данных с активной транзакцией.
0 — Состояние транзакции игнорируется.
1 — Отказ в повторном использовании источника данных.
2 — Отключение от транзакции. Для активной транзакции будет выполнен rollback.

new! numeric_i2_rules
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Правила для NUMERIC-колонок с точностью 1..4. Ноль или комбинация следующих флагов
1 — NUMERIC с нулевым масштабом иметь тип DBTYPE_I2.
2 — Точность NUMERIC будет равна 5 вместо 4.

Если у вас появились проблемы с NUMERIC и MSSQL (связанный сервер), укажите в строке подключения numeric_i2_rules=2.

См. также: numeric_i4_rules, numeric_i8_rules.

new! numeric_i4_rules
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Правила для NUMERIC-колонок с точностью 5..9. Ноль или комбинация следующих флагов
1 — NUMERIC с нулевым масштабом иметь тип DBTYPE_I4.
2 — Точность NUMERIC будет равна 10 вместо 9.

Если у вас появились проблемы с NUMERIC и MSSQL (связанный сервер), укажите в строке подключения numeric_i4_rules=2.

См. также: numeric_i2_rules, numeric_i8_rules.

new! numeric_i8_rules
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Правила для NUMERIC-колонок с точностью 10..18. Ноль или комбинация следующих флагов
1 — NUMERIC с нулевым масштабом иметь тип DBTYPE_I8.
2 — Точность NUMERIC будет равна 19 вместо 18.

Если у вас появились проблемы с NUMERIC и MSSQL (связанный сервер), укажите в строке подключения numeric_i8_rules=2.

См. также: numeric_i2_rules, numeric_i4_rules.

new! icu_library
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Путь к DLL с кодовыми страницами ICU. DLL можно взять из поставки FB 2.1 - icuuc30.dll. Эта DLL использует вспомогательный модуль - icudt30.dll.

Для 32-битного провайдера следует использовать 32-битные ICU-DLL.
Для 64-битного провайдера следует использовать 64-битные ICU-DLL.

new! dbclient_lock_rules
Тип: VT_I4
R/W: R/W
По умолчанию:1
IBProvider v3.

Правила блокировки клиента базы данных (gds32.dll, fbclient.dll) в памяти.
0 — Выгружать DLL клиента после каждого отключения от базы данных.
1 — Выгружать DLL клиента вместе c DLL провайдера.
2 — Не выгружать DLL клиента.

Внимание. fbclient.dll 1.5.x-2.1.x имеют утечку памяти в коде завершения работы.

См. также: dbclient_library

new! ctype_user
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Кодовая страница пользователя. Провайдер осуществляет трансляцию текстовых данных (колонки, блобы, массивы) между кодовой страницей пользователя и кодовой страницей подключения (ctype). Специальные значения:
NONE — По-умолчанию. Пользовательская кодовая страница совпадает с кодовой страницей подключения.
ACP — Текущая ANSI кодовая страница операционной системы.
OCP — Текущая OEM кодовая страница операционной системы.

Поддерживаемые кодовые страницы:ASCII, BIG_5, CYRL, DOS437, DOS737, DOS775, DOS850, DOS852, DOS857, DOS858, DOS860, DOS861, DOS862, DOS863, DOS864, DOS865, DOS866, DOS869, EUCJ_0208, GBK, GB_2312, ISO8859_1, ISO8859_13, ISO8859_2, ISO8859_3, ISO8859_4, ISO8859_5, ISO8859_6, ISO8859_7, ISO8859_8, ISO8859_9, KOI8R, KOI8U, KSC_5601, NEXT, SJIS_0208, TIS620, UNICODE_FSS, UTF8, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, WIN1255, WIN1256, WIN1257, WIN1258, ICU-Charsets.

Допускается использование псевдонимов кодовых страниц.

См. также: ctype, ctype_none, icu_library.

new! ctype_none
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Кодовая страница для интерпретации NONE. Специальные значения:
NONE — По-умолчанию.
ACP — Текущая ANSI кодовая страница операционной системы.
OCP — Текущая OEM кодовая страница операционной системы.

Поддерживаемые кодовые страницы:ASCII, BIG_5, CYRL, DOS437, DOS737, DOS775, DOS850, DOS852, DOS857, DOS858, DOS860, DOS861, DOS862, DOS863, DOS864, DOS865, DOS866, DOS869, EUCJ_0208, GBK, GB_2312, ISO8859_1, ISO8859_13, ISO8859_2, ISO8859_3, ISO8859_4, ISO8859_5, ISO8859_6, ISO8859_7, ISO8859_8, ISO8859_9, KOI8R, KOI8U, KSC_5601, NEXT, SJIS_0208, TIS620, UNICODE_FSS, UTF8, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, WIN1255, WIN1256, WIN1257, WIN1258, ICU-Charsets.

Допускается использование псевдонимов кодовых страниц.

См. также: ctype, ctype_user, icu_library.

new! user_type_boolean
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

В свойстве указывается маска домена, которая определяет какие данные следует интерпретировать как Boolean. В маске поддерживаются символы «*» и «?». Маска чувствительна к регистру. Домен в котором хранится эмулируемый тип Boolean должен базироваться на типе SMALLINT.

Эмуляция типа Boolean работает для:
  • Колонок с простым типом;
  • Колонок с массивами;
  • OUT-параметров с простым типом;
  • OUT-параметров с массивами;
  • IN-параметров с массивами.
Из-за ограничений ISC API (IB/FB), при использовании простых типов для входящих параметров команд, необходимо явно указывать тип параметра. Для колонок с массивами поддерживается автоматическое формирование описания параметра.

Эмуляция типов распространяется и на схемы метаданных. Провайдер обеспечивает согласованность типов, которые читаются при выполнении запросов и типов, которые отображаются в схемах COLUMNS, PROCEDURE_PARAMETERS, PROCEDURE_COLUMNS.

Пример использования эмуляции типа Boolean на .Net Framework: эмуляция Boolean и Guid в Firebird and Interbase.

new! user_type_guid
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

В свойстве указывается маска домена, которая определяет какие данные следует интерпретировать как GUID. В маске поддерживаются символы «*» и «?». Маска чувствительна к регистру. Домен в котором хранится эмулируемый тип Guid должен базироваться на типе CHAR(16) с кодовой страницей OCTETS.

Эмуляция типа Boolean работает для:
  • Колонок с простым типом;
  • Колонок с массивами;
  • OUT-параметров с простым типом;
  • OUT-параметров с массивами;
  • IN-параметров с массивами.
Из-за ограничений ISC API (IB/FB), при использовании простых типов для входящих параметров команд, необходимо явно указывать тип параметра. Для колонок с массивами поддерживается автоматическое формирование описания параметра.

Эмуляция типов распространяется и на схемы метаданных. Провайдер обеспечивает согласованность типов, которые читаются при выполнении запросов и типов, которые отображаются в схемах COLUMNS, PROCEDURE_PARAMETERS, PROCEDURE_COLUMNS.

Пример использования эмуляции типа Boolean на .Net Framework: эмуляция Boolean и Guid в Firebird and Interbase.

new! stmt_cache__time
Тип: VT_I4
R/W: R/W
По умолчанию:60
IBProvider v3.

Минимальное время жизни инициализированного или подготовленного запроса в секундах.
Любой запрос, находящийся в пуле больше чем stmt_cache__time секунд будет удален.
  • Нулевое значение запрещает пул запросов.
  • Отрицательное значение означает, что параметр не учитывается.
Подробнее о пуле запросов читайте в новостях: пул запросов.

new! stmt_cache__req_life_time
Тип: VT_I4
R/W: R/W
По умолчанию:30
IBProvider v3.

Минимальное время жизни подготовленного запроса. Если в пул попадает подготовленный запрос, то в течении указанного времени он не будет задействован под другой запрос.
Отрицательное значение означает, что все запросы кэшируются и не будут переподготовлены.

Подробнее о пуле запросов читайте в новостях: пул запросов.

new! stmt_cache__size
Тип: VT_I4
R/W: R/W
По умолчанию:1024
IBProvider v3.

Максимальное количество ресурсов в пуле запросов. При превышении указанного значения, провайдер начинает удалять старые запросы.
Отрицательное значение означает, что параметр не учитывается.

Подробнее о пуле запросов читайте в новостях: пул запросов.

new! temp_file_dir
Тип: VT_BSTR
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Каталог для временных файлов провайдера. По-умолчанию используется каталог временных файлов, определенный в переменных окружения TMP/TEMP пользователя.

new! rowset_file__sys_flags
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Системные флаги временного файла набора рядов с результирующим множеством. Может быть нулем или комбинацией следующих флагов:
1 — Использовать флаг WIN32::FILE_FLAG_NO_BUFFERING.
2 — Использовать флаг WIN32::FILE_FLAG_WRITE_THROUGH.

См. также: свойство набора рядов rowset_file__sys_flags.

new! rowset_file__write_block_size
Тип: VT_I4
R/W: R/W
По умолчанию:EMPTY
IBProvider v3.

Размер блока в килобайтах для выгрузки модифицированных данных из кэша во временный файл.

См. также: свойство набора рядов rowset_file__write_block_size.

new! rowset__memory_usage
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Объем памяти, который может использовать результирующее множество:
0 — Определяется автоматически.
1..99 — Не более указанного процента доступной памяти.
>100 — Не более указанного объема в Кб.

См. также: rowset_vm_using, свойство набора рядов Memory Usage.

new! enable_updatable_rowset
Тип: VT_BOOL
R/W: R/W
По умолчанию:True
IBProvider v3.

Поддержка обновляемых множеств

new! dbtime_rules
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Правила для колонок и параметров с типом TIME. Допускаются следующие значения:
0 — Данные имеют тип DBTYPE_DBTIME.
1 — Данные имеют тип DBTYPE_DBTIME2.
2 — Данные имеют тип DBTYPE_WSTR.

См. также: dbtimestamp_rules

new! dbtimestamp_rules
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Правила для колонок и параметров с типом TIMESTAMP. Допускаются следующие значения:
0 — Данные имеют тип DBTYPE_DBTIMESTAMP.
2 — Данные имеют тип DBTYPE_WSTR.

См. также: dbtime_rules

new! multi_stmts_exec_rules
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Правила выполнения нескольких запросов в тексте одной команды. Допускаются следующие значения:
0 — Останавливаться при получении ошибки выполнения одного из запросов.
1 — Продолжать выполнение после ошибки выполнения одного из запросов.

См. также: multi_stmts_exec_rules

new! temp_stg__memory_usage
Тип: VT_I4
R/W: R/W
По умолчанию:0
IBProvider v3.

Объем памяти, под кэш хранилища временных данных:
0 — Определяется автоматически.
1..99 — Не более указанного процента доступной памяти.
>100 — Не более указанного объема в Кб.

Хранилище временных данных используется, например, для OUT-параметров с блобами.

См. также: temp_file_dir

new! deferred_data
Тип: VT_I4
R/W: R/W
По умолчанию:3
IBProvider v3.

Настройка отложенного чтения значений колонок (блобы, массивы). Допускается комбинация следующих флагов:
1 — Разрешение отложенного чтения в случае явной транзакции.
2 — Разрешение отложенного чтения в случае автоматической транзакции.

См. также: deferred_data

new! deferred_out_param
Тип: VT_I4
R/W: R/W
По умолчанию:1
IBProvider v3.

Настройка отложенного чтения значений OUT-параметров (блобы). Допускается комбинация следующих флагов:
1 — Разрешение отложенного чтения в случае явной транзакции.
2 — Разрешение отложенного чтения в случае автоматической транзакции.

См. также: deferred_out_param, temp_stg__memory_usage.

new! refresh_trans_type
Тип: VT_I2
R/W: R/W
По умолчанию:0
IBProvider v3.

Определение транзакции, используемой для операции перечитывания данных набора рядов. Допустимыми значениями являются:
0 — Если для чтения данных набора рядов используется автоматическая транзакция, то для перечитывания будет использоваться отдельная короткая транзакция (см.2). Если пользователь явно стартовал транзакцию на выборку данных, то именно она и будет использоваться для перечитывания данных (см.1).
1 — Использование основной транзакции, в которой производится выборка данных.
2 — Использование отдельной короткой транзакции.

См. также: refresh_trans_level, refresh_trans_type.

new! refresh_trans_level
Тип: VT_I4
R/W: R/W
По умолчанию:0x10000 (repeatable read)
IBProvider v3.

Уровень изоляции отдельной транзакции, в которой производится перечитывание данных набора рядов. Допустимые значения совпадают со значениями свойства auto_commit_level.

См. также: refresh_trans_type, refresh_trans_level.

new! ib_tr_params__read_committed
Тип: VT_BSTR
R/W: R/W
По умолчанию:write read_committed rec_version nowait
IBProvider v3.

Параметры для уровня изоляции READ COMMITTED.

См. также: ib_tr_params__repeatable_read, ib_tr_params__serializable.

new! ib_tr_params__repeatable_read
Тип: VT_BSTR
R/W: R/W
По умолчанию:write concurrency nowait
IBProvider v3.

Параметры для уровня изоляции REPEATABLE READ.

См. также: ib_tr_params__read_committed, ib_tr_params__serializable.

new! ib_tr_params__serializable
Тип: VT_BSTR
R/W: R/W
По умолчанию:write consistency nowait
IBProvider v3.

Параметры для уровня изоляции SERIALIZABLE.

См. также: ib_tr_params__read_committed, ib_tr_params__repeatable_read.

new! open_rowset__sql
Тип: VT_BOOL
R/W: R/W
По умолчанию:False
IBProvider v3.

Разрешение выполнения запросов через IOpenRowset::OpenRowset. Используется, к примеру, при работе с MS DTS, SSIS.



Назад Вперед