6.3.18 X Protocol и X DevAPI
-
xdevapi.authМеханизм аутентификации для использования с X Protocol. Допустимые значения: "SHA256_MEMORY", "MYSQL41", "PLAIN" и "EXTERNAL". Регистр значения не имеет значения. Если свойство не установлено, механизм выбирается в зависимости от типа соединения: "PLAIN" используется для TLS-соединений, а "SHA256_MEMORY" или "MYSQL41" — для незашифрованных соединений.
Значение по умолчанию PLAIN Начиная с версии 8.0.8 -
xdevapi.compressionСпецифичная для X DevAPI компрессия сетевого трафика. Этот параметр принимает одно из трех значений: "PREFERRED", "REQUIRED" и "DISABLED". Установка этого параметра в значение "PREFERRED" или "REQUIRED" включает согласование алгоритма сжатия между Connector и Server, а также включает сжатие больших пакетов X Protocol, при условии достижения консенсуса между клиентом и сервером относительно используемого алгоритма сжатия. Если консенсус не может быть достигнут, соединение прерывается, если параметр установлен в "REQUIRED", и продолжается без сжатия, если параметр установлен в "PREFERRED". Установка этого параметра в значение "DISABLED" пропускает этап согласования сжатия и запрещает обмен сжатыми сообщениями между клиентом и сервером.
Значение по умолчанию PREFERRED Начиная с версии 8.0.20 -
xdevapi.compression-algorithmsСписок алгоритмов сжатия, разделенных запятыми, каждый из которых идентифицируется своим именем и режимом работы (например, "lz4_message"; см. описание глобальной переменной MySQL 'mysqlx_compression_algorithms' для списка поддерживаемых и включенных алгоритмов), который определяет порядок и какие алгоритмы будут предприняты при согласовании сжатия соединения с сервером.
Алгоритм сжатия 'deflate_stream' поддерживается нативно. Дополнительные алгоритмы сжатия требуют использования сторонних библиотек и их включения с помощью свойства соединения 'xdevapi.compression-extensions'.
Этот параметр имеет значение только тогда, когда сжатие сетевого трафика включено с помощью свойства соединения 'xdevapi.compression'.
В качестве альтернативы именам алгоритмов по умолчанию, которые содержат ссылку на режим операции сжатия, можно использовать псевдонимы "zstd", "lz4" и "deflate" вместо "zstd_stream", "lz4_message" и "deflate_stream".
Значение по умолчанию zstd_stream,lz4_message,deflate_stream Начиная с версии 8.0.22 -
xdevapi.compression-extensionsСписок троек, разделенных запятыми, с элементами, разделенными двоеточием, который включает поддержку дополнительных алгоритмов сжатия. Каждая тройка должна содержать: во-первых, имя алгоритма и режим работы (например, "lz4_message"; см. описание глобальной переменной MySQL 'mysqlx_compression_algorithms' для списка поддерживаемых и включенных алгоритмов); во-вторых, полное имя класса, реализующего интерфейс 'java.io.InputStream', который будет использоваться для распаковки данных, сжатых с помощью указанного алгоритма; в-третьих, полное имя класса, реализующего интерфейс 'java.io.OutputStream', который будет использоваться для сжатия данных с помощью указанного алгоритма. Вместе с этой настройкой библиотека, содержащая реализации указанных классов, должна быть доступна в пути к классам приложения.
Можно указать любое количество троек, определяющих алгоритмы сжатия и их реализации для инфляции и дефляции, но могут использоваться только те, которые поддерживаются и включены на MySQL Server.
Алгоритм сжатия 'deflate_stream' поддерживается нативно. Дополнительные алгоритмы сжатия требуют использования сторонних библиотек.
Этот параметр имеет значение только тогда, когда сжатие сетевого трафика включено с помощью свойства соединения 'xdevapi.compression'.
В качестве альтернативы именам алгоритмов по умолчанию, которые содержат ссылку на режим операции сжатия, можно использовать псевдонимы "zstd", "lz4" и "deflate" вместо "zstd_stream", "lz4_message" и "deflate_stream".
Начиная с версии 8.0.22 -
xdevapi.connect-timeoutСпецифичное для X DevAPI время ожидания в миллисекундах для подключения сокета, при значении "0" время ожидания отсутствует. Если 'xdevapi.connect-timeout' не установлен явно, а 'connectTimeout' установлен, 'xdevapi.connect-timeout' принимает значение 'connectTimeout'.
Значение по умолчанию 10000 Начиная с версии 8.0.13 -
xdevapi.connection-attributesСпецифичный для X DevAPI список пар "ключ=значение", разделенных запятыми, помимо стандартных пар "ключ=значение", определяемых X Protocol, которые должны быть переданы MySQL Server для отображения в качестве атрибутов соединения в таблицах 'PERFORMANCE_SCHEMA' 'session_account_connect_attrs' и 'session_connect_attrs'. Пример использования: "xdevapi.connection-attributes=key1=value1,key2=value2" или "xdevapi.connection-attributes=[key1=value1,key2=value2]". Эта функциональность доступна для использования только с MySQL Server версии 8.0.16 или более поздней. Более ранние версии X Protocol не поддерживают атрибуты соединения, что приводит к игнорированию этого параметра конфигурации. В ситуациях, когда скорость создания/инициализации сеанса имеет решающее значение, установка "xdevapi.connection-attributes=false" приведет к тому, что обработка атрибутов соединения будет пропущена.
Начиная с версии 8.0.16 -
xdevapi.dns-srvСпецифичный для X DevAPI параметр, указывающий драйверу использовать заданное имя хоста для поиска записей DNS SRV и использовать полученный список хостов в соединении с отказоустойчивостью по нескольким хостам. Обратите внимание, что при включении этого параметра необходимо указать только одно имя хоста без порта.
Значение по умолчанию false Начиная с версии 8.0.19 -
xdevapi.fallback-to-system-keystoreСпецифичный для X DevAPI переключатель, указывающий, следует ли в отсутствие установленного значения для 'xdevapi.ssl-keystore' (или 'clientCertificateKeyStoreUrl') Connector/J использовать системный хранилище ключей, определенное с помощью системных свойств 'javax.net.ssl.keyStore*'. Если не указано, используется значение 'fallbackToSystemKeyStore'.
Значение по умолчанию true Начиная с версии 8.0.22 -
xdevapi.fallback-to-system-truststoreСпецифичный для X DevAPI переключатель, указывающий, следует ли в отсутствие установленного значения для 'xdevapi.ssl-truststore' (или 'trustCertificateKeyStoreUrl') Connector/J использовать системное хранилище доверенных сертификатов по умолчанию или хранилище, определенное с помощью системных свойств 'javax.net.ssl.trustStore*'. Если не указано, используется значение 'fallbackToSystemTrustStore'.
Значение по умолчанию true Начиная с версии 8.0.22 -
xdevapi.ssl-keystoreСпецифичный для X DevAPI URL для хранилища ключей клиентского сертификата. Если не указано, используется значение 'clientCertificateKeyStoreUrl'.
Начиная с версии 8.0.22 -
xdevapi.ssl-keystore-passwordСпецифичный для X DevAPI пароль для хранилища ключей клиентского сертификата. Если не указано, используется значение 'clientCertificateKeyStorePassword'.
Начиная с версии 8.0.22 -
xdevapi.ssl-keystore-typeСпецифичный для X DevAPI тип хранилища ключей клиентского сертификата. Если не указано, используется значение 'clientCertificateKeyStoreType'.
Значение по умолчанию JKS Начиная с версии 8.0.22 -
xdevapi.ssl-modeСпецифичная для X DevAPI настройка режима SSL. Если не указано, используется 'sslMode'. Поскольку режим "PREFERRED" не применим к X Protocol, если 'xdevapi.ssl-mode' не установлен, а 'sslMode' установлен в "PREFERRED", 'xdevapi.ssl-mode' устанавливается в "REQUIRED".
Значение по умолчанию REQUIRED Начиная с версии 8.0.7 -
xdevapi.ssl-truststoreСпецифичный для X DevAPI URL для хранилища ключей доверенных сертификатов CA. Если не указано, используется значение 'trustCertificateKeyStoreUrl'.
Начиная с версии 6.0.6 -
xdevapi.ssl-truststore-passwordСпецифичный для X DevAPI пароль для хранилища ключей доверенных сертификатов CA. Если не указано, используется значение 'trustCertificateKeyStorePassword'.
Начиная с версии 6.0.6 -
xdevapi.ssl-truststore-typeСпецифичный для X DevAPI тип хранилища ключей доверенных сертификатов CA. Если не указано, используется значение 'trustCertificateKeyStoreType'.
Значение по умолчанию JKS Начиная с версии 6.0.6
-
xdevapi.tls-ciphersuitesСвойство, специфичное для X DevAPI, переопределяющее наборы шифров, разрешённых для использования в подключённых сокетах SSL. Если не указано, используется значение 'enabledSSLCipherSuites'.
Версия с 8.0.19 -
xdevapi.tls-versionsСвойство, специфичное для X DevAPI, принимающее список протоколов TLS, разрешённых при создании защищённых сессий. Переопределяет протоколы TLS, разрешённые в подключённом сокете SSL. Если не указано, используется значение 'tlsVersions'. Разрешённые и значения по умолчанию — "TLSv1.2" и "TLSv1.3".
Версия с 8.0.19
© 2025 Oracle
Licensed under the GPLv2 License.