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

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

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

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

Таблица 21.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. См. Раздел 21.2.5.16, "Соображения набора символов для Соединителя/Сети" для использования детализируют.
BlobAsUTF8IncludePattern нуль Регулярное выражение стиля POSIX, которое соответствует имена столбцов BLOB, содержащих данные символа UTF-8. См. Раздел 21.2.5.16, "Соображения набора символов для Соединителя/Сети" для использования детализируют.
Certificate File, CertificateFile нуль Эта опция определяет путь к файлу сертификата в PKCS #12 формат (.pfx). Для примера использования см. Раздел 21.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
Certificate Password, CertificatePassword нуль Определяет пароль, который используется в соединении с сертификатом, определенным, используя опцию CertificateFile. Для примера использования см. Раздел 21.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
Certificate Store Location, CertificateStoreLocation нуль Позволяет Вам получить доступ к сертификату, сохраненному в персональном хранилище, вместо того, чтобы использовать файл сертификата и комбинацию пароля. Для примера использования см. Раздел 21.2.4.7, "Учебное руководство: Используя SSL с MySQL, Connector/Net". Был начат с 6.2.1.
Certificate Thumbprint, CertificateThumbprint нуль Определяет след большого пальца сертификата, чтобы гарантировать корректную идентификацию сертификата, содержавшего в пределах персонального хранилища. Для примера использования см. Раздел 21.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. См. Раздел 20.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 результат должен кэшироваться в секундах. Для информации об использовании о табличном кэшировании см. Раздел 21.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 и выше. См. Раздел 21.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.) Для получения дополнительной информации, см. Раздел 21.2.5.5, "Используя Windows Native Authentication Plugin". Эта опция была представлена в Соединителе/Сети 6.4.4.
Keep Alive, Keepalive 0 Для соединений TCP, неактивное время соединения, измеренное в секундах, прежде, чем отправляется первый keepalive пакет. Значение 0 указывает, что keepalive не используется.
Logging ложь То, когда истина, различные сведения выводятся любому, сконфигурировало TraceListeners. См. Раздел 21.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 отключает это. Для информации об использовании о табличном кэшировании см. Раздел 21.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. Для получения дополнительной информации об объединении в пул соединения, см. Раздел 21.2.5.4, "Используя Соединитель/Сеть с Объединением в пул Соединения".

Таблица 21.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.