Spec-Zone .ru
спецификации, руководства, описания, API

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