Spec-Zone .ru
спецификации, руководства, описания, API
|
Для информации об использовании о строках подключения см. Раздел 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 |
Ни один | У этой опции есть следующие значения:
Эта опция была представлена в 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 |
ложь | Установка этой опции к Сжатие используется, если и клиент и сервер поддерживает сжатие 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 .
|