#pragma once #include #include #include #include #include #include #include #include namespace Poco { namespace Util { class AbstractConfiguration; } } namespace DB { struct Settings; namespace ErrorCodes { extern const int LOGICAL_ERROR; } /// Cluster contains connection pools to each node /// With the local nodes, the connection is not established, but the request is executed directly. /// Therefore we store only the number of local nodes /// In the config, the cluster includes nodes or class Cluster { public: Cluster(const Poco::Util::AbstractConfiguration & config, const Settings & settings, const String & config_prefix_, const String & cluster_name); /// Construct a cluster by the names of shards and replicas. /// Local are treated as well as remote ones if treat_local_as_remote is true. /// Local are also treated as remote if treat_local_port_as_remote is set and the local address includes a port /// 'clickhouse_port' - port that this server instance listen for queries. /// This parameter is needed only to check that some address is local (points to ourself). /// /// Used for remote() function. Cluster( const Settings & settings, const std::vector> & names, const String & username, const String & password, UInt16 clickhouse_port, bool treat_local_as_remote, bool treat_local_port_as_remote, bool secure = false, Int64 priority = 1, String cluster_name = "", String cluster_secret = ""); Cluster(const Cluster &)= delete; Cluster & operator=(const Cluster &) = delete; /// is used to set a limit on the size of the timeout static Poco::Timespan saturate(Poco::Timespan v, Poco::Timespan limit); using SlotToShard = std::vector; struct Address { /** In configuration file, * addresses are located either in elements: * * example01-01-1 * 9000 * * * ... * or in and inside in elements: * * * example01-01-1 * 9000 * * * */ String host_name; UInt16 port{0}; String user; String password; String quota_key; /// For inter-server authorization String cluster; String cluster_secret; UInt32 shard_index{}; /// shard serial number in configuration file, starting from 1. UInt32 replica_index{}; /// replica serial number in this shard, starting from 1; zero means no replicas. /// This database is selected when no database is specified for Distributed table String default_database; /// The locality is determined at the initialization, and is not changed even if DNS is changed bool is_local = false; bool user_specified = false; Protocol::Compression compression = Protocol::Compression::Enable; Protocol::Secure secure = Protocol::Secure::Disable; Int64 priority = 1; Address() = default; Address( const Poco::Util::AbstractConfiguration & config, const String & config_prefix, const String & cluster_, const String & cluster_secret_, UInt32 shard_index_ = 0, UInt32 replica_index_ = 0); Address( const String & host_port_, const String & user_, const String & password_, UInt16 clickhouse_port, bool treat_local_port_as_remote, bool secure_ = false, Int64 priority_ = 1, UInt32 shard_index_ = 0, UInt32 replica_index_ = 0, String cluster_name = "", String cluster_secret_ = ""); /// Returns 'escaped_host_name:port' String toString() const; /// Returns 'host_name:port' String readableString() const; static String toString(const String & host_name, UInt16 port); static std::pair fromString(const String & host_port_string); /// Returns escaped shard{shard_index}_replica{replica_index} or escaped /// user:password@resolved_host_address:resolved_host_port#default_database /// depending on use_compact_format flag String toFullString(bool use_compact_format) const; /// Returns address with only shard index and replica index or full address without shard index and replica index static Address fromFullString(const String & address_full_string); /// Returns resolved address if it does resolve. std::optional getResolvedAddress() const; auto tuple() const { return std::tie(host_name, port, secure, user, password, default_database); } bool operator==(const Address & other) const { return tuple() == other.tuple(); } private: bool isLocal(UInt16 clickhouse_port) const; }; using Addresses = std::vector
; using AddressesWithFailover = std::vector; /// Name of directory for asynchronous write to StorageDistributed if has_internal_replication /// /// Contains different path for permutations of: /// - prefer_localhost_replica /// Notes with prefer_localhost_replica==0 will contains local nodes. /// - use_compact_format_in_distributed_parts_names /// See toFullString() /// /// This is cached to avoid looping by replicas in insertPathForInternalReplication(). struct ShardInfoInsertPathForInternalReplication { /// prefer_localhost_replica == 1 && use_compact_format_in_distributed_parts_names=0 std::string prefer_localhost_replica; /// prefer_localhost_replica == 0 && use_compact_format_in_distributed_parts_names=0 std::string no_prefer_localhost_replica; /// use_compact_format_in_distributed_parts_names=1 std::string compact; }; struct ShardInfo { public: bool isLocal() const { return !local_addresses.empty(); } bool hasRemoteConnections() const { return local_addresses.size() != per_replica_pools.size(); } size_t getLocalNodeCount() const { return local_addresses.size(); } size_t getRemoteNodeCount() const { return per_replica_pools.size() - local_addresses.size(); } size_t getAllNodeCount() const { return per_replica_pools.size(); } bool hasInternalReplication() const { return has_internal_replication; } /// Name of directory for asynchronous write to StorageDistributed if has_internal_replication const std::string & insertPathForInternalReplication(bool prefer_localhost_replica, bool use_compact_format) const; ShardInfoInsertPathForInternalReplication insert_path_for_internal_replication; /// Number of the shard, the indexation begins with 1 UInt32 shard_num = 0; UInt32 weight = 1; Addresses local_addresses; Addresses all_addresses; /// nullptr if there are no remote addresses ConnectionPoolWithFailoverPtr pool; /// Connection pool for each replica, contains nullptr for local replicas ConnectionPoolPtrs per_replica_pools; bool has_internal_replication = false; }; using ShardsInfo = std::vector; const ShardsInfo & getShardsInfo() const { return shards_info; } const AddressesWithFailover & getShardsAddresses() const { return addresses_with_failover; } /// Returns addresses of some replicas according to specified `only_shard_num` and `only_replica_num`. /// `only_shard_num` is 1-based index of a shard, 0 means all shards. /// `only_replica_num` is 1-based index of a replica, 0 means all replicas. std::vector filterAddressesByShardOrReplica(size_t only_shard_num, size_t only_replica_num) const; const ShardInfo & getAnyShardInfo() const { if (shards_info.empty()) throw Exception("Cluster is empty", ErrorCodes::LOGICAL_ERROR); return shards_info.front(); } /// The number of remote shards. size_t getRemoteShardCount() const { return remote_shard_count; } /// The number of clickhouse nodes located locally /// we access the local nodes directly. size_t getLocalShardCount() const { return local_shard_count; } /// The number of all shards. size_t getShardCount() const { return shards_info.size(); } /// Returns an array of arrays of strings in the format 'escaped_host_name:port' for all replicas of all shards in the cluster. std::vector getHostIDs() const; const String & getSecret() const { return secret; } /// Get a subcluster consisting of one shard - index by count (from 0) of the shard of this cluster. std::unique_ptr getClusterWithSingleShard(size_t index) const; /// Get a subcluster consisting of one or multiple shards - indexes by count (from 0) of the shard of this cluster. std::unique_ptr getClusterWithMultipleShards(const std::vector & indices) const; /// Get a new Cluster that contains all servers (all shards with all replicas) from existing cluster as independent shards. std::unique_ptr getClusterWithReplicasAsShards(const Settings & settings) const; /// Returns false if cluster configuration doesn't allow to use it for cross-replication. /// NOTE: true does not mean, that it's actually a cross-replication cluster. bool maybeCrossReplication() const; private: SlotToShard slot_to_shard; public: const SlotToShard & getSlotToShard() const { return slot_to_shard; } private: void initMisc(); /// For getClusterWithMultipleShards implementation. struct SubclusterTag {}; Cluster(SubclusterTag, const Cluster & from, const std::vector & indices); /// For getClusterWithReplicasAsShards implementation struct ReplicasAsShardsTag {}; Cluster(ReplicasAsShardsTag, const Cluster & from, const Settings & settings); /// Inter-server secret String secret; /// Description of the cluster shards. ShardsInfo shards_info; /// Any remote shard. ShardInfo * any_remote_shard_info = nullptr; /// Non-empty is either addresses or addresses_with_failover. /// The size and order of the elements in the corresponding array corresponds to shards_info. /// An array of shards. For each shard, an array of replica addresses (servers that are considered identical). AddressesWithFailover addresses_with_failover; size_t remote_shard_count = 0; size_t local_shard_count = 0; String name; }; using ClusterPtr = std::shared_ptr; class Clusters { public: Clusters(const Poco::Util::AbstractConfiguration & config, const Settings & settings, MultiVersion::Version macros, const String & config_prefix = "remote_servers"); Clusters(const Clusters &) = delete; Clusters & operator=(const Clusters &) = delete; ClusterPtr getCluster(const std::string & cluster_name) const; void setCluster(const String & cluster_name, const ClusterPtr & cluster); void updateClusters(const Poco::Util::AbstractConfiguration & new_config, const Settings & settings, const String & config_prefix, Poco::Util::AbstractConfiguration * old_config = nullptr); using Impl = std::map; Impl getContainer() const; protected: /// setup outside of this class, stored to prevent deleting from impl on config update std::unordered_set automatic_clusters; MultiVersion::Version macros_; Impl impl; mutable std::mutex mutex; }; }