#pragma once #include #include #include #include #include #include namespace DB { using MergeTreeReadTaskPtr = std::unique_ptr; /** Provides read tasks for MergeTreeThreadSelectBlockInputStream`s in fine-grained batches, allowing for more * uniform distribution of work amongst multiple threads. All parts and their ranges are divided into `threads` * workloads with at most `sum_marks / threads` marks. Then, threads are performing reads from these workloads * in "sequential" manner, requesting work in small batches. As soon as some thread has exhausted * it's workload, it either is signaled that no more work is available (`do_not_steal_tasks == false`) or * continues taking small batches from other threads' workloads (`do_not_steal_tasks == true`). */ class MergeTreeReadPool : private boost::noncopyable { public: /** Pull could dynamically lower (backoff) number of threads, if read operation are too slow. * Settings for that backoff. */ struct BackoffSettings { /// Pay attention only to reads, that took at least this amount of time. If set to 0 - means backoff is disabled. size_t min_read_latency_ms = 1000; /// Count events, when read throughput is less than specified bytes per second. size_t max_throughput = 1048576; /// Do not pay attention to event, if not enough time passed since previous event. size_t min_interval_between_events_ms = 1000; /// Number of events to do backoff - to lower number of threads in pool. size_t min_events = 2; /// Constants above is just an example. BackoffSettings(const Settings & settings) : min_read_latency_ms(settings.read_backoff_min_latency_ms.totalMilliseconds()), max_throughput(settings.read_backoff_max_throughput), min_interval_between_events_ms(settings.read_backoff_min_interval_between_events_ms.totalMilliseconds()), min_events(settings.read_backoff_min_events) { } BackoffSettings() : min_read_latency_ms(0) {} }; BackoffSettings backoff_settings; private: /** State to track numbers of slow reads. */ struct BackoffState { size_t current_threads; Stopwatch time_since_prev_event {CLOCK_MONOTONIC_COARSE}; size_t num_events = 0; BackoffState(size_t threads) : current_threads(threads) {} }; BackoffState backoff_state; public: MergeTreeReadPool( const size_t threads_, const size_t sum_marks_, const size_t min_marks_for_concurrent_read_, RangesInDataParts parts_, const MergeTreeData & data_, const StorageMetadataPtr & metadata_snapshot_, const PrewhereInfoPtr & prewhere_info_, const bool check_columns_, const Names & column_names_, const BackoffSettings & backoff_settings_, size_t preferred_block_size_bytes_, const bool do_not_steal_tasks_ = false); MergeTreeReadTaskPtr getTask(const size_t min_marks_to_read, const size_t thread, const Names & ordered_names); /** Each worker could call this method and pass information about read performance. * If read performance is too low, pool could decide to lower number of threads: do not assign more tasks to several threads. * This allows to overcome excessive load to disk subsystem, when reads are not from page cache. */ void profileFeedback(const ReadBufferFromFileBase::ProfileInfo info); /// This method tells which mark ranges we have to read if we start from @from mark range MarkRanges getRestMarks(const IMergeTreeDataPart & part, const MarkRange & from) const; Block getHeader() const; private: std::vector fillPerPartInfo( RangesInDataParts & parts, const bool check_columns); void fillPerThreadInfo( const size_t threads, const size_t sum_marks, std::vector per_part_sum_marks, RangesInDataParts & parts, const size_t min_marks_for_concurrent_read); const MergeTreeData & data; StorageMetadataPtr metadata_snapshot; Names column_names; bool do_not_steal_tasks; bool predict_block_size_bytes; std::vector per_part_column_name_set; std::vector per_part_columns; std::vector per_part_pre_columns; std::vector per_part_should_reorder; std::vector per_part_size_predictor; PrewhereInfoPtr prewhere_info; struct Part { MergeTreeData::DataPartPtr data_part; size_t part_index_in_query; }; std::vector parts_with_idx; struct ThreadTask { struct PartIndexAndRange { size_t part_idx; MarkRanges ranges; }; std::vector parts_and_ranges; std::vector sum_marks_in_parts; }; std::vector threads_tasks; std::set remaining_thread_tasks; RangesInDataParts parts_ranges; mutable std::mutex mutex; Poco::Logger * log = &Poco::Logger::get("MergeTreeReadPool"); }; using MergeTreeReadPoolPtr = std::shared_ptr; }