KV().Del

KV().Del#

static inline void YR::KVManager::Del(const std::string &key, const DelParam &delParam = {})#

删除一个键及其关联的数据，类似于 Redis 的 DEL 命令。

此函数移除指定的键及其关联的数据。如果键不存在，操作也被视为成功。

参数：

  • key - 要删除的键。如果键不存在，操作也被视为成功。

  • delParam - 删除操作的可选参数，例如自定义追踪 ID。

抛出：

Exception - 在集群模式下，如果删除操作失败，则会抛出异常。

static inline std::vector<std::string> YR::KVManager::Del(const std::vector<std::string> &keys, const DelParam &delParam = {})#

删除多个键及其关联的数据，类似于 Redis 的 DEL 命令。

此函数移除指定的键及其关联的数据。如果某个键不存在，对该键的操作也被视为成功。

int main() {
    YR::Config conf;
    conf.mode = Config::Mode::CLUSTER_MODE;
    YR::Init(conf);
    std::vector<std::string> keys{ "key1", "key2" };
    std::vector<std::string> values{ "val1", "val2" };
    YR::KV().Set(keys[0], values[0]);
    YR::KV().Set(keys[1], values[1]);

    std::vector<std::string> failedKeys = YR::KV().Del(keys);
    if (!failedKeys.empty()) {
        std::cout << "Failed to delete the following keys: ";
        for (const auto& key : failedKeys) {
            std::cout << key << " ";
        }
        std::cout << std::endl;
    } else {
        std::cout << "All keys deleted successfully." << std::endl;
    }
    return 0;
}
参数：

  • key - 要删除的键列表。键的最大数量为 10000。如果某个键不存在，对该键的操作也被视为成功。

  • delParam - 删除操作的可选参数，例如自定义追踪 ID。

抛出：

Exception - 在集群模式下，如果在删除操作期间连接到数据系统的操作超时，则会抛出异常。

返回：

std::vector<std::string>，一个包含未能成功删除的键的向量。如果所有键都成功删除，则该向量为空。

参数结构补充说明如下：

struct DelParam#

指定要删除的键的参数，例如设置追踪 ID。

公共成员

std::string traceId#

traceId

自定义追踪 ID，用于故障排除和性能优化；仅在云环境中支持；在云环境之外的设置不会生效。 最大长度为 36。有效字符必须符合正则表达式：^[a-zA-Z0-9\~\.\-\/_!@#%\^\&\*\(\)\+\=\:;]*$。

Contents