/* Copyright (c) 2018 BlackBerry Limited Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ #pragma once #include #include #include #include #include #include #include #include namespace DB { /** Implements LIVE VIEW table WATCH EVENTS input stream. * Keeps stream alive by outputting blocks with no rows * based on period specified by the heartbeat interval. */ class LiveViewEventsBlockInputStream : public IBlockInputStream { using NonBlockingResult = std::pair; public: /// length default -2 because we want LIMIT to specify number of updates so that LIMIT 1 waits for 1 update /// and LIMIT 0 just returns data without waiting for any updates LiveViewEventsBlockInputStream(std::shared_ptr storage_, std::shared_ptr blocks_ptr_, std::shared_ptr blocks_metadata_ptr_, std::shared_ptr active_ptr_, const bool has_limit_, const UInt64 limit_, const UInt64 heartbeat_interval_sec_) : storage(std::move(storage_)), blocks_ptr(std::move(blocks_ptr_)), blocks_metadata_ptr(std::move(blocks_metadata_ptr_)), active_ptr(std::move(active_ptr_)), has_limit(has_limit_), limit(limit_), heartbeat_interval_usec(heartbeat_interval_sec_ * 1000000) { /// grab active pointer active = active_ptr.lock(); } String getName() const override { return "LiveViewEventsBlockInputStream"; } void cancel(bool kill) override { if (isCancelled() || storage->shutdown_called) return; IBlockInputStream::cancel(kill); std::lock_guard lock(storage->mutex); storage->condition.notify_all(); } Block getHeader() const override { return {ColumnWithTypeAndName(ColumnUInt64::create(), std::make_shared(), "version")}; } void refresh() { if (active && blocks && it == end) it = blocks->begin(); } void suspend() { active.reset(); } void resume() { active = active_ptr.lock(); { if (!blocks || blocks.get() != (*blocks_ptr).get()) { blocks = (*blocks_ptr); blocks_metadata = (*blocks_metadata_ptr); } } it = blocks->begin(); begin = blocks->begin(); end = blocks->end(); } NonBlockingResult tryRead() { return tryReadImpl(false); } Block getEventBlock() { Block res{ ColumnWithTypeAndName( DataTypeUInt64().createColumnConst(1, blocks_metadata->version)->convertToFullColumnIfConst(), std::make_shared(), "version") }; return res; } protected: Block readImpl() override { /// try reading return tryReadImpl(true).first; } /** tryRead method attempts to read a block in either blocking * or non-blocking mode. If blocking is set to false * then method return empty block with flag set to false * to indicate that method would block to get the next block. */ NonBlockingResult tryReadImpl(bool blocking) { if (has_limit && num_updates == static_cast(limit)) { return { Block(), true }; } /// If blocks were never assigned get blocks if (!blocks) { std::lock_guard lock(storage->mutex); if (!active) return { Block(), false }; blocks = (*blocks_ptr); blocks_metadata = (*blocks_metadata_ptr); it = blocks->begin(); begin = blocks->begin(); end = blocks->end(); } if (isCancelled() || storage->shutdown_called) { return { Block(), true }; } if (it == end) { { std::unique_lock lock(storage->mutex); if (!active) return { Block(), false }; /// If we are done iterating over our blocks /// and there are new blocks available then get them if (blocks.get() != (*blocks_ptr).get()) { blocks = (*blocks_ptr); blocks_metadata = (*blocks_metadata_ptr); it = blocks->begin(); begin = blocks->begin(); end = blocks->end(); } /// No new blocks available wait for new ones else { if (!blocking) { return { Block(), false }; } if (!end_of_blocks) { end_of_blocks = true; return { getHeader(), true }; } while (true) { UInt64 timestamp_usec = static_cast(timestamp.epochMicroseconds()); /// Or spurious wakeup. bool signaled = std::cv_status::no_timeout == storage->condition.wait_for(lock, std::chrono::microseconds(std::max(UInt64(0), heartbeat_interval_usec - (timestamp_usec - last_event_timestamp_usec)))); if (isCancelled() || storage->shutdown_called) { return { Block(), true }; } if (signaled) { break; } else { // repeat the event block as a heartbeat last_event_timestamp_usec = static_cast(timestamp.epochMicroseconds()); return { getHeader(), true }; } } } } return tryReadImpl(blocking); } // move right to the end it = end; end_of_blocks = false; num_updates += 1; last_event_timestamp_usec = static_cast(timestamp.epochMicroseconds()); return { getEventBlock(), true }; } private: std::shared_ptr storage; std::shared_ptr blocks_ptr; std::shared_ptr blocks_metadata_ptr; std::weak_ptr active_ptr; std::shared_ptr active; BlocksPtr blocks; BlocksMetadataPtr blocks_metadata; Blocks::iterator it; Blocks::iterator end; Blocks::iterator begin; const bool has_limit; const UInt64 limit; Int64 num_updates = -1; bool end_of_blocks = false; UInt64 heartbeat_interval_usec; UInt64 last_event_timestamp_usec = 0; Poco::Timestamp timestamp; }; }