#pragma once #include #include #include #include namespace DB { using MergeTreeReadTaskPtr = std::unique_ptr; /** Provides read tasks for MergeTreeThreadBlockInputStream`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, MergeTreeData & data, const ExpressionActionsPtr & prewhere_actions, const String & prewhere_column_name, 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); /** 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); private: std::vector fillPerPartInfo( RangesInDataParts & parts, const ExpressionActionsPtr & prewhere_actions, const String & prewhere_column_name, 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); std::vector> per_part_columns_lock; MergeTreeData & data; 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; /// @todo actually all of these values are either true or false for the whole query, thus no vector required std::vector per_part_remove_prewhere_column; std::vector per_part_should_reorder; std::vector per_part_size_predictor; struct Part { MergeTreeData::DataPartPtr data_part; size_t part_index_in_query; }; std::vector parts; 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; mutable std::mutex mutex; Logger * log = &Logger::get("MergeTreeReadPool"); }; using MergeTreeReadPoolPtr = std::shared_ptr; }