Spec-Zone .ru
спецификации, руководства, описания, API
|
int mysql_options(MYSQL *mysql, enum mysql_option option, const void *arg)
Может использоваться, чтобы установить дополнительный, соединяют опции и влияют на поведение для соединения. Эта функция может быть вызвана многократно, чтобы установить несколько опций.
Вызвать mysql_options()
после mysql_init()
и прежде mysql_connect()
или mysql_real_connect()
.
option
параметром является опция, которую Вы хотите установить; arg
параметром является значение для опции. Если опция является целым числом,
определите указатель на значение целого числа как arg
параметр.
Следующий список описывает возможные варианты, их эффект, и как arg
используется
для каждой опции. Несколько из опций применяются только, когда приложение соединяется против libmysqld
встроенная библиотека сервера и неиспользована для приложений,
соединенных против libmysqlclient
клиентская библиотека. Для описаний опции,
которые указывают arg
неиспользовано, его значение не важно; это является
стандартным, чтобы передать 0.
MYSQL_DEFAULT_AUTH
(тип параметра: char *
)
Имя плагина аутентификации, чтобы использовать.
MYSQL_ENABLE_CLEARTEXT_PLUGIN
(тип параметра: my_bool *
)
Включите mysql_clear_password
плагин аутентификации открытого текста.
(См. Раздел 6.3.7.3, "Клиентский
Плагин Аутентификации Открытого текста".)
MYSQL_INIT_COMMAND
(тип параметра: char *
)
SQL-оператор, чтобы выполниться, соединяясь с сервером MySQL. Автоматически повторно выполняемый, если пересоединение происходит.
MYSQL_OPT_BIND
(параметр: char
*
)
Сетевой интерфейс, от которого можно соединиться с сервером. Это используется, когда у хоста клиента есть многократные сетевые интерфейсы. Параметром является имя хоста или IP-адрес (определенный как строка).
MYSQL_OPT_CAN_HANDLE_EXPIRED_PASSWORDS
(тип параметра:
my_bool *
)
Укажите, может ли клиент обработать истекшие пароли. Для получения дополнительной информации см. Раздел 6.3.6, "Истечение пароля и Режим Песочницы".
MYSQL_OPT_COMPRESS
(параметр: не используемый)
Используйте сжатый клиент-серверный протокол.
MYSQL_OPT_CONNECT_ATTR_DELETE
(типы параметра: char *
)
Учитывая ключевое имя, эта опция удаляет пару ключ/значение из текущего набора атрибутов соединения, которые передадут к серверу во время соединения. Параметром является указатель на завершенную нулем строку, называя ключ. Сравнение ключевого имени с существующими ключами является чувствительным к регистру.
См. также описание для MYSQL_OPT_CONNECT_ATTR_RESET
опция, так же как
описание для MYSQL_OPT_CONNECT_ATTR_ADD
опция в описании mysql_options4()
функция. То функциональное описание также
включает пример использования.
Атрибуты соединения представляются через session_connect_attrs
и session_account_connect_attrs
Таблицы Схемы производительности. См.
Раздел 20.9.7, "Таблицы
атрибутов Соединения Схемы Производительности".
MYSQL_OPT_CONNECT_ATTR_RESET
(параметр, не
используемый)
Эта опция сбросы (очищает) текущий набор атрибутов соединения, которые передадут к серверу во время соединения.
См. также описание для MYSQL_OPT_CONNECT_ATTR_DELETE
опция, так же как
описание для MYSQL_OPT_CONNECT_ATTR_ADD
опция в описании mysql_options4()
функция. То функциональное описание также
включает пример использования.
Атрибуты соединения представляются через session_connect_attrs
и session_account_connect_attrs
Таблицы Схемы производительности. См.
Раздел 20.9.7, "Таблицы
атрибутов Соединения Схемы Производительности".
MYSQL_OPT_CONNECT_TIMEOUT
(тип параметра: unsigned int *
)
Соедините тайм-аут в секундах.
MYSQL_OPT_GUESS_CONNECTION
(параметр: не используемый)
Для приложения, соединенного против libmysqld
встроенная библиотека
сервера, это позволяет библиотеке предположить, использовать ли встроенный сервер или удаленный
сервер. "Предположение" означает
что, если имя хоста устанавливается и не localhost
, это использует
удаленный сервер. Это поведение является значением по умолчанию. MYSQL_OPT_USE_EMBEDDED_CONNECTION
и MYSQL_OPT_USE_REMOTE_CONNECTION
может использоваться, чтобы
переопределить это. Эта опция игнорируется для приложений, соединенных против libmysqlclient
клиентская библиотека.
MYSQL_OPT_LOCAL_INFILE
(тип параметра: дополнительный
указатель на unsigned int
)
Если никакая подсказка не дается или если указатель указывает на unsigned
int
у этого есть ненулевое значение, LOAD LOCAL INFILE
оператор
включается.
MYSQL_OPT_NAMED_PIPE
(параметр: не используемый)
Используйте именованные каналы, чтобы соединиться с сервером MySQL на Windows, если сервер разрешает соединения именованного канала.
MYSQL_OPT_PROTOCOL
(тип параметра: unsigned int *
)
Тип протокола, чтобы использовать. Определите одно из перечислимых значений mysql_protocol_type
определенный в mysql.h
.
MYSQL_OPT_READ_TIMEOUT
(тип параметра: unsigned int *
)
Тайм-аут в секундах для попыток читать из сервера. Каждая попытка использует это значение тайм-аута
и в случае необходимости есть повторения, таким образом, полное эффективное значение тайм-аута
является три раза значением опции. Можно установить значение так, чтобы потерянное соединение могло
быть обнаружено ранее чем TCP/IP Close_Wait_Timeout
значение 10 минут.
MYSQL_OPT_RECONNECT
(тип параметра: my_bool *
)
Включите или отключите автоматическое пересоединение с сервером, если соединение, как находят, было потеряно. Повторно соединитесь прочь по умолчанию; эта опция обеспечивает способ установить поведение пересоединения явно.
MYSQL_OPT_SSL_CA
(тип параметра: char
*
)
Путь к файлу, который содержит список доверяемой АВАРИИ SSL.
MYSQL_OPT_SSL_CAPATH
(тип параметра: char *
)
Путь к каталогу, который содержит доверяемые сертификаты CA SSL в формате PEM.
MYSQL_OPT_SSL_CERT
(тип параметра: char *
)
Имя файла сертификата SSL, чтобы использовать для того, чтобы установить безопасное соединение.
MYSQL_OPT_SSL_CIPHER
(тип параметра: char *
)
Список допустимых шифров, чтобы использовать для шифрования SSL.
MYSQL_OPT_SSL_CRL
(тип параметра: char *
)
Путь к файлу, содержащему списки аннулированных сертификатов в формате PEM.
MYSQL_OPT_SSL_CRLPATH
(тип параметра: char *
)
Путь к каталогу, который содержит файлы, содержащие списки аннулированных сертификатов в формате PEM.
MYSQL_OPT_SSL_KEY
(тип параметра: char *
)
Имя файла ключей SSL, чтобы использовать для того, чтобы установить безопасное соединение.
MYSQL_OPT_SSL_VERIFY_SERVER_CERT
(тип параметра: my_bool *
)
Включите или отключите проверку значения Общего названия сервера в его сертификате против имени хоста, используемого, соединяясь с сервером. Соединение отклоняется, если есть несоответствие. Эта функция может быть использована, чтобы предотвратить атаки "человек посередине". Проверка отключается по умолчанию.
MYSQL_OPT_USE_EMBEDDED_CONNECTION
(параметр: не
используемый)
Для приложения, соединенного против libmysqld
встроенная библиотека
сервера, это вызывает использование встроенного сервера для соединения. Эта опция игнорируется для
приложений, соединенных против libmysqlclient
клиентская библиотека.
MYSQL_OPT_USE_REMOTE_CONNECTION
(параметр: не
используемый)
Для приложения, соединенного против libmysqld
встроенная библиотека
сервера, это вызывает использование удаленного сервера для соединения. Эта опция игнорируется для
приложений, соединенных против libmysqlclient
клиентская библиотека.
MYSQL_OPT_USE_RESULT
(параметр: не используемый)
Эта опция неиспользована.
MYSQL_OPT_WRITE_TIMEOUT
(тип параметра: unsigned int *
)
Тайм-аут в секундах для попыток записать в сервер. Каждая попытка использует это значение тайм-аута
и есть net_retry_count
повторения в случае необходимости, таким образом,
полное эффективное значение тайм-аута net_retry_count
времена значение опции.
MYSQL_PLUGIN_DIR
(тип параметра: char
*
)
Каталог, в котором можно искать клиентские плагины.
MYSQL_READ_DEFAULT_FILE
(тип параметра: char *
)
Считайте опции из именованного файла опции вместо от my.cnf
.
MYSQL_READ_DEFAULT_GROUP
(тип параметра: char *
)
Считайте опции из именованной группы от my.cnf
или файл, определенный
с MYSQL_READ_DEFAULT_FILE
.
MYSQL_REPORT_DATA_TRUNCATION
(тип параметра: my_bool *
)
Включите или отключите создание отчетов ошибок усечения данных для готовых операторов, используя
error
элемент MYSQL_BIND
структуры.
(Значение по умолчанию: включенный.)
MYSQL_SECURE_AUTH
(тип параметра: my_bool *
)
Соединиться ли с сервером, который не поддерживает пароль, хеширующий используемый в MySQL 4.1.1 и позже. Эта опция включается по умолчанию.
MYSQL_SERVER_PUBLIC_KEY
(тип параметра: char *
)
Путь к файлу, содержащему сервер открытый ключ RSA. Файл должен быть в формате PEM. Открытый ключ
используется для шифрования RSA клиентского пароля для соединений с сервером, сделанным, используя
учетные записи, которые аутентифицируют с sha256_password
плагин. Эта
опция игнорируется для клиентских учетных записей, которые не аутентифицируют с тем плагином. Это
также игнорируется, если шифрование пароля не необходимо, как имеет место, когда клиент соединяется
с сервером, используя соединение SSL.
Сервер отправляет открытый ключ клиенту как необходимый, таким образом, не необходимо использовать эту опцию для шифрования пароля RSA, чтобы произойти. Более эффективно сделать так, потому что тогда сервер не должен отправить ключ.
Для дополнительного обсуждения относительно использования sha256_password
плагин, включая то, как получить открытый ключ RSA, видит
Раздел 6.3.7.2, "SHA 256 Плагинов
Аутентификации".
MYSQL_SET_CHARSET_DIR
(тип параметра: char *
)
Путь к каталогу, который содержит файлы определения набора символов.
MYSQL_SET_CHARSET_NAME
(тип параметра: char *
)
Имя набора символов, чтобы использовать в качестве набора символов значения по умолчанию. Параметр
может быть MYSQL_AUTODETECT_CHARSET_NAME
заставить набор символов быть
автоматически обнаруженным основанный на установке операционной системы (см. Раздел
10.1.4, "Наборы символов соединения и Сопоставления").
MYSQL_SET_CLIENT_IP
(тип параметра: char *
)
Для приложения, соединенного против libmysqld
встроенная библиотека
сервера (когда libmysqld
компилируется с поддержкой аутентификации),
это означает, что пользователь, как полагают, соединился от указанного IP-адреса (определенный как
строка) в целях аутентификации. Эта опция игнорируется для приложений, соединенных против libmysqlclient
клиентская библиотека.
MYSQL_SHARED_MEMORY_BASE_NAME
(тип параметра: char *
)
Имя разделяемой памяти возражает для передачи против сервера на Windows, если сервер поддерживает
сопряжения с общей памятью. Определите то же самое значение как --shared-memory-base-name
опция, используемая для mysqld сервера, Вы хотите соединиться с.
client
группа всегда читается, если Вы используете MYSQL_READ_DEFAULT_FILE
или MYSQL_READ_DEFAULT_GROUP
.
Указанная группа в файле опции может содержать следующие опции.
Опция | Описание |
---|---|
character-sets-dir=
|
Каталог, где наборы символов устанавливаются. |
compress |
Используйте сжатый клиент-серверный протокол. |
connect-timeout=
|
Соедините тайм-аут в секундах. На Linux этот тайм-аут также используется для того, чтобы ожидать первого ответа от сервера. |
database=
|
Соединитесь с этой базой данных, если никакая база данных не была определена в соединить команде. |
debug |
Опции отладки. |
default-character-set= |
Набор символов значения по умолчанию, чтобы использовать. |
disable-local-infile |
Отключите использование LOAD DATA
LOCAL .
|
enable-cleartext-plugin |
Включите mysql_clear_password плагин аутентификации открытого текста.
|
host=
|
Имя хоста значения по умолчанию. |
init-command=
|
Оператор, чтобы выполниться, соединяясь с сервером MySQL. Автоматически повторно выполняемый, если пересоединение происходит. |
interactive-timeout= |
То же самое как определение CLIENT_INTERACTIVE к mysql_real_connect() . См. Раздел
21.8.7.53,"mysql_real_connect() ".
|
local-infile[={0|1}] |
Если никакой параметр или ненулевой параметр, включите использованию LOAD DATA LOCAL ; иначе отключите.
|
max_allowed_packet=
|
Максимальный размер пакета, который клиент может считать из сервера. |
multi-queries , multi-results
|
Включите многократным наборам результатов от выполнения многократного оператора или хранимых процедур. |
multi-statements |
Позвольте клиенту отправить многократные операторы в единственной строке (разделенный"; ").
|
password=
|
Пароль значения по умолчанию. |
pipe |
Используйте именованные каналы, чтобы соединиться с сервером MySQL на Windows. |
port=
|
Номер порта значения по умолчанию. |
protocol={TCP|SOCKET|PIPE|MEMORY} |
Протокол, чтобы использовать, соединяясь с сервером. |
return-found-rows |
Сказать mysql_info() возвратиться найденный строками вместо обновленных строк
при использованииUPDATE .
|
shared-memory-base-name=
|
Имя разделяемой памяти, чтобы использовать, чтобы соединиться с сервером. |
socket= |
Файл сокета значения по умолчанию. |
ssl-ca=
|
Файл Центра сертификации. |
ssl-capath=
|
Каталог Certificate Authority. |
ssl-cert= |
Файл сертификата. |
ssl-cipher= |
Допустимые шифры SSL. |
ssl-key=
|
Файл ключей. |
timeout=
|
Как connect-timeout . |
user |
Пользователь значения по умолчанию. |
timeout
был заменен connect-timeout
, но timeout
все еще поддерживается в MySQL 5.7 для обратной совместимости.
Для получения дополнительной информации о файлах опции, см. Раздел 4.2.3.3, "Используя Файлы Опции".
Нуль для успеха. Ненулевой, если Вы определяете неизвестную опцию.
Следующий mysql_options()
вызовы запрашивают использование сжатия в клиент-серверном
протоколе, заставляют опции быть считанными из [odbc]
группа файлов опции, и
отключает режим автоматической фиксации транзакции:
MYSQL mysql;mysql_init(&mysql);mysql_options(&mysql,MYSQL_OPT_COMPRESS,0);mysql_options(&mysql,MYSQL_READ_DEFAULT_GROUP,"odbc");mysql_options(&mysql,MYSQL_INIT_COMMAND,"SET autocommit=0");if (!mysql_real_connect(&mysql,"host","user","passwd","database",0,NULL,0)){ fprintf(stderr, "Failed to connect to database: Error: %s\n", mysql_error(&mysql));}
Этот код запрашивает, чтобы клиент использовал сжатый клиент-серверный протокол и считал дополнительные опции из
odbc
раздел в my.cnf
файл.