Spec-Zone.ru › MySQL Connectors 1.0

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.
https://docs.oracle.com/cd/E17952_01/connector-j-en/connector-j-connp-props-x-protocol-and-x-devapi.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API