/* * Copyright (C) 2019-present ScyllaDB */ /* * SPDX-License-Identifier: LicenseRef-ScyllaDB-Source-Available-1.1 */ #pragma once #include #include #include #include "seastarx.hh" namespace cdc { enum class delta_mode : uint8_t { keys, full, }; /** * (for now only pre-) image collection mode. * Stating how much info to record. * off == none * on == changed columns * full == all (changed and unmodified columns) */ enum class image_mode : uint8_t { off, on, full, }; class options final { std::optional _enabled; bool _enable_requested = false; // When CDC is employed for the purpose of Alternator Streams and tablets are used, // tablet merges need to be blocked due to limitations of DynamoDB Streams API. // DynamoDB Streams allows to specify a single parent for a stream. // In ScyllaDB, there is a one-to-one association between streams and tablets, // so merging tablets means also merging streams. A merged stream has two parents and both // need to be done reading from before reading from the newly merged tablet. This is impossible // to be conveyed with DynamoDB Streams API and the result can be reordering of events in Streams. bool _tablet_merge_blocked = false; image_mode _preimage = image_mode::off; bool _postimage = false; delta_mode _delta_mode = delta_mode::full; int _ttl = 86400; // 24h in seconds public: options() = default; options(const std::map& map); std::map to_map() const; sstring to_sstring() const; bool enabled() const { return _enabled.value_or(false); } bool is_enabled_set() const { return _enabled.has_value(); } bool enable_requested() const { return _enable_requested; } bool tablet_merge_blocked() const { return _tablet_merge_blocked; } bool preimage() const { return _preimage != image_mode::off; } bool full_preimage() const { return _preimage == image_mode::full; } bool postimage() const { return _postimage; } delta_mode get_delta_mode() const { return _delta_mode; } void set_delta_mode(delta_mode m) { _delta_mode = m; } int ttl() const { return _ttl; } void enabled(bool b) { _enabled = b; } // For the cases when enabling cannot be immediately enforced, like with Alternator Streams // which is incompatible with tablet merges, we need to be able to defer actual enablement // until any in-progress tablet merges complete. We expect that finalization happens // promptly: on_update_column_family callback in topology_coordinator.cc wakes up // the topology coordinator to run maybe_finalize_pending_stream_enables shortly // after the DDL. However, there is SCYLLADB-1304 void enable_requested(bool b = true) { _enable_requested = b; } // Persistent flag checked by the tablet allocator to suppress new merge // decisions. Always set when Alternator Streams are enabled; inert on // vnode tables. void tablet_merge_blocked(bool b = true) { _tablet_merge_blocked = b; } void preimage(bool b) { preimage(b ? image_mode::on : image_mode::off); } void preimage(image_mode m) { _preimage = m; } void postimage(bool b) { _postimage = b; } void ttl(int v) { _ttl = v; } bool operator==(const options& o) const; }; } // namespace cdc template <> struct fmt::formatter : fmt::formatter { auto format(cdc::image_mode, fmt::format_context& ctx) const -> decltype(ctx.out()); }; template <> struct fmt::formatter : fmt::formatter { auto format(cdc::delta_mode, fmt::format_context& ctx) const -> decltype(ctx.out()); };