在 SQL 级别上，以一组可加载函数的形式，每个函数映射到服务例程的调用。

作为 C 语言接口，从服务器插件或可加载函数中可调用插件服务。

key_id：密钥 ID 或名称。key_id 值以 mysql_ 开头的值由 MySQL 服务器保留。

user_id：会话有效用户 ID。如果没有用户上下文，该值可以为 NULL。该值不一定是实际的“用户”；其含义取决于应用程序。

实现密钥环函数接口的函数将 CURRENT_USER() 的值作为 user_id 值传递给密钥环服务函数。

每个函数返回 0 表示成功，1 表示失败。

key_id 和 user_id 参数形成一个唯一的组合，指示密钥环中要使用的密钥。

key_type 参数提供了关于密钥的附加信息，例如其加密方法或预期用途。

密钥环服务函数将密钥 ID、用户名、类型和值视为二进制字符串，因此比较是区分大小写的。例如，ID MyKey 和 mykey 引用不同的密钥。

my_key_fetch()

从密钥环中检索和解密密钥，连同其类型。函数分配用于存储返回密钥和密钥类型的缓冲区内存。调用方应在不再需要时将内存清零或混淆，然后释放它。

语法：

bool my_key_fetch(const char *key_id, const char **key_type,
                  const char* user_id, void **key, size_t *key_len)

参数：

返回值：

返回 0 表示成功，1 表示失败。

my_key_generate()

生成一个新的随机密钥，并将其存储在密钥环中。该密钥的长度为 key_len，并与 key_id 和 user_id 组成的标识符相关联。类型和长度值必须与基础密钥环插件支持的值一致。请参阅 第 8.4.4.13 节，“支持的密钥环密钥类型和长度”。

语法：

bool my_key_generate(const char *key_id, const char *key_type,
                     const char *user_id, size_t key_len)

参数：

返回值：

返回 0 表示成功，1 表示失败。

my_key_remove()

从密钥环中删除密钥。

语法：

bool my_key_remove(const char *key_id, const char* user_id)

参数：

返回值：

成功返回 0，失败返回 1。

my_key_store()

对密钥进行混淆并将其存储在密钥环中。

语法：

bool my_key_store(const char *key_id, const char *key_type,
                  const char* user_id, void *key, size_t key_len)

参数：

返回值：

成功返回 0，失败返回 1。