aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/clickhouse/src/Backups/BackupCoordinationReplicatedAccess.h
blob: 9ed9e62c21a2e692d1e6beec2fbea74ab8f98318 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
#pragma once

#include <Core/Types.h>
#include <map>
#include <unordered_set>


namespace DB
{
enum class AccessEntityType;

/// This class is used by hosts to coordinate the access entities of ReplicatedAccessStorage they're writing to a backup.
/// It's designed to make all hosts save the same access entities to the backup even in case the ReplicatedAccessStorage changes
/// while the backup is being produced. This is important to make RESTORE more predicitible.
///
/// For example, let's consider three replicas having a ReplicatedAccessStorage on them.
/// This class ensures that the following files in the backup are the same:
/// /shards/1/replicas/1/data/system/users/access01.txt
/// /shards/1/replicas/2/data/system/users/access01.txt
/// /shards/1/replicas/3/data/system/users/access01.txt
///
/// To implement that this class chooses one host to write access entities for all the hosts so in fact all those files
/// in the example above are written by the same host.

class BackupCoordinationReplicatedAccess
{
public:
    BackupCoordinationReplicatedAccess();
    ~BackupCoordinationReplicatedAccess();

    struct FilePathForAccessEntitry
    {
        String access_zk_path;
        AccessEntityType access_entity_type;
        String host_id;
        String file_path;
    };

    /// Adds a path to access*.txt file keeping access entities of a ReplicatedAccessStorage.
    void addFilePath(FilePathForAccessEntitry && file_path_for_access_entity);

    /// Returns all paths added by addFilePath() if `host_id` is a host chosen to store access.
    Strings getFilePaths(const String & access_zk_path, AccessEntityType access_entity_type, const String & host_id) const;

private:
    using ZkPathAndEntityType = std::pair<String, AccessEntityType>;

    struct FilePathsAndHost
    {
        std::unordered_set<String> file_paths;
        String host_to_store_access;
    };

    std::map<ZkPathAndEntityType, FilePathsAndHost> file_paths_by_zk_path;
};

}