#pragma once #include #include #include #include #include #include #include #include #include #include #include namespace DB { struct KeeperStorageRequestProcessor; using KeeperStorageRequestProcessorPtr = std::shared_ptr; using ResponseCallback = std::function; using ChildrenSet = absl::flat_hash_set; using SessionAndTimeout = std::unordered_map; struct KeeperStorageSnapshot; /// Keeper state machine almost equal to the ZooKeeper's state machine. /// Implements all logic of operations, data changes, sessions allocation. /// In-memory and not thread safe. class KeeperStorage { public: /// Node should have as minimal size as possible to reduce memory footprint /// of stored nodes /// New fields should be added to the struct only if it's really necessary struct Node { /// to reduce size of the Node struct we use a custom Stat without dataLength struct Stat { int64_t czxid{0}; int64_t mzxid{0}; int64_t ctime{0}; int64_t mtime{0}; int32_t version{0}; int32_t cversion{0}; int32_t aversion{0}; int32_t numChildren{0}; /// NOLINT int64_t ephemeralOwner{0}; /// NOLINT int64_t pzxid{0}; bool operator==(const Stat &) const = default; }; uint64_t acl_id = 0; /// 0 -- no ACL by default Stat stat{}; int32_t seq_num = 0; /// we cannot use `std::optional because we want to /// pack the boolean with seq_num above mutable bool has_cached_digest = false; mutable uint64_t cached_digest = 0; void setResponseStat(Coordination::Stat & response_stat) const; /// Object memory size uint64_t sizeInBytes() const; void setData(String new_data); const auto & getData() const noexcept { return data; } void addChild(StringRef child_path); void removeChild(StringRef child_path); const auto & getChildren() const noexcept { return children; } // Invalidate the calculated digest so it's recalculated again on the next // getDigest call void invalidateDigestCache() const; // get the calculated digest of the node UInt64 getDigest(std::string_view path) const; // copy only necessary information for preprocessing and digest calculation // (e.g. we don't need to copy list of children) void shallowCopy(const Node & other); private: String data; ChildrenSet children{}; }; enum DigestVersion : uint8_t { NO_DIGEST = 0, V1 = 1, V2 = 2 // added system nodes that modify the digest on startup so digest from V0 is invalid }; static constexpr auto CURRENT_DIGEST_VERSION = DigestVersion::V2; struct ResponseForSession { int64_t session_id; Coordination::ZooKeeperResponsePtr response; }; using ResponsesForSessions = std::vector; struct Digest { DigestVersion version{DigestVersion::NO_DIGEST}; uint64_t value{0}; }; static bool checkDigest(const Digest & first, const Digest & second) { if (first.version != second.version) return true; if (first.version == DigestVersion::NO_DIGEST) return true; return first.value == second.value; } static String generateDigest(const String & userdata); struct RequestForSession { int64_t session_id; int64_t time{0}; Coordination::ZooKeeperRequestPtr request; int64_t zxid{0}; std::optional digest; int64_t log_idx{0}; }; struct AuthID { std::string scheme; std::string id; bool operator==(const AuthID & other) const { return scheme == other.scheme && id == other.id; } }; using RequestsForSessions = std::vector; using Container = SnapshotableHashTable; using Ephemerals = std::unordered_map>; using SessionAndWatcher = std::unordered_map>; using SessionIDs = std::unordered_set; /// Just vector of SHA1 from user:password using AuthIDs = std::vector; using SessionAndAuth = std::unordered_map; using Watches = std::unordered_map; int64_t session_id_counter{1}; SessionAndAuth session_and_auth; /// Main hashtable with nodes. Contain all information about data. /// All other structures expect session_and_timeout can be restored from /// container. Container container; // Applying ZooKeeper request to storage consists of two steps: // - preprocessing which, instead of applying the changes directly to storage, // generates deltas with those changes, denoted with the request ZXID // - processing which applies deltas with the correct ZXID to the storage // // Delta objects allow us two things: // - fetch the latest, uncommitted state of an object by getting the committed // state of that same object from the storage and applying the deltas // in the same order as they are defined // - quickly commit the changes to the storage struct CreateNodeDelta { KeeperStorage::Node::Stat stat; Coordination::ACLs acls; String data; }; struct RemoveNodeDelta { int32_t version{-1}; int64_t ephemeral_owner{0}; }; struct UpdateNodeDelta { std::function update_fn; int32_t version{-1}; }; struct SetACLDelta { Coordination::ACLs acls; int32_t version{-1}; }; struct ErrorDelta { Coordination::Error error; }; struct FailedMultiDelta { std::vector error_codes; }; // Denotes end of a subrequest in multi request struct SubDeltaEnd { }; struct AddAuthDelta { int64_t session_id; AuthID auth_id; }; using Operation = std:: variant; struct Delta { Delta(String path_, int64_t zxid_, Operation operation_) : path(std::move(path_)), zxid(zxid_), operation(std::move(operation_)) { } Delta(int64_t zxid_, Coordination::Error error) : Delta("", zxid_, ErrorDelta{error}) { } Delta(int64_t zxid_, Operation subdelta) : Delta("", zxid_, subdelta) { } String path; int64_t zxid; Operation operation; }; struct UncommittedState { explicit UncommittedState(KeeperStorage & storage_) : storage(storage_) { } void addDelta(Delta new_delta); void addDeltas(std::vector new_deltas); void commit(int64_t commit_zxid); void rollback(int64_t rollback_zxid); std::shared_ptr getNode(StringRef path) const; Coordination::ACLs getACLs(StringRef path) const; void applyDelta(const Delta & delta); bool hasACL(int64_t session_id, bool is_local, std::function predicate) { const auto check_auth = [&](const auto & auth_ids) { for (const auto & auth : auth_ids) { using TAuth = std::remove_reference_t; const AuthID * auth_ptr = nullptr; if constexpr (std::is_pointer_v) auth_ptr = auth; else auth_ptr = &auth; if (predicate(*auth_ptr)) return true; } return false; }; if (is_local) return check_auth(storage.session_and_auth[session_id]); if (check_auth(storage.session_and_auth[session_id])) return true; // check if there are uncommitted const auto auth_it = session_and_auth.find(session_id); if (auth_it == session_and_auth.end()) return false; return check_auth(auth_it->second); } void forEachAuthInSession(int64_t session_id, std::function func) const; std::shared_ptr tryGetNodeFromStorage(StringRef path) const; std::unordered_map> session_and_auth; struct UncommittedNode { std::shared_ptr node{nullptr}; Coordination::ACLs acls{}; int64_t zxid{0}; }; struct Hash { auto operator()(const std::string_view view) const { SipHash hash; hash.update(view); return hash.get64(); } using is_transparent = void; // required to make find() work with different type than key_type }; struct Equal { auto operator()(const std::string_view a, const std::string_view b) const { return a == b; } using is_transparent = void; // required to make find() work with different type than key_type }; mutable std::unordered_map nodes; std::unordered_map, Hash, Equal> deltas_for_path; std::list deltas; KeeperStorage & storage; }; UncommittedState uncommitted_state{*this}; // Apply uncommitted state to another storage using only transactions // with zxid > last_zxid void applyUncommittedState(KeeperStorage & other, int64_t last_log_idx); Coordination::Error commit(int64_t zxid); // Create node in the storage // Returns false if it failed to create the node, true otherwise // We don't care about the exact failure because we should've caught it during preprocessing bool createNode( const std::string & path, String data, const KeeperStorage::Node::Stat & stat, Coordination::ACLs node_acls); // Remove node in the storage // Returns false if it failed to remove the node, true otherwise // We don't care about the exact failure because we should've caught it during preprocessing bool removeNode(const std::string & path, int32_t version); bool checkACL(StringRef path, int32_t permissions, int64_t session_id, bool is_local); void unregisterEphemeralPath(int64_t session_id, const std::string & path); /// Mapping session_id -> set of ephemeral nodes paths Ephemerals ephemerals; /// Mapping session_id -> set of watched nodes paths SessionAndWatcher sessions_and_watchers; /// Expiration queue for session, allows to get dead sessions at some point of time SessionExpiryQueue session_expiry_queue; /// All active sessions with timeout SessionAndTimeout session_and_timeout; /// ACLMap for more compact ACLs storage inside nodes. ACLMap acl_map; /// Global id of all requests applied to storage int64_t zxid{0}; // older Keeper node (pre V5 snapshots) can create snapshots and receive logs from newer Keeper nodes // this can lead to some inconsistencies, e.g. from snapshot it will use log_idx as zxid // while the log will have a smaller zxid because it's generated by the newer nodes // we save the value loaded from snapshot to know when is it okay to have // smaller zxid in newer requests int64_t old_snapshot_zxid{0}; struct TransactionInfo { int64_t zxid; Digest nodes_digest; /// index in storage of the log containing the transaction int64_t log_idx = 0; }; std::deque uncommitted_transactions; uint64_t nodes_digest{0}; bool finalized{false}; /// Currently active watches (node_path -> subscribed sessions) Watches watches; Watches list_watches; /// Watches for 'list' request (watches on children). void clearDeadWatches(int64_t session_id); /// Get current committed zxid int64_t getZXID() const { return zxid; } int64_t getNextZXID() const { if (uncommitted_transactions.empty()) return zxid + 1; return uncommitted_transactions.back().zxid + 1; } Digest getNodesDigest(bool committed) const; KeeperContextPtr keeper_context; const String superdigest; bool initialized{false}; KeeperStorage(int64_t tick_time_ms, const String & superdigest_, const KeeperContextPtr & keeper_context_, bool initialize_system_nodes = true); void initializeSystemNodes(); /// Allocate new session id with the specified timeouts int64_t getSessionID(int64_t session_timeout_ms) { auto result = session_id_counter++; session_and_timeout.emplace(result, session_timeout_ms); session_expiry_queue.addNewSessionOrUpdate(result, session_timeout_ms); return result; } /// Add session id. Used when restoring KeeperStorage from snapshot. void addSessionID(int64_t session_id, int64_t session_timeout_ms) { session_and_timeout.emplace(session_id, session_timeout_ms); session_expiry_queue.addNewSessionOrUpdate(session_id, session_timeout_ms); } UInt64 calculateNodesDigest(UInt64 current_digest, const std::vector & new_deltas) const; /// Process user request and return response. /// check_acl = false only when converting data from ZooKeeper. ResponsesForSessions processRequest( const Coordination::ZooKeeperRequestPtr & request, int64_t session_id, std::optional new_last_zxid, bool check_acl = true, bool is_local = false); void preprocessRequest( const Coordination::ZooKeeperRequestPtr & request, int64_t session_id, int64_t time, int64_t new_last_zxid, bool check_acl = true, std::optional digest = std::nullopt, int64_t log_idx = 0); void rollbackRequest(int64_t rollback_zxid, bool allow_missing); void finalize(); bool isFinalized() const; /// Set of methods for creating snapshots /// Turn on snapshot mode, so data inside Container is not deleted, but replaced with new version. void enableSnapshotMode(size_t up_to_version) { container.enableSnapshotMode(up_to_version); } /// Turn off snapshot mode. void disableSnapshotMode() { container.disableSnapshotMode(); } Container::const_iterator getSnapshotIteratorBegin() const { return container.begin(); } /// Clear outdated data from internal container. void clearGarbageAfterSnapshot() { container.clearOutdatedNodes(); } /// Get all active sessions const SessionAndTimeout & getActiveSessions() const { return session_and_timeout; } /// Get all dead sessions std::vector getDeadSessions() const { return session_expiry_queue.getExpiredSessions(); } /// Introspection functions mostly used in 4-letter commands uint64_t getNodesCount() const { return container.size(); } uint64_t getApproximateDataSize() const { return container.getApproximateDataSize(); } uint64_t getArenaDataSize() const { return container.keyArenaSize(); } uint64_t getTotalWatchesCount() const; uint64_t getWatchedPathsCount() const { return watches.size() + list_watches.size(); } uint64_t getSessionsWithWatchesCount() const; uint64_t getSessionWithEphemeralNodesCount() const { return ephemerals.size(); } uint64_t getTotalEphemeralNodesCount() const; void dumpWatches(WriteBufferFromOwnString & buf) const; void dumpWatchesByPath(WriteBufferFromOwnString & buf) const; void dumpSessionsAndEphemerals(WriteBufferFromOwnString & buf) const; void recalculateStats(); private: void removeDigest(const Node & node, std::string_view path); void addDigest(const Node & node, std::string_view path); }; using KeeperStoragePtr = std::unique_ptr; }