#### 6.4.4.18 密钥环系统变量

[](<>)

MySQL Keyring 插件支持以下系统变量。使用它们来配置密钥环插件操作。除非安装了适当的密钥环插件，否则这些变量不可用（请参阅[第 6.4.4.3 节，“密钥环插件安装”](keyring-plugin-installation.html)）。

-   [](<>) [`keyring_aws_cmk_id`](keyring-system-variables.html#sysvar_keyring_aws_cmk_id)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-aws-cmk-id=值` |
    | ----- | ------------------------ |
    | 系统变量 | `[keyring_aws_cmk_id](keyring-system-variables.html#sysvar_keyring_aws_cmk_id)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    从 AWS KMS 服务器获取并由`密钥环_aws`插入。除非安装了该插件，否则此变量不可用。

    这个变量是强制性的。如果没有指定，`密钥环_aws`初始化失败。

-   [](<>) [`keyring_aws_conf_file`](keyring-system-variables.html#sysvar_keyring_aws_conf_file)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-aws-conf-file=file_name` |
    | ----- | ----------------------------------- |
    | 系统变量 | `[keyring_aws_conf_file](keyring-system-variables.html#sysvar_keyring_aws_conf_file)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `特定平台` |

    配置文件的位置`密钥环_aws`插入。除非安装了该插件，否则此变量不可用。

    在插件启动时，`密钥环_aws`从配置文件中读取 AWS 秘密访问密钥 ID 和密钥。为了`密钥环_aws`插件要成功启动，配置文件必须存在并包含有效的秘密访问密钥信息，如中所述初始化[第 6.4.4.9 节，“使用密钥环\_aws 亚马逊网络服务密钥环插件”](keyring-aws-plugin.html).

    默认文件名是`keyring_aws_conf`，位于默认的密钥环文件目录中。此默认目录的位置与[`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)系统变量。有关详细信息以及手动创建目录时要考虑的注意事项，请参阅该变量的描述。

-   [](<>) [`keyring_aws_data_file`](keyring-system-variables.html#sysvar_keyring_aws_data_file)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-aws-数据文件` |
    | ----- | -------------------- |
    | 系统变量 | `[keyring_aws_data_file]（keyring-system-variables.html#sysvar_keyring_aws_data_file）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `特定平台` |

    存储文件的位置`密钥环_aws`插入。除非安装了该插件，否则此变量不可用。

    在插件启动时，如果分配给[`keyring_aws_data_file`](keyring-system-variables.html#sysvar_keyring_aws_data_file)指定一个不存在的文件，`密钥环_aws`插件尝试创建它（以及它的父目录，如有必要）。如果文件确实存在，`密钥环_aws`将文件中包含的任何加密密钥读取到其内存缓存中。`密钥环_aws`不会在内存中缓存未加密的密钥。

    默认文件名是`keyring_aws_data`，位于默认的密钥环文件目录中。此默认目录的位置与[`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)系统变量。有关详细信息以及手动创建目录时要考虑的注意事项，请参阅该变量的描述。

-   [](<>) [`keyring_aws_region`](keyring-system-variables.html#sysvar_keyring_aws_region)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-aws-区域=值` |
    | ----- | -------------------- |
    | 系统变量 | `[keyring_aws_region](keyring-system-variables.html#sysvar_keyring_aws_region)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 枚举 |
    | 默认值 | `我们-东-1` |
    | 有效值 | `ap-northeast-1`<br/><br/>`ap-northeast-2`<br/><br/>`ap-south-1`<br/><br/>`ap-southeast-1`<br/><br/>`ap-southeast-2`<br/><br/>`eu-central-1`<br/><br/>`eu-west-1`<br/><br/>`sa-east-1`<br/><br/>`我们-东-1`<br/><br/>`us-west-1`<br/><br/>`us-west-2` |

    的 AWS 区域`密钥环_aws`插入。除非安装了该插件，否则此变量不可用。

-   [](<>) [`keyring_encrypted_file_data`](keyring-system-variables.html#sysvar_keyring_encrypted_file_data)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-encrypted-file-data=file_name` |
    | ----- | ----------------------------------------- |
    | 系统变量 | `[keyring_encrypted_file_data]（keyring-system-variables.html#sysvar_keyring_encrypted_file_data）` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `特定平台` |

    用于安全数据存储的数据文件的路径名`密钥环加密文件`插入。除非安装了该插件，否则此变量不可用。文件位置应位于仅供密钥环插件使用的目录中。例如，不要在数据目录下找到该文件。

    密钥环操作是事务性的：`密钥环加密文件`插件在写入操作期间使用备份文件，以确保在操作失败时它可以回滚到原始文件。备份文件的名称与[`keyring_encrypted_file_data`](keyring-system-variables.html#sysvar_keyring_encrypted_file_data)后缀为的系统变量`.backup`.

    不要使用相同的`密钥环加密文件`多个 MySQL 实例的数据文件。每个实例都应该有自己唯一的数据文件。

    默认文件名是`密钥环加密`，位于特定于平台的目录中，并且取决于[`INSTALL_LAYOUT`](source-configuration-options.html#option_cmake_install_layout) **制作**选项，如下表所示。如果从源代码构建，要显式指定文件的默认目录，请使用[`INSTALL_MYSQLKEYRINGDIR`](source-configuration-options.html#option_cmake_install_mysqlkeyringdir) **制作**选项。

    | `INSTALL_LAYOUT`价值 | 默认`keyring_encrypted_file_data`价值 |
    | ------------------ | --------------------------------- |
    | `开发银行`,`转速`,`SVR4` | `/var/lib/mysql-keyring/keyring_encrypted` |
    | 否则 | `密钥环/密钥环加密`在下面[`CMAKE_INSTALL_PREFIX`](source-configuration-options.html#option_cmake_cmake_install_prefix)价值 |

    在插件启动时，如果分配给[`keyring_encrypted_file_data`](keyring-system-variables.html#sysvar_keyring_encrypted_file_data)指定一个不存在的文件，`密钥环加密文件`插件尝试创建它（以及它的父目录，如有必要）。

    如果您手动创建目录，它应该具有限制模式，并且只能由用于运行 MySQL 服务器的帐户访问。例如，在 Unix 和类 Unix 系统上，使用`/usr/local/mysql/mysql-keyring`目录，以下命令（执行为`根`) 创建目录并设置其模式和所有权：

    ```
    cd /usr/local/mysql
    mkdir mysql-keyring
    chmod 750 mysql-keyring
    chown mysql mysql-keyring
    chgrp mysql mysql-keyring
    ```

    如果`密钥环加密文件`插件无法创建或访问其数据文件，它会将错误消息写入错误日志。如果尝试将运行时分配给[`keyring_encrypted_file_data`](keyring-system-variables.html#sysvar_keyring_encrypted_file_data)导致错误，变量值保持不变。

    重要的

    一旦`密钥环加密文件`插件已经创建了它的数据文件并开始使用它，重要的是不要删除该文件。文件丢失会导致使用其密钥加密的数据无法访问。（允许重命名或移动文件，只要更改[`keyring_encrypted_file_data`](keyring-system-variables.html#sysvar_keyring_encrypted_file_data)匹配。）

-   [](<>) [`keyring_encrypted_file_password`](keyring-system-variables.html#sysvar_keyring_encrypted_file_password)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-encrypted-file-password=密码` |
    | ----- | -------------------------------------- |
    | 系统变量 | `[keyring_encrypted_file_password](keyring-system-variables.html#sysvar_keyring_encrypted_file_password)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    使用的密码`密钥环加密文件`插入。除非安装了该插件，否则此变量不可用。

    这个变量是强制性的。如果没有指定，`密钥环加密文件`初始化失败。

    如果在选项文件中指定了此变量，则该文件应具有限制模式，并且只能由用于运行 MySQL 服务器的帐户访问。

    重要的

    一旦[`keyring_encrypted_file_password`](keyring-system-variables.html#sysvar_keyring_encrypted_file_password)值已设置，更改它不会轮换密钥环密码，并且可能使服务器无法访问。如果提供的密码不正确，则`密钥环加密文件`插件无法从加密的密钥环文件中加载密钥。

    密码值不能在运行时显示[`显示变量`](show-variables.html)或性能模式[`全局变量`](performance-schema-system-variable-tables.html)表，因为显示值被混淆了。

-   [](<>) [`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-file-data=file_name` |
    | ----- | ------------------------------- |
    | 系统变量 | `[keyring_file_data](keyring-system-variables.html#sysvar_keyring_file_data)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `特定平台` |

    用于安全数据存储的数据文件的路径名`密钥环文件`插入。除非安装了该插件，否则此变量不可用。文件位置应位于仅供密钥环插件使用的目录中。例如，不要在数据目录下找到该文件。

    密钥环操作是事务性的：`密钥环文件`插件在写入操作期间使用备份文件，以确保在操作失败时它可以回滚到原始文件。备份文件的名称与[`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)后缀为的系统变量`.backup`.

    不要使用相同的`密钥环文件`多个 MySQL 实例的数据文件。每个实例都应该有自己唯一的数据文件。

    默认文件名是`钥匙圈`，位于特定于平台的目录中，并且取决于[`INSTALL_LAYOUT`](source-configuration-options.html#option_cmake_install_layout) **制作**选项，如下表所示。如果从源代码构建，要显式指定文件的默认目录，请使用[`INSTALL_MYSQLKEYRINGDIR`](source-configuration-options.html#option_cmake_install_mysqlkeyringdir) **制作**选项。

    | `INSTALL_LAYOUT`价值 | 默认`密钥环文件数据`价值 |
    | ------------------ | ------------- |
    | `开发银行`,`转速`,`SVR4` | `/var/lib/mysql-keyring/keyring` |
    | 否则 | `钥匙圈/钥匙圈`在下面[`CMAKE_INSTALL_PREFIX`](source-configuration-options.html#option_cmake_cmake_install_prefix)价值 |

    在插件启动时，如果分配给[`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)指定一个不存在的文件，`密钥环文件`插件尝试创建它（以及它的父目录，如有必要）。

    如果您手动创建目录，它应该具有限制模式，并且只能由用于运行 MySQL 服务器的帐户访问。例如，在 Unix 和类 Unix 系统上，使用`/usr/local/mysql/mysql-keyring`目录，以下命令（执行为`根`) 创建目录并设置其模式和所有权：

    ```
    cd /usr/local/mysql
    mkdir mysql-keyring
    chmod 750 mysql-keyring
    chown mysql mysql-keyring
    chgrp mysql mysql-keyring
    ```

    如果`密钥环文件`插件无法创建或访问其数据文件，它会将错误消息写入错误日志。如果尝试将运行时分配给[`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)导致错误，变量值保持不变。

    重要的

    一旦`密钥环文件`插件已经创建了它的数据文件并开始使用它，重要的是不要删除该文件。例如，`InnoDB`使用该文件存储用于解密表中数据的主密钥，该表使用`InnoDB`表空间加密；看[第 15.13 节，“InnoDB 静态数据加密”](innodb-data-encryption.html).文件丢失会导致此类表中的数据无法访问。（允许重命名或移动文件，只要更改[`密钥环文件数据`](keyring-system-variables.html#sysvar_keyring_file_data)匹配。）建议您在创建第一个加密表之后以及主密钥轮换前后立即创建密钥环数据文件的单独备份。

-   [](<>) [`keyring_hashicorp_auth_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_auth_path)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-auth-path=值` |
    | ----- | --------------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_auth_path](keyring-system-variables.html#sysvar_keyring_hashicorp_auth_path)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `/v1/auth/approle/登录` |

    在 HashiCorp Vault 服务器中启用 AppRole 身份验证的身份验证路径，供`keyring_hashicorp`插入。除非安装了该插件，否则此变量不可用。

-   [](<>) [`keyring_hashicorp_ca_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_ca_path)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-ca-path=file_name` |
    | ----- | --------------------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_ca_path](keyring-system-variables.html#sysvar_keyring_hashicorp_ca_path)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `空字符串` |

    MySQL 服务器可访问的本地文件的绝对路径名，其中包含格式正确的 TLS 证书颁发机构，供`keyring_hashicorp`插入。除非安装了该插件，否则此变量不可用。

    如果未设置此变量，则`keyring_hashicorp`插件在不使用服务器证书验证的情况下打开 HTTPS 连接，并信任 HashiCorp Vault 服务器提供的任何证书。为了安全起见，必须假设 Vault 服务器不是恶意的，并且不可能进行中间人攻击。如果这些假设无效，则设置[`keyring_hashicorp_ca_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_ca_path)到受信任的 CA 证书的路径。（例如，对于[证书和密钥准备](keyring-hashicorp-plugin.html#keyring-hashicorp-certificate-configuration)，这是`公司.crt`文件。）

-   [](<>) [`keyring_hashicorp_caching`](keyring-system-variables.html#sysvar_keyring_hashicorp_caching)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-caching[={OFF|ON}]` |
    | ----- | ---------------------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_caching](keyring-system-variables.html#sysvar_keyring_hashicorp_caching)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 布尔值 |
    | 默认值 | `离开` |

    是否启用由`keyring_hashicorp`用于缓存 HashiCorp Vault 服务器中的密钥的插件。除非安装了该插件，否则此变量不可用。如果启用了缓存，插件会在初始化期间填充它。否则，插件在初始化期间仅填充密钥列表。

    启用缓存是一种折衷方案：它提高了性能，但在内存中保留了敏感密钥信息的副本，出于安全目的，这可能是不可取的。

-   [](<>) [`keyring_hashicorp_commit_auth_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_auth_path)

    [](<>)[](<>)

    | 介绍 | 8.0.18 |
    | --- | ------ |
    | 系统变量 | `[keyring_hashicorp_commit_auth_path](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_auth_path)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    该变量与[`keyring_hashicorp_auth_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_auth_path)，它从中取值`keyring_hashicorp`插件初始化。除非安装了该插件，否则此变量不可用。如果初始化成功，它反映了实际用于插件操作的“提交”值。有关其他信息，请参阅[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

-   [](<>) [`keyring_hashicorp_commit_ca_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_ca_path)

    [](<>)[](<>)

    | 介绍 | 8.0.18 |
    | --- | ------ |
    | 系统变量 | `[keyring_hashicorp_commit_ca_path](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_ca_path)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    该变量与[`keyring_hashicorp_ca_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_ca_path)，它从中取值`keyring_hashicorp`插件初始化。除非安装了该插件，否则此变量不可用。如果初始化成功，它反映了实际用于插件操作的“提交”值。有关其他信息，请参阅[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

-   [](<>) [`keyring_hashicorp_commit_caching`](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_caching)

    [](<>)[](<>)

    | 介绍 | 8.0.18 |
    | --- | ------ |
    | 系统变量 | `[keyring_hashicorp_commit_caching](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_caching)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    该变量与[`keyring_hashicorp_caching`](keyring-system-variables.html#sysvar_keyring_hashicorp_caching)，它从中取值`keyring_hashicorp`插件初始化。除非安装了该插件，否则此变量不可用。如果初始化成功，它反映了实际用于插件操作的“提交”值。有关其他信息，请参阅[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

-   [](<>) [`keyring_hashicorp_commit_role_id`](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_role_id)

    [](<>)[](<>)

    | 介绍 | 8.0.18 |
    | --- | ------ |
    | 系统变量 | `[keyring_hashicorp_commit_role_id](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_role_id)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    该变量与[`keyring_hashicorp_role_id`](keyring-system-variables.html#sysvar_keyring_hashicorp_role_id)，它从中取值`keyring_hashicorp`插件初始化。除非安装了该插件，否则此变量不可用。如果初始化成功，它反映了实际用于插件操作的“提交”值。有关其他信息，请参阅[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

-   [](<>) [`keyring_hashicorp_commit_server_url`](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_server_url)

    [](<>)[](<>)

    | 介绍 | 8.0.18 |
    | --- | ------ |
    | 系统变量 | `[keyring_hashicorp_commit_server_url](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_server_url)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    该变量与[`keyring_hashicorp_server_url`](keyring-system-variables.html#sysvar_keyring_hashicorp_server_url)，它从中取值`keyring_hashicorp`插件初始化。除非安装了该插件，否则此变量不可用。如果初始化成功，它反映了实际用于插件操作的“提交”值。有关其他信息，请参阅[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

-   [](<>) [`keyring_hashicorp_commit_store_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_store_path)

    [](<>)[](<>)

    | 介绍 | 8.0.18 |
    | --- | ------ |
    | 系统变量 | `[keyring_hashicorp_commit_store_path](keyring-system-variables.html#sysvar_keyring_hashicorp_commit_store_path)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    该变量与[`keyring_hashicorp_store_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_store_path)，它从中取值`keyring_hashicorp`插件初始化。除非安装了该插件，否则此变量不可用。如果初始化成功，它反映了实际用于插件操作的“提交”值。有关其他信息，请参阅[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration).

-   [](<>) [`keyring_hashicorp_role_id`](keyring-system-variables.html#sysvar_keyring_hashicorp_role_id)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-role-id=值` |
    | ----- | ------------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_role_id](keyring-system-variables.html#sysvar_keyring_hashicorp_role_id)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `空字符串` |

    HashiCorp Vault AppRole 身份验证角色 ID，供`keyring_hashicorp`插入。除非安装了该插件，否则此变量不可用。该值必须采用 UUID 格式。

    这个变量是强制性的。如果没有指定，`keyring_hashicorp`初始化失败。

-   [](<>) [`keyring_hashicorp_secret_id`](keyring-system-variables.html#sysvar_keyring_hashicorp_secret_id)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-secret-id=值` |
    | ----- | --------------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_secret_id](keyring-system-variables.html#sysvar_keyring_hashicorp_secret_id)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `空字符串` |

    HashiCorp Vault AppRole 身份验证秘密 ID，供`keyring_hashicorp`插入。除非安装了该插件，否则此变量不可用。该值必须采用 UUID 格式。

    这个变量是强制性的。如果没有指定，`keyring_hashicorp`初始化失败。

    这个变量的值是敏感的，所以它的值被`*`显示时的字符。

-   [](<>) [`keyring_hashicorp_server_url`](keyring-system-variables.html#sysvar_keyring_hashicorp_server_url)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-server-url=值` |
    | ----- | ---------------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_server_url](keyring-system-variables.html#sysvar_keyring_hashicorp_server_url)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `https://127.0.0.1:8200` |

    HashiCorp Vault 服务器 URL，供`keyring_hashicorp`插入。除非安装了该插件，否则此变量不可用。值必须以`https://`.

-   [](<>) [`keyring_hashicorp_store_path`](keyring-system-variables.html#sysvar_keyring_hashicorp_store_path)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-hashicorp-存储路径=值` |
    | ----- | ---------------------------- |
    | 介绍 | 8.0.18 |
    | 系统变量 | `[keyring_hashicorp_store_path](keyring-system-variables.html#sysvar_keyring_hashicorp_store_path)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `空字符串` |

    HashiCorp Vault 服务器中的存储路径，当适当的 AppRole 凭据由`keyring_hashicorp`插入。除非安装了该插件，否则此变量不可用。要指定凭据，请设置[`keyring_hashicorp_role_id`](keyring-system-variables.html#sysvar_keyring_hashicorp_role_id)和[`keyring_hashicorp_secret_id`](keyring-system-variables.html#sysvar_keyring_hashicorp_secret_id)系统变量（例如，如图所示[钥匙圈\_hashcorp 配置](keyring-hashicorp-plugin.html#keyring-hashicorp-plugin-configuration)）。

    这个变量是强制性的。如果没有指定，`keyring_hashicorp`初始化失败。

-   [](<>) [`keyring_oci_ca_certificate`](keyring-system-variables.html#sysvar_keyring_oci_ca_certificate)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-ca-certificate=file_name` |
    | ----- | ---------------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_ca_certificate](keyring-system-variables.html#sysvar_keyring_oci_ca_certificate)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `空字符串` |

    CA 证书捆绑文件的路径名`密钥环_oci`插件用于 Oracle 云基础设施证书验证。除非安装了该插件，否则此变量不可用。

    该文件包含一个或多个用于对等验证的证书。如果未指定文件，则使用系统上安装的默认 CA 捆绑包。如果值为`禁用`（区分大小写），`密钥环_oci`不执行证书验证。

-   [](<>) [`keyring_oci_compartment`](keyring-system-variables.html#sysvar_keyring_oci_compartment)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-compartment=ocid` |
    | ----- | -------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_compartment](keyring-system-variables.html#sysvar_keyring_oci_compartment)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    租户隔间的 OCID`密钥环_oci`插件用作 MySQL 密钥的位置。除非安装了该插件，否则此变量不可用。

    使用前`密钥环_oci`，如果 MySQL 隔间或子隔间不存在，则必须创建它。此隔离专区不应包含保管库密钥或保管库机密。它不应该被 MySQL Keyring 以外的系统使用。

    有关管理隔离专区和获取 OCID 的信息，请参阅[管理隔间](https://docs.cloud.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_encryption_endpoint`](keyring-system-variables.html#sysvar_keyring_oci_encryption_endpoint)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-encryption-endpoint=值` |
    | ----- | ------------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_encryption_endpoint]（keyring-system-variables.html#sysvar_keyring_oci_encryption_endpoint）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure 加密服务器的端点，`密钥环_oci`插件用于为新密钥生成密文。除非安装了该插件，否则此变量不可用。

    加密端点是特定于保管库的，Oracle Cloud Infrastructure 在创建保管库时分配它。要获取端点 OCID，请查看您的配置详细信息`密钥环_oci`保险库，使用说明在[管理保管库](https://docs.cloud.oracle.com/en-us/iaas/Content/KeyManagement/Tasks/managingvaults.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_key_file`](keyring-system-variables.html#sysvar_keyring_oci_key_file)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-key-file=file_name` |
    | ----- | ---------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_key_file](keyring-system-variables.html#sysvar_keyring_oci_key_file)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    包含 RSA 私钥的文件的路径名`密钥环_oci`插件用于 Oracle Cloud Infrastructure 身份验证。除非安装了该插件，否则此变量不可用。

    您还必须使用控制台上传相应的 RSA 公钥。控制台显示密钥指纹值，您可以使用它来设置[`keyring_oci_key_fingerprint`](keyring-system-variables.html#sysvar_keyring_oci_key_fingerprint)系统变量。

    有关生成和上传 API 密钥的信息，请参阅[所需的密钥和 OCID](https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_key_fingerprint`](keyring-system-variables.html#sysvar_keyring_oci_key_fingerprint)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-key-fingerprint=值` |
    | ----- | --------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_key_fingerprint]（keyring-system-variables.html#sysvar_keyring_oci_key_fingerprint）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    RSA 私钥的指纹`密钥环_oci`插件用于 Oracle Cloud Infrastructure 身份验证。除非安装了该插件，否则此变量不可用。

    要在创建 API 密钥时获取密钥指纹，请执行以下命令：

    ```
    openssl rsa -pubout -outform DER -in ~/.oci/oci_api_key.pem | openssl md5 -c
    ```

    或者，从控制台获取指纹，当您上传 RSA 公钥时会自动显示指纹。

    有关获取密钥指纹的信息，请参阅[所需的密钥和 OCID](https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_management_endpoint`](keyring-system-variables.html#sysvar_keyring_oci_management_endpoint)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-management-endpoint=值` |
    | ----- | ------------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_management_endpoint]（keyring-system-variables.html#sysvar_keyring_oci_management_endpoint）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure 密钥管理服务器的端点，`密钥环_oci`插件用于列出现有密钥。除非安装了该插件，否则此变量不可用。

    密钥管理端点是特定于保管库的，Oracle Cloud Infrastructure 在创建保管库时分配它。要获取端点 OCID，请查看您的配置详细信息`密钥环_oci`保险库，使用说明在[管理保管库](https://docs.cloud.oracle.com/en-us/iaas/Content/KeyManagement/Tasks/managingvaults.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_master_key`](keyring-system-variables.html#sysvar_keyring_oci_master_key)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-master-key=ocid` |
    | ----- | ------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_master_key](keyring-system-variables.html#sysvar_keyring_oci_master_key)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure 主加密密钥的 OCID`密钥环_oci`插件用于秘密加密。除非安装了该插件，否则此变量不可用。

    使用前`密钥环_oci`，您必须为 Oracle Cloud Infrastructure 区间创建一个加密密钥（如果它不存在）。为生成的密钥提供特定于 MySQL 的名称，不要将其用于其他目的。

    有关密钥创建的信息，请参阅[管理密钥](https://docs.cloud.oracle.com/en-us/iaas/Content/KeyManagement/Tasks/managingkeys.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_secrets_endpoint`](keyring-system-variables.html#sysvar_keyring_oci_secrets_endpoint)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-secrets-endpoint=值` |
    | ----- | ---------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_secrets_endpoint]（keyring-system-variables.html#sysvar_keyring_oci_secrets_endpoint）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure 机密服务器的端点，`密钥环_oci`插件用于列出、创建和停用机密。除非安装了该插件，否则此变量不可用。

    机密端点是特定于保管库的，Oracle Cloud Infrastructure 在创建保管库时分配它。要获取端点 OCID，请查看您的配置详细信息`密钥环_oci`保险库，使用说明在[管理保管库](https://docs.cloud.oracle.com/en-us/iaas/Content/KeyManagement/Tasks/managingvaults.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_tenancy`](keyring-system-variables.html#sysvar_keyring_oci_tenancy)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-tenancy=ocid` |
    | ----- | ---------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_tenancy](keyring-system-variables.html#sysvar_keyring_oci_tenancy)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle 云基础设施租户的 OCID`密钥环_oci`插件用作 MySQL 隔间的位置。除非安装了该插件，否则此变量不可用。

    使用前`密钥环_oci`，如果不存在，您必须创建一个租约。要从控制台获取租户 OCID，请使用以下说明[所需的密钥和 OCID](https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_user`](keyring-system-variables.html#sysvar_keyring_oci_user)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-user=ocid` |
    | ----- | ------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_user](keyring-system-variables.html#sysvar_keyring_oci_user)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure 用户的 OCID`密钥环_oci`插件用于云连接。除非安装了该插件，否则此变量不可用。

    使用前`密钥环_oci`，此用户必须存在并被授予使用配置的 Oracle Cloud Infrastructure 租赁、隔离专区和保管库资源的访问权限。

    要从控制台获取用户 OCID，请使用以下说明[所需的密钥和 OCID](https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_vaults_endpoint`](keyring-system-variables.html#sysvar_keyring_oci_vaults_endpoint)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-vaults-endpoint=值` |
    | ----- | --------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_vaults_endpoint]（keyring-system-variables.html#sysvar_keyring_oci_vaults_endpoint）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure 保管库服务器的端点，`密钥环_oci`插件用于获取秘密的值。除非安装了该插件，否则此变量不可用。

    保管库端点是特定于保管库的，Oracle Cloud Infrastructure 在创建保管库时分配它。要获取端点 OCID，请查看您的配置详细信息`密钥环_oci`保险库，使用说明在[管理保管库](https://docs.cloud.oracle.com/en-us/iaas/Content/KeyManagement/Tasks/managingvaults.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_oci_virtual_vault`](keyring-system-variables.html#sysvar_keyring_oci_virtual_vault)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-oci-virtual-vault=ocid` |
    | ----- | ---------------------------------- |
    | 介绍 | 8.0.22 |
    | 系统变量 | `[keyring_oci_virtual_vault]（keyring-system-variables.html#sysvar_keyring_oci_virtual_vault）` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |

    Oracle Cloud Infrastructure Vault 的 OCID`密钥环_oci`插件用于加密操作。除非安装了该插件，否则此变量不可用。

    使用前`密钥环_oci`，如果 MySQL 隔离专区不存在，您必须在它中创建一个新的 vault。（或者，您可以重用 MySQL 隔离专区的父隔离专区中的现有 Vault。）隔离专区用户只能查看和使用其各自隔离专区中的密钥。

    有关创建保管库和获取保管库 OCID 的信息，请参阅[管理保管库](https://docs.cloud.oracle.com/en-us/iaas/Content/KeyManagement/Tasks/managingvaults.htm).

    这个变量是强制性的。如果没有指定，`密钥环_oci`初始化失败。

-   [](<>) [`keyring_okv_conf_dir`](keyring-system-variables.html#sysvar_keyring_okv_conf_dir)

    [](<>)[](<>)

    | 命令行格式 | `--keyring-okv-conf-dir=dir_name` |
    | ----- | --------------------------------- |
    | 系统变量 | `[keyring_okv_conf_dir](keyring-system-variables.html#sysvar_keyring_okv_conf_dir)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 目录名称 |
    | 默认值 | `空字符串` |

    存储配置信息的目录的路径名`密钥环_okv`插入。除非安装了该插件，否则此变量不可用。该位置应该是一个只供用户使用的目录`密钥环_okv`插入。例如，不要定位到数据目录下的目录。

    默认[`keyring_okv_conf_dir`](keyring-system-variables.html#sysvar_keyring_okv_conf_dir)值为空。为了`密钥环_okv`插件才能访问 Oracle Key Vault，该值必须设置为包含 Oracle Key Vault 配置和 SSL 材料的目录。有关设置此目录的说明，请参阅[第 6.4.4.8 节，“使用密钥环\_okv KMIP 插件”](keyring-okv-plugin.html).

    该目录应具有限制模式，并且只能由用于运行 MySQL 服务器的帐户访问。例如，在 Unix 和类 Unix 系统上，使用`/usr/local/mysql/mysql-keyring-okv`目录，以下命令（执行为`根`) 创建目录并设置其模式和所有权：

    ```
    cd /usr/local/mysql
    mkdir mysql-keyring-okv
    chmod 750 mysql-keyring-okv
    chown mysql mysql-keyring-okv
    chgrp mysql mysql-keyring-okv
    ```

    如果赋值给[`keyring_okv_conf_dir`](keyring-system-variables.html#sysvar_keyring_okv_conf_dir)指定一个不存在的目录，或者不包含能够建立与 Oracle Key Vault 的连接的配置信息，`密钥环_okv`将错误消息写入错误日志。如果尝试将运行时分配给[`keyring_okv_conf_dir`](keyring-system-variables.html#sysvar_keyring_okv_conf_dir)导致错误，变量值和密钥环操作保持不变。

-   [](<>) [`密钥环操作`](keyring-system-variables.html#sysvar_keyring_operations)

    [](<>)[](<>)

    | 系统变量 | `[keyring_operations](keyring-system-variables.html#sysvar_keyring_operations)` |
    | ---- | ------------------------------------------------------------------------------- |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 布尔值 |
    | 默认值 | `在` |

    是否启用密钥环操作。此变量在密钥迁移操作期间使用。看[第 6.4.4.13 节，“在密钥环密钥库之间迁移密钥”](keyring-key-migration.html).修改此变量所需的权限是[`ENCRYPTION_KEY_ADMIN`](privileges-provided.html#priv_encryption-key-admin)除了[`SYSTEM_VARIABLES_ADMIN`](privileges-provided.html#priv_system-variables-admin)或已弃用的[`极好的`](privileges-provided.html#priv_super)特权。
