21.1.4.2. Параметры Соединения соединителя/ODBC

Можно определить параметры в следующих таблицах для Соединителя/ODBC, конфигурируя DSN:

Пользователи на Windows могут использовать панели Options и Advanced, конфигурируя DSN, чтобы установить эти параметры; см. таблицу для информации, на которой опции касаются который поля и флажки. На Unix и Mac OS X, используйте название параметра и значение как пара ключевого слова/значения в конфигурации DSN. Альтернативно, можно установить эти параметры в пределах InConnectionString параметр в SQLDriverConnect() вызвать.

Таблица 21.3. Соединитель/ODBC Параметры конфигурации DSN

Параметр	Значение по умолчанию	Комментарий
`user`	ODBC	Имя пользователя, используемое, чтобы соединиться с MySQL.
`uid`	ODBC	Синонимичный с `user`. Добавленный в 3.51.16.
`server`	`localhost`	Имя хоста сервера MySQL.
`database`		База данных значения по умолчанию.
`option`	0	Опции, которые определяют, как Соединитель/ODBC работает. См. Таблицу 21.4, "Флаги Опции Соединителя/ODBC" и Таблица 21.5, "Рекомендуемый Значения опции Connector/ODBC для Различных Конфигураций".
`port`	3306	Порт TCP/IP, чтобы использовать, если `server` не `localhost`.
`initstmt`		Начальный оператор. Оператор, чтобы выполниться, соединяясь с MySQL. В версии 3.51 вызывают параметр `stmt`. Отметьте, драйвер поддерживает начальный оператор, выполняемый только во время начального соединения.
`password`		Пароль для `user` учетная запись на `server`.
`pwd`		Синонимичный с `password`. Добавленный в 3.51.16.
`socket`		Файл сокета Unix или именованный канал Windows, чтобы соединиться, к если `server` `localhost`.
`sslca`		Путь к файлу со списком доверительной АВАРИИ SSL. Добавленный в 3.51.16.
`sslcapath`		Путь к каталогу, который содержит доверяемые сертификаты CA SSL в формате PEM. Добавленный в 3.51.16.
`sslcert`		Имя файла сертификата SSL, чтобы использовать для того, чтобы установить безопасное соединение. Добавленный в 3.51.16.
`sslcipher`		Список допустимых шифров, чтобы использовать для шифрования SSL. У списка шифра есть тот же самый формат как `openssl ciphers` команда. Добавленный в 3.51.16.
`sslkey`		Имя файла ключей SSL, чтобы использовать для того, чтобы установить безопасное соединение. Добавленный в 3.51.16.
`charset`		Набор символов, чтобы использовать для соединения. Добавленный в 3.51.17.
`sslverify`		Если установлено в 1, сертификат SSL будет проверен когда использующийся с соединением MySQL. Если не набор, то поведение значения по умолчанию должно проигнорировать проверку сертификата SSL.
`readtimeout`		Тайм-аут в секундах для попыток читать из сервера. Каждая попытка использует это значение тайм-аута и в случае необходимости есть повторения, таким образом, полное эффективное значение тайм-аута является три раза значением опции. Можно установить значение так, чтобы потерянное соединение могло быть обнаружено ранее чем TCP/IP `Close_Wait_Timeout` значение 10 минут. Эта опция работает только на соединения TCP/IP, и только на Windows до MySQL 5.1.12. Соответствует `MYSQL_OPT_READ_TIMEOUT` опция MySQL Client Library. Добавленный в 3.51.27.
`writetimeout`		Тайм-аут в секундах для попыток записать в сервер. Каждая попытка использует это значение тайм-аута и есть `net_retry_count` повторения в случае необходимости, таким образом, полное эффективное значение тайм-аута `net_retry_count` времена значение опции. Эта опция работает только на соединения TCP/IP, и только на Windows до MySQL 5.1.12. Соответствует `MYSQL_OPT_WRITE_TIMEOUT` опция MySQL Client Library. Добавленный в 3.51.27.
`interactive`		Включает `CLIENT_INTERACTIVE` опция соединения `mysql_real_connect`.
`prefetch`	0	Когда установлено в ненулевое значение `N`, причины все запросы в соединении с возвратом `N` строки за один раз, а не весь набор результатов. Полезный для запросов против очень больших таблиц, где это не практично, чтобы получить целый набор результатов сразу. Можно просмотреть набор результатов путем прокрутки, `N` записи за один раз. Эта опция работает только с однонаправленными курсорами. Это не работает когда `FLAG_MULTI_STATEMENTS` флаг устанавливается. Это может использоваться в комбинации с `FLAG_NO_CACHE` опция. Его поведение в приложениях ADO неопределено: упреждающая выборка могла бы или не могла бы произойти.
`no_ssps`	0	В Соединителе/ODBC 5.2, по умолчанию, сторона сервера используются подготовленные операторы. Когда эта опция устанавливается в ненулевое значение, готовые операторы эмулируются на стороне клиента, которая является тем же самым поведением как в 5.1 и 3.51. Добавленный в 5.2.
`can_handle_exp_pwd`	0	Указывает, что приложение может иметь дело с паролем с истекшим сроком, который сообщается состоянием SQL `08004` ("Сервер, отклоненный соединение") и собственный код ошибки `ER_MUST_CHANGE_PASSWORD_LOGIN` (1862). Соединение является "sandboxed", и ничего не может сделать кроме проблемы a `SET PASSWORD` оператор. Чтобы установить соединение в этом случае, Ваше приложение должно или использовать `initstmt` опция соединения, чтобы установить новый пароль в запуске, или проблему a `SET PASSWORD` оператор сразу после соединения. Как только пароль с истекшим сроком сбрасывается, ограничения на соединение снимаются. См. Раздел 13.7.1.1,"`ALTER USER` Синтаксис" для деталей о passwordexpiration для учетных записей сервера MySQL. Добавленный в 5.2.4.

Отметить

Параметры конфигурации SSL могут также быть автоматически загружены из a my.ini или my.cnf файл. См. Раздел 4.2.3.3, "Используя Файлы Опции".

option параметр используется, чтобы сказать Соединителю/ODBC, что клиент не на 100 % совместим ODBC. На Windows Вы обычно выбираете опции, переключая флажки в экране соединения, но можно также выбрать их в option параметр. Следующие опции перечисляются в порядке, в котором они появляются в Соединителе/ODBC, соединяют экран.

Таблица 21.4. Флаги Опции соединителя/ODBC

Имя флага	Опция GUI	Постоянная величина	Описание
`FLAG_FIELD_LENGTH`	Не Оптимизируйте Ширину столбца		Клиент не может обработать тот Соединитель/ODBC возвраты реальный width столбца. Эта опция была удалена в 3.51.18.
`FLAG_FOUND_ROWS`	Возвратите Соответствие Строк	2	Клиент не может обработать тот MySQL возвраты истинное значение строк, на которые влияют. Если этот флаг устанавливается, возвраты MySQL, "найденные строками" вместо этого. У Вас должно быть MySQL 3.21.14 или более новый для этого, чтобы работать.
`FLAG_DEBUG`	Драйвер трассировки Призывает myodbc.log		Заставьте отладку войти в систему `C:\myodbc.log` на Windows, или `/tmp/myodbc.log` на разновидностях Unix. Эта опция была удалена в Соединителе/ODBC 3.51.18.
`FLAG_BIG_PACKETS`	Позвольте Большие Результаты	8	Не устанавливайте пакетный предел для результатов и связывайте параметры. Без этой опции привязка параметров будет усеченной к 255 символам.
`FLAG_NO_PROMPT`	Не Запрашивайте На, Соединяются	16	Не запрашивайте вопросы, даже если драйвер хотел бы запросить.
`FLAG_DYNAMIC_CURSOR`	Включите Динамическому курсору	32	Включите или отключите поддержку динамического курсора.
`FLAG_NO_SCHEMA`	Проигнорируйте # в Имени таблицы	64	Проигнорируйте использование имени базы данных в `db_name.tbl_name.col_name`.
`FLAG_NO_DEFAULT_CURSOR`	Курсоры Диспетчера пользователей	128	Использование силы менеджера по ODBC (экспериментальные) курсоры.
`FLAG_NO_LOCALE`	Не Используйте Локаль Набора	256	Отключите использование расширенной (экспериментальной) выборки.
`FLAG_PAD_SPACE`	Случайная работа клавиатуры К Полному	512	Клавиатура `CHAR` столбцы к полной длине столбца.
`FLAG_FULL_COLUMN_NAMES`	Возвратите Имена таблиц для SQLDescribeCol	1024	`SQLDescribeCol()` возвраты полностью определенные имена столбцов.
`FLAG_COMPRESSED_PROTO`	Используйте Сжатый Протокол	2048	Используйте сжатый клиент-серверный протокол.
`FLAG_IGNORE_SPACE`	Проигнорируйте Пространство После Имен функций	4096	Скажите серверу игнорировать пространство после имени функции и прежде"`(`"(необходимый PowerBuilder). Это делает все ключевые слова имен функций.
`FLAG_NAMED_PIPE`	Использование силы Именованных каналов	8192	Соединитесь с именованными каналами с mysqld сервером, работающим на NT.
`FLAG_NO_BIGINT`	Измените Столбцы BIGINT на Интервал	16384	Изменение `BIGINT` столбцы к `INT` столбцы (некоторые приложения не могут обработать `BIGINT`).
`FLAG_NO_CATALOG`	Никакой Каталог	32768	Силы следуют из функций каталога, такой как `SQLTables`, всегда возвращаться `NULL` и драйвер, чтобы сообщить, что каталоги не поддерживаются.
`FLAG_USE_MYCNF`	Считайте Опции Из `my.cnf`	65536	Считайте параметры из `[client]` и `[odbc]` группы от `my.cnf`.
`FLAG_SAFE`	Безопасный	131072	Добавьте некоторые дополнительные проверки безопасности.
`FLAG_NO_TRANSACTIONS`	Отключите транзакции	262144	Отключите транзакции.
`FLAG_LOG_QUERY`	Сохраните запросы к `myodbc.sql`	524288	Включите журналированию запроса к `c:\myodbc.sql`(`/tmp/myodbc.sql`) файл. (Включенный только в режиме отладки.)
`FLAG_NO_CACHE`	Не Кэшируйте Результат (однонаправленные курсоры)	1048576	Не кэшируйте результаты локально в драйвере, вместо этого читайте из сервера (`mysql_use_result()`). Это работает только на однонаправленные курсоры. Эта опция очень важна имея дело с большими таблицами, когда Вы не хотите, чтобы драйвер кэшировал весь набор результатов.
`FLAG_FORWARD_CURSOR`	Использование силы Однонаправленных курсоров	2097152	Вызовите использование `Forward-only` тип курсора. В случае приложений, устанавливающих значение по умолчанию статический тип / тип динамического курсора, и каждый хочет, чтобы драйвер использовал наборы результатов некэша, тогда эта опция гарантирует поведение однонаправленного курсора.
`FLAG_AUTO_RECONNECT`	Включите % автоповторно соединяются.	4194304	Добавляет функциональность автопересоединения. Не используйте эту опцию с транзакциями, так как автопересоединение во время неполной транзакции может вызвать повреждение. Отметьте, что!P автоповторно соединенное соединение не наследует те же самые настройки и среду как оригинал. Добавленный в 3.51.13.
`FLAG_AUTO_IS_NULL`	Автоматический флаг Является Нулем	8388608	Когда `FLAG_AUTO_IS_NULL` устанавливается, драйвер не изменяет значение по умолчанию `sql_auto_is_null`, отъезд этого в 1, таким образом, Вы получаете значение по умолчанию MySQL, не поведение стандарта SQL. Когда `FLAG_AUTO_IS_NULL` не устанавливается, драйвер изменяет значение по умолчанию `SQL_AUTO_IS_NULL` к 0 после соединения, таким образом, Вы получаете стандарт SQL, не поведение значения по умолчанию MySQL. Таким образом исключение флага отключает опцию совместимости и вызывает поведение стандарта SQL. См. `IS NULL`. Добавленный в 3.51.13.
`FLAG_ZERO_DATE_TO_MIN`	Возвратите SQL_NULL_DATA для нулевой даты	16777216	Преобразовывает нулевые даты (`XXXX-00-00`) в минимальные значения даты, поддерживаемые ODBC, `XXXX-01-01`. Это решает вопрос, где некоторые операторы не будут работать, потому что возвращенная дата и минимальное значение даты ODBC является несовместимой. Добавленный в 3.51.17.
`FLAG_MIN_DATE_TO_ZERO`	Свяжите минимальную дату как нулевую дату	33554432	Преобразовывает минимальное значение даты ODBC (`XXXX-01-01`) к нулевому формату даты, поддерживаемому MySQL (`XXXX-00-00`). Это решает вопрос, где некоторые операторы не будут работать, потому что возвращенная дата и минимальное значение даты ODBC является несовместимой. Добавленный в 3.51.17.
`FLAG_MULTI_STATEMENTS`	Позвольте многократные операторы	67108864	Включает поддержке пакетных операторов. Добавленный в 3.51.18.
`FLAG_COLUMN_SIZE_S32`	Предельный размер столбца к 32-разрядному значению	134217728	Ограничивает размер столбца подписанным 32-разрядным значением, чтобы предотвратить проблемы с большими размерами столбца в приложениях, которые не поддерживают их. Эта опция автоматически включается, работая с приложениями ADO. Добавленный в 3.51.22.
`FLAG_NO_BINARY_RESULT`	Всегда обрабатывайте результаты двоичной функции как символьные данные	268435456	Когда установлено эта опция отключает набор символов 63 для столбцов с пустым `org_table`. Добавленный в 3.51.26.
`FLAG_DFLT_BIGINT_BIND_STR`		536870912	Причины `BIGINT` параметры, которые будут связаны как строки. Обработки Microsoft Access `BIGINT` как строка на связанных таблицах. Значение читается правильно, но связывается как строка. Эта опция используется автоматически, если драйвер используется Microsoft Access.
`FLAG_NO_INFORMATION_SCHEMA`		1073741824	Говорит функциям каталога не использовать `INFORMATION_SCHEMA`, а скорее используйте алгоритмы наследства. Компромисс здесь обычно является скоростью по информационному качеству. Используя `INFORMATION_SCHEMA` является часто медленным, butthe полученная информация более полно.

Чтобы выбрать многократные опции, добавьте вместе их значения, используя числа от Constant Value столбец в таблице.

Отметить

В MySQL, Connector/ODBC 5.2, можно использовать имя флага непосредственно в качестве параметра в строке подключения, определяя имя флага без префикса FLAG_. Так, в дополнение к использованию options параметр с различным набором флагов, можно использовать флаги непосредственно в качестве параметров. Например, FIELD_LENGTH, FOUND_ROWS и DEBUG мог все использоваться в качестве параметров.

Следующая таблица показывает некоторых рекомендуемых option значения для различных конфигураций:

Таблица 21.5. Рекомендуемые Значения опции Connector/ODBC для Различных Конфигураций

Конфигурация	Значение опции
Microsoft Access, Visual Basic	3
Генерация трассировки драйвера (Режим отладки)	4
Microsoft Access (с улучшенными Запросами на удаление)	35
Большие таблицы со слишком многими строками	2049
Sybase PowerBuilder	135168
Генерация журнала запросов (Режим отладки)	524288
Генерируйте трассировку драйвера так же как журнал запросов (Режим отладки)	524292
Большие таблицы с результатами без кэшей	3145731