22.2.6. Ссылка Опций Строки подключения соединителя/Сети

Для информации об использовании о строках подключения см. Раздел 22.2.5.2, "Создавая Строку подключения Соединителя/Сети". Первая таблица приводит опции, которые применяются обычно ко всем конфигурациям сервера. Опции, связанные с системами, используя пул соединения, разделяются на отдельную таблицу.

Общие параметры

Таблица 22.20. Опции Строки подключения соединителя/Сети - Общий

Имя	Значение по умолчанию	Описание
`Allow Batch`, `AllowBatch`	истина	Когда истина, многократные SQL-операторы могут быть отправлены с одним выполнением команды. Отметьте: запускаясь с MySQL 4.1.1, пакетные операторы должны быть разделены определенным с помощью сервера символом разделителя. Операторы, отправленные более ранним версиям MySQL, должны быть разделены';'.
`Allow User Variables`, `AllowUserVariables`	ложь	Установка этого к `true` указывает, что провайдер ожидает пользовательские переменные в SQL. Эта опция была добавлена в версии 5.2.2 Соединителя/Сети.
`Allow Zero Datetime`, `AllowZeroDateTime`	ложь	Если установлено в `True`, `MySqlDataReader.GetValue()` возвраты a `MySqlDateTime` объект для даты или datetime столбцов, которые отвергли значения, такие как нуль datetime значения, и a `System.DateTime` объект для допустимых значений. Если установлено в `False` (настройка по умолчанию), это вызывает a `System.DateTime` объект, который будет возвращен для всех допустимых значений и исключения, которое будет брошено для отвергнутых значений, таких как нуль datetime значения.
`Auto Enlist`, `AutoEnlist`	истина	Если `AutoEnlist` устанавливается в `true`, который является значением по умолчанию, соединение открыло использование `TransactionScope` участвует в этом контексте, он фиксирует, когда контекст фиксирует и откатывает если `TransactionScope` не фиксирует. Однако, эту функцию считают чувствительной безопасностью и поэтому не может быть использована в средней доверительной среде.
`BlobAsUTF8ExcludePattern`	нуль	Регулярное выражение стиля POSIX, которое соответствует имена столбцов BLOB, которые не содержат символьные данные UTF-8. См. Раздел 22.2.5.16, "Соображения набора символов для Соединителя/Сети" для использования детализируют.
`BlobAsUTF8IncludePattern`	нуль	Регулярное выражение стиля POSIX, которое соответствует имена столбцов BLOB, содержащих данные символа UTF-8. См. Раздел 22.2.5.16, "Соображения набора символов для Соединителя/Сети" для использования детализируют.
`Certificate File`, `CertificateFile`	нуль	Эта опция определяет путь к файлу сертификата в PKCS #12 формат (`.pfx`). Для примера использования см. Раздел 22.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
`Certificate Password`, `CertificatePassword`	нуль	Определяет пароль, который используется в соединении с сертификатом, определенным, используя опцию `CertificateFile`. Для примера использования см. Раздел 22.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
`Certificate Store Location`, `CertificateStoreLocation`	нуль	Позволяет Вам получить доступ к сертификату, сохраненному в персональном хранилище, вместо того, чтобы использовать файл сертификата и комбинацию пароля. Для примера использования см. Раздел 22.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
`Certificate Thumbprint`, `CertificateThumbprint`	нуль	Определяет след большого пальца сертификата, чтобы гарантировать корректную идентификацию сертификата, содержавшего в пределах персонального хранилища. Для примера использования см. Раздел 22.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
`CharSet`, `Character Set`, `CharacterSet`		Определяет набор символов, который должен использоваться, чтобы закодировать все запросы, отправленные серверу. Наборы результатов все еще возвращаются в наборе символов данных результата.
`Check Parameters`, `CheckParameters`	истина	Указывает, должны ли сохраненные стандартные параметры быть проверены по серверу.
`Command Interceptors`, `CommandInterceptors`		Список перехватчиков, которые могут прервать операции команды SQL.
`Connect Timeout`, `Connection Timeout`, `ConnectionTimeout`	15	Отрезок времени (в секундах), чтобы ожидать соединения с сервером прежде, чем завершить попытку и генерировать ошибку.
`Connect_Attrs`		Передает предопределенный набор пар ключ/значение, содержащих специфичные для соединения элементы данных к серверу, в определенных с помощью приложения целях. Соединитель/Сеть автоматически передает следующие атрибуты: `_pid`, `_client_version`, `_platform`, `_program_name`, `_os`, `_os_details`, и `_thread`. См. Раздел 21.9.7, "Таблицы атрибутов Соединения Схемы Производительности" для таблиц Схемы Производительности, чтобы запросить на стороне сервера, чтобы использовать эти атрибуты.
`Convert Zero Datetime`, `ConvertZeroDateTime`	ложь	Истина, чтобы иметь `MySqlDataReader.GetValue()` и `MySqlDataReader.GetDateTime()` возвратиться `DateTime.MinValue` для даты или datetime столбцов, которые отвергли значения.
`Default Command Timeout`, `DefaultCommandTimeout`	30	Устанавливает значение по умолчанию тайм-аута команды, который будет использоваться. Это не заменяет отдельное свойство тайм-аута команды на отдельном объекте команды. Если Вы устанавливаете свойство тайм-аута команды, которое будет использоваться. Эта опция была добавлена в Соединителе/Сети 5.1.4
`Default Table Cache Age`, `DefaultTableCacheAge`	60	Определяет сколько времени a `TableDirect` результат должен кэшироваться в секундах. Для информации об использовании о табличном кэшировании см. Раздел 22.2.5.7, "Используя Соединитель/Сеть с Табличным Кэшированием". Эта опция была добавлена в Соединителе/Сети 6.4.
`enableSessionExpireCallback`	ложь	Когда установлено в `true`, заставляет сканер истечения сеанса повышать `session_end` событие прежде, чем удалить данные сеанса, хранившие в `my_aspnet_sessions` таблица, когда сеанс времена. Позвольте этой опции записать дополнительный специализированный код уборки, чтобы обработать `session_end` событие `global.asax` class, прежде, чем хранившие данные сеанса удаляются. В пределах session_end метода может быть сделана любая другая необходимая уборка. Эта опция была добавлена в Соединителе/Сети 6.4.5; это еще не доступно в Соединителе/Сети 6.5.x выпуски.
`Encrypt`, `UseSSL`	ложь	Для Соединителя/Сети 5.0.3 и позже, когда `true`, Шифрование SSL используется для всех данных, отправленных между клиентом и сервером, если серверу устанавливали сертификат. Распознанные значения `true`, `false`, `yes`, и `no`. В версиях прежде 5.0.3, эта опция, имеемая никакой эффект. От версии 6.2.1 эта опция осуждается и заменяется `SSL Mode`. Опция все еще работает если использующийся. Если эта опция устанавливается в истину, это эквивалентно `SSL Mode = Preferred`.
`Exception Interceptors`, `ExceptionInterceptors`		Список перехватчиков, которые могут брошенная сортировка `MySqlException` исключения.
`Functions Return String`, `FunctionsReturnString`	ложь	Заставляет соединитель возвращать значения binary/varbinary как строки, если у них нет имени таблицы в метаданных.
`Host`, `Server`, `Data Source`, `DataSource`, `Address`, `Addr`, `Network Address`	localhost	Имя или сетевой адрес экземпляра MySQL, с которым можно соединиться. Многократные узлы могут быть определены разделенные запятыми. Это может быть полезно, где многократные серверы MySQL конфигурируются для репликации, и Вы не обеспокоены точным сервером, с которым Вы соединяетесь. Никакая попытка не предпринимается провайдером, чтобы синхронизировать записи с базой данных, так заботьтесь при использовании этой опции. В среде Unix с Моно это может быть полностью определенным путем к файлу сокета MySQL. С этой конфигурацией сокет Unix используется вместо сокета TCP/IP. В настоящий момент только единственное имя сокета может быть дано, так доступ к MySQL в тиражированной среде, используя сокеты Unix в настоящий момент не поддерживается.
`Ignore Prepare`, `IgnorePrepare`	истина	Когда истина, дает провайдеру команду игнорировать любые звонки `MySqlCommand.Prepare()`. Эта возможность предоставляется, чтобы предотвратить проблемы с повреждением операторов когда использующийся со стороной сервера подготовленные операторы. Если Вы используете сторону сервера, готовят операторы, устанавливают эту опцию в ложь. Эта опция была добавлена в Соединителе/Сети 5.0.3 и Соединителе/Сети 1.0.9.
`includesecurityasserts`, `include security asserts`	ложь	Должен быть установлен в `true` при использовании `MySQLClientPermissions` class в частичной доверительной среде, с библиотекой, установленной в GAC среды хостинга. Это требование ново для частично-доверительных приложений в Соединителе/Сети 6.6.4 и выше. См. Раздел 22.2.5.19, "Работающий с Частичным Доверием / Среднее Доверие" для деталей.
`Initial Catalog`, `Database`	mysql	Чувствительное к регистру имя базы данных, чтобы использовать первоначально.
`Interactive`, `Interactive Session`, `InteractiveSession`	ложь	Если установлено в истину, клиент является интерактивным. Интерактивный клиент является тем где переменная сервера `CLIENT_INTERACTIVE` устанавливается. Если интерактивный клиент устанавливается, `wait_timeout` переменная устанавливается в значение `interactive_timeout`. Клиент будет тогда время после этого периода неактивности. Для получения дополнительной информации см. Раздел 5.1.4, "Системные Переменные Сервера" в MySQL Reference Manual.
`Integrated Security`, `IntegratedSecurity`	нет	Используйте аутентификацию Windows, соединяясь с сервером. По умолчанию это выключается. Чтобы включить, определите значение `yes`. (Можно также использовать значение `sspi` как альтернатива `yes`.) Для получения дополнительной информации, см. Раздел 22.2.5.5, "Используя Windows Native Authentication Plugin". Эта опция была представлена в Соединителе/Сети 6.4.4.
`Keep Alive`, `Keepalive`	0	Для соединений TCP, неактивное время соединения, измеренное в секундах, прежде, чем отправляется первый keepalive пакет. Значение 0 указывает, что keepalive не используется.
`Logging`	ложь	То, когда истина, различные сведения выводятся любому, сконфигурировало TraceListeners. См. Раздел 22.2.5.14, "Используя MySQL Исходный объект Трассировки Connector/Net" для получения дальнейшей информации.
`Old Guids`, `OldGuids`	ложь	Эта опция была представлена в Соединителе/Сети 6.1.1. Представление бэкэнда типа GUID было изменено от `BINARY(16)` к `CHAR(36)`. Это было сделано, чтобы позволить разработчикам использовать функцию сервера `UUID()` заполнить таблицу GUID - `UUID()` генерирует 36-символьную строку. Разработчики более старых приложений могут добавить `'Old Guids=true'` к строке подключения, чтобы использовать GUID типа данных `BINARY(16)`.
`Old Syntax`, `OldSyntax`, `Use Old Syntax`, `UseOldSyntax`	ложь	Эта опция осуждалась в Соединителе/Сети 5.2.2. Весь код должен теперь быть записан, используя символ как маркер параметра.
`Password`, `pwd`		Пароль для используемой учетной записи MySQL.
`Persist Security Info`, `PersistSecurityInfo`	ложь	Когда установлено в `false` или `no` (строго рекомендуемый), уязвимая информация безопасности, такая как пароль, не возвращается как часть соединения, если соединение открыто или когда-либо было в открытом состоянии. Сброс строки подключения сбрасывает все значения строки подключения, включая пароль. Распознанные значения `true`, `false`, `yes`, и `no`.
`Pipe Name`, `Pipe`, `PipeName`	mysql	Когда установлено в имя именованного канала, `MySqlConnection` попытки соединиться с MySQL на том именованном канале. Эта установка только применяется к платформе Windows.
`Port`	3306	MySQL порта использует, чтобы прислушаться к соединениям. Это значение игнорируется, если сокет Unix используется.
`Procedure Cache Size`, `ProcedureCacheSize`, `procedure cache`, `procedurecache`	25	Устанавливает размер кэша хранимой процедуры. По умолчанию Соединитель/Сеть хранит метаданные (типы ввода/выходных данных) о последних 25 используемых хранимых процедурах. Чтобы отключить кэш хранимой процедуры, установите значение в нуль (0). Эта опция была добавлена в Соединителе/Сети 5.0.2 и Соединителе/Сети 1.0.9.
`Protocol`, `Connection Protocol`, `ConnectionProtocol`	сокет	Определяет тип соединения, чтобы сделать к серверу. Значения могут быть: `socket` или `tcp` для сокетного соединения, `pipe` для соединения именованного канала, `unix` для сокетного соединения Unix, `memory` использовать разделяемую память MySQL.
`Replication`	ложь	Указывает, должно ли это соединение использовать тиражированные серверы.
`Respect Binary Flags`, `RespectBinaryFlags`	истина	Установка этой опции к `false` средства, что Соединитель/Сеть игнорирует двоичные флаги столбца как установлено сервером. Эта опция была добавлена в версии 5.1.3 Соединителя/Сети.
`Shared Memory Name`, `SharedMemoryName`	MYSQL	Имя разделяемой памяти возражает, чтобы использовать для передачи, если протокол соединения устанавливается в `memory`.
`Sql Server Mode`, `sqlservermode`	ложь	Позвольте синтаксис SQL-сервера. Когда установлено в `true`, позволяет Соединителю/Сети поддерживать квадратные скобки вокруг символов вместо обратных галочек. Это позволяет мастерам Visual Studio что символы скобки с [] работать с Соединителем/Сетью. Эта опция подвергается хиту производительности, так должен только использоваться в случае необходимости. Эта опция была добавлена в версии 6.3.1.
`SSL Mode`, `SslMode`	Ни один	У этой опции есть следующие значения: Ни один - не использует SSL. Предпочтенный - используют SSL, если сервер поддерживает его, но позвольте соединение во всех случаях. Требуемый - Всегда используют SSL. Отрицайте соединение, если сервер не поддерживает SSL. VerifyCA - Всегда используют SSL. Проверьте CA, но терпите несоответствие имени. VerifyFull - Всегда используют SSL. Сбой, если имя хоста не корректно. Эта опция была представлена в MySQL, Connector/Net 6.2.1.
`Table Cache`, `tablecache`, `tablecaching`	ложь	Включает или отключает кэширование `TableDirect` команды. Значение `true` включает кэшу в то время как `false` отключает это. Для информации об использовании о табличном кэшировании см. Раздел 22.2.5.7, "Используя Соединитель/Сеть с Табличным Кэшированием". Эта опция была добавлена в Соединителе/Сети 6.4.
`Treat BLOBs as UTF8`, `TreatBlobsAsUTF8`	ложь
`Treat Tiny As Boolean`, `TreatTinyAsBoolean`	истина	Установка этого значения к `false` причины `TINYINT(1)` быть обработанным как `INT`. См. Раздел 11.1.1, "Числовой Краткий обзор Типа" для дальнейшего объяснения `TINYINT` и `BOOL` типы данных.
`Use Affected Rows`, `UseAffectedRows`	ложь	Когда `true`, соединение сообщает об измененных строках вместо найденных строк. Эта опция была добавлена в версии 5.2.6 Соединителя/Сети.
`Use Procedure Bodies`, `UseProcedureBodies`, `procedure bodies`	истина	Когда установлено в `true`, значение по умолчанию, MySQL, Connector/Net, ожидает, что тело процедуры будет просматриваемым. Это позволяет этому определить типы параметра и порядок. Установите опцию в `false` когда пользователь, соединяющийся с базой данных, не имеет `SELECT` полномочия для `mysql.proc` (хранимые процедуры) таблица, или не может просмотреть `INFORMATION_SCHEMA.ROUTINES`. В этом случае MySQL, Connector/Net, не может определить типы и порядок параметров, и должен быть предупрежден к этому факту, устанавливая эту опцию в `false`. Когда установлено в `false`, MySQL, Connector/Net, не полагается на эту информацию, являющуюся доступным, когда процедуру вызывают. Поскольку MySQL, Connector/Net, не будет в состоянии определить эту информацию, явно установить типы всех параметров перед вызовом и добавить параметры к команде в том же самом порядке, как они появляются в определении процедуры. Эта опция была добавлена в MySQL, Connector/Net 5.0.4 и MySQL, Connector/Net 1.0.10.
`User Id`, `UserID`, `Username`, `Uid`, `User name`, `User`		Используемая учетная запись MySQL.
`Compress`, `Use Compression`, `UseCompression`	ложь	Установка этой опции к `true` включает сжатию пакетов, которыми обмениваются между клиентом и сервером. Этот обмен определяется протоколом клиента/сервера MySQL. Сжатие используется, если и клиент и сервер поддерживает сжатие ZLIB, и клиент запросил сжатие, используя эту опцию. Сжатый пакетный заголовок: пакетная длина (3 байта), пакетное число (1 байт), и Несжатая Пакетная Длина (3 байта). Несжатая Пакетная Длина является числом байтов в исходном, несжатом пакете. Если это - нуль, данные в этом пакете не были сжаты. Когда протокол сжатия используется, или клиент или сервер могут сжать пакеты. Однако, сжатие не будет происходить, если сжатая длина будет больше чем исходная длина. Таким образом некоторые пакеты будут содержать сжатые данные, в то время как другие пакеты не будут.
`Use Usage Advisor`, `Usage Advisor`, `UseUsageAdvisor`	ложь	Регистрирует неэффективные операции базы данных.
`Use Performance Monitor`, `UsePerformanceMonitor`,`userperfmon`, `perfmon`	ложь	Указывает, что счетчики производительности должны быть обновлены во время выполнения.

Опции Объединения в пул соединения

Следующая таблица приводит допустимые имена для опций, связанных с объединением в пул соединения в пределах ConnectionString. Для получения дополнительной информации об объединении в пул соединения, см. Раздел 22.2.5.4, "Используя Соединитель/Сеть с Объединением в пул Соединения".

Таблица 22.21. Опции Строки подключения соединителя/Сети - Объединение в пул Соединения

Имя	Значение по умолчанию	Описание
`Cache Server Properties`, `CacheServerProperties`	ложь	Определяет, обновляются ли настройки переменной сервера a `SHOW VARIABLES` команда каждый раз объединенное в пул соединение возвращается. Включение этой установке ускоряет соединения в среде пула соединения. Вашему приложению не сообщают ни о каких изменениях к переменным конфигурации, сделанным другими соединениями. Эта опция была добавлена в Соединителе/Сети 6.3.
`Connection Lifetime`, `ConnectionLifeTime`	0	Когда соединение возвращается к пулу, его время создания по сравнению с текущим временем, и соединение уничтожается, если тот отрезок времени (в секундах) превышает значение, определенное `Connection Lifetime`. Это полезно в кластеризируемых конфигурациях, чтобы вызвать выравнивание нагрузки между рабочим сервером и сервером, только принесенным онлайн. Значение нуля (0) заставляет объединенные в пул соединения иметь максимальный тайм-аут соединения.
`Connection Reset`, `ConnectionReset`	ложь	Если это правда, состояние соединения сбрасывается, когда оно получается от пула. Значение по умолчанию лжи избегает делать дополнительный цикл обработки сервера, получая соединение, но состояние соединения не сбрасывается.
`Maximum Pool Size`, `Max Pool Size`, `maximumpoolsize`	100	Максимальное количество соединений позволяется в пуле.
`Minimum Pool Size`, `Min Pool Size`, `MinimumPoolSize`	0	Минимальное число соединений позволяется в пуле.
`Pooling`	истина	Когда `true`, `MySqlConnection` объект оттягивается из соответствующего пула, или в случае необходимости, создается и добавляется к соответствующему пулу. Распознанные значения `true`, `false`, `yes`, и`no`.