Как использовать пессимистичную блокировку Couchbase с C API?

Спасибо за вопрос

Время в секундах, обратите внимание, что сервер может сбросить время на значение по умолчанию, если оно больше максимального времени (оба значения можно настроить). Следующая команда поможет определить эффективные значения функции.

$ cbstats -u Administrator -p password  localhost all | grep ep_getl
ep_getl_default_timeout:                               15
ep_getl_max_timeout:                                   30

Чтобы заблокировать ключ, необходимо использовать операцию получения и установить время блокировки с помощью lcb_cmdget_locktime и захватить значение CAS в случае успешной блокировки, например, как это

struct my_result {
    lcb_STATUS status{LCB_SUCCESS};
    uint64_t cas{0};
};

static void get_callback(lcb_INSTANCE *instance, lcb_CALLBACK_TYPE, const lcb_RESPGET *resp)
{
    my_result *res = nullptr;
    lcb_respget_cookie(resp, (void **)&res);
    res->status = lcb_respget_status(resp);
    if (res->status == LCB_SUCCESS) {
        lcb_respget_cas(resp, &res->cas);
    }
}

Хорошая идея - поместить команду get с кодом блокировки в цикл

uint64_t locked_cas{0};
int retries = 3;
while (retries > 0) {
    std::string document_id{"foo"};
    my_result result{};
    lcb_CMDGET* cmd = nullptr;
    lcb_cmdget_create(&cmd);
    lcb_cmdget_key(cmd, document_id.c_str(), document_id.size());
    lcb_cmdget_locktime(cmd, 5);
    lcb_get(instance, &result, cmd);
    lcb_cmdget_destroy(cmd);
    lcb_wait(instance, LCB_WAIT_DEFAULT);

    if (result.rc == LCB_SUCCESS) {
        locked_cas = result.cas;
        break;
    } else if (result.rc == LCB_ERR_DOCUMENT_LOCKED || result.rc == LCB_ERR_TEMPORARY_FAILURE) {
        std::this_thread::sleep_for(std::chrono::milliseconds(100));
        --retries;
        continue;
    } else {
        std::cerr << "Unexpected issue during get with lock: " << lcb_strerror_short(result.rc) << "\n";
        break;
    }
}

После блокировки ключа операция обновления может быть выполнена, но имейте в виду, что она ДОЛЖНА использовать locked_cas, иначе операция мутации завершится неудачно.

std::string document_id{"foo"};
std::string new_value{"new value"};
lcb_CMDSTORE* cmd = nullptr;
lcb_cmdstore_create(&cmd, LCB_STORE_REPLACE);
lcb_cmdstore_key(cmd, document_id.c_str(), document_id.size());
lcb_cmdstore_value(cmd, new_value.c_str(), new_value.size());
lcb_cmdstore_cas(cmd, locked_cas);
lcb_store(instance, nullptr, cmd);
lcb_cmdstore_destroy(cmd);
lcb_wait(instance, LCB_WAIT_DEFAULT);

Чтобы разблокировать ключ, вам также понадобится locked_cas, или просто подождите, пока сервер автоматически разблокирует документ.

std::string document_id{"foo"};
lcb_CMDUNLOCK *cmd = nullptr;
lcb_cmdunlock_create(&cmd);
lcb_cmdunlock_key(cmd, document_id.c_str(), document_id.size());
lcb_cmdunlock_cas(cmd, locked_cas);
lcb_unlock(instance, nullptr, cmd);
lcb_cmdunlock_destroy(cmd);
lcb_wait(instance, LCB_WAIT_DEFAULT);