Documentation Home

6.3.18 X协议和X DevAPI

  • xdevapi.auth

    与 X 协议一起使用的身份验证机制。允许的值为“SHA256_MEMORY”、“MYSQL41”、“PLAIN”和“EXTERNAL”。值不区分大小写。如果未设置该属性,则根据连接类型选择机制:“PLAIN”用于 TLS 连接,“SHA256_MEMORY”或“MYSQL41”用于未加密连接。

    默认值 清楚的
    自版本 8.0.8
  • xdevapi.compression

    X DevAPI 特定的网络流量压缩。此选项接受以下三个值之一:“PREFERRED”、“REQUIRED”和“DISABLED”。将此选项设置为“PREFERRED”或“REQUIRED”可启用连接器和服务器之间的压缩算法协商,并打开大型 X 协议数据包的压缩,只要客户端和服务器就要使用的压缩算法达成共识。如果无法达成共识,如果选项设置为“REQUIRED”,则连接失败;如果选项设置为“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”的类的完全限定类名 将用于使用命名算法缩小数据。与此设置一起,包含指定类的实现的库必须在应用程序的类路径中可用。

    可以提供任意数量的定义压缩算法及其 inflater 和 deflater 实现的三元组,但只能使用 MySQL 服务器支持和启用的那些。

    本机支持压缩算法“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 协议定义的“key=value”对之外,X DevAPI 特定的逗号分隔的用户定义“key=value”对列表将传递给 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 服务器版本 8.0.16 或更高版本。X 协议的早期版本不支持连接属性,导致此配置选项被忽略。

    自版本 8.0.16
  • xdevapi.dns-srv

    X DevAPI 特定选项,用于指示驱动程序使用给定的主机名查找 DNS SRV 记录,并在多主机故障转移连接中使用生成的主机列表。请注意,启用此选项时,必须提供单个主机名且不提供端口。

    默认值 错误的
    自版本 8.0.19
  • xdevapi.fallback-to-system-keystore

    X DevAPI 特定的开关指定是否在没有为“xdevapi.ssl-keystore”(或“clientCertificateKeyStoreUrl”)设置值的情况下,Connector/J 回退到使用通过系统属性“javax”定义的系统范围的密钥存储.net.ssl.keyStore*'。如果未指定,则使用“fallbackToSystemKeyStore”的值。

    默认值 真的
    自版本 8.0.22
  • xdevapi.fallback-to-system-truststore

    X DevAPI 特定的开关,用于指定在没有为“xdevapi.ssl-truststore”(或“trustCertificateKeyStoreUrl”)设置值的情况下,Connector/J 回退到使用系统范围的默认信任库或通过系统定义的信任库属性“javax.net.ssl.trustStore*”。如果未指定,则使用“fallbackToSystemTrustStore”的值。

    默认值 真的
    自版本 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”。

    默认值 必需的
    自版本 8.0.7
  • xdevapi.ssl-truststore

    X 受信任的 CA 证书密钥库的特定于 DevAPI 的 URL。如果未指定,请使用“trustCertificateKeyStoreUrl”值。

    自版本 6.0.6
  • xdevapi.ssl-truststore-password

    X 受信任的 CA 证书密钥库的 DevAPI 特定密码。如果未指定,请使用“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 协议列表以允许。覆盖底层 SSL 套接字中启用的 TLS 协议。如果未指定,则使用“tlsVersions”的值。允许和默认值为“TLSv1.2”和“TLSv1.3”。

    自版本 8.0.19