// Licensed to the Apache Software Foundation (ASF) under one

// or more contributor license agreements.  See the NOTICE file

// distributed with this work for additional information

// regarding copyright ownership.  The ASF licenses this file

// to you 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.

#include "load/memtable/memtable_writer.h"

#include <fmt/format.h>

#include <filesystem>

#include <ostream>

#include <string>

#include <utility>

#include "common/compiler_util.h" // IWYU pragma: keep

#include "common/config.h"

#include "common/logging.h"

#include "common/status.h"

#include "core/block/block.h"

#include "io/fs/file_writer.h" // IWYU pragma: keep

#include "load/memtable/memtable.h"

#include "load/memtable/memtable_flush_executor.h"

#include "load/memtable/memtable_memory_limiter.h"

#include "runtime/exec_env.h"

#include "runtime/memory/mem_tracker.h"

#include "service/backend_options.h"

#include "storage/rowset/beta_rowset_writer.h"

#include "storage/rowset/group_rowset_writer.h"

#include "storage/rowset/rowset_writer.h"

#include "storage/schema_change/schema_change.h"

#include "storage/storage_engine.h"

#include "storage/tablet/tablet_schema.h"

#include "storage/tablet_info.h"

#include "util/mem_info.h"

#include "util/stopwatch.hpp"

namespace doris {

bvar::Adder<uint64_t> g_flush_cuz_rowscnt_oveflow("flush_cuz_rowscnt_oveflow");

using namespace ErrorCode;

MemTableWriter::MemTableWriter(const WriteRequest& req) : _req(req) {}

MemTableWriter::~MemTableWriter() {

    if (!_is_init) {

        return;

    }

    if (_flush_token != nullptr) {

        // cancel and wait all memtables in flush queue to be finished

        _flush_token->cancel();

    }

    _mem_table.reset();

}

Status MemTableWriter::init(std::shared_ptr<RowsetWriter> rowset_writer,

                            TabletSchemaSPtr tablet_schema,

                            std::shared_ptr<PartialUpdateInfo> partial_update_info,

                            std::shared_ptr<WorkloadGroup> wg_sptr, bool unique_key_mow) {

    _rowset_writer = rowset_writer;

    _tablet_schema = tablet_schema;

    _unique_key_mow = unique_key_mow;

    _partial_update_info = partial_update_info;

    _resource_ctx = thread_context()->resource_ctx();

    _need_row_binlog_lsn = false;

    if (_req.table_schema_param != nullptr) {

        for (const auto* index_schema : _req.table_schema_param->indexes()) {

            if (index_schema->index_id == _req.index_id) {

                _need_row_binlog_lsn = index_schema->row_binlog_id > 0;

                break;

            }

        }

    }

    if (_need_row_binlog_lsn) {

        const auto keys_type = _tablet_schema->keys_type();

        if (keys_type == KeysType::AGG_KEYS ||

            (keys_type == KeysType::UNIQUE_KEYS && !_unique_key_mow)) {

            // Row-binlog LSN sidecar does not support MemTable aggregation now. For AGG tables

            // and unique key merge-on-read tables, multiple input rows can be merged into one

            // output row in MemTable, so their output LSN semantics should be implemented

            // explicitly before enabling row-binlog LSNs on these table types.

            return Status::NotSupported(

                    "row binlog lsn does not support AGG table or unique key merge-on-read table");

        }

    }

    _reset_mem_table();

    // create flush handler

    // by assigning segment_id to memtable before submiting to flush executor,

    // we can make sure same keys sort in the same order in all replicas.

    RETURN_IF_ERROR(

            ExecEnv::GetInstance()->storage_engine().memtable_flush_executor()->create_flush_token(

                    _flush_token, _rowset_writer, _req.is_high_priority, wg_sptr,

                    _req.table_schema_param));

    _is_init = true;

    return Status::OK();

}

Status MemTableWriter::write(const Block* block, const TabletAddRowsPayload& rows) {

    if (UNLIKELY(rows.row_idxs.empty())) {

        DCHECK(rows.row_binlog_lsns.empty());

        return Status::OK();

    }

    _lock_watch.start();

    std::lock_guard<std::mutex> l(_lock);

    _lock_watch.stop();

    if (_is_cancelled) {

        return _cancel_status;

    }

    if (!_is_init) {

        return Status::Error<NOT_INITIALIZED>("delta segment writer has not been initialized");

    }

    if (_is_closed) {

        return Status::Error<ALREADY_CLOSED>("write block after closed tablet_id={}, load_id={}-{}",

                                             _req.tablet_id, _req.load_id.hi(), _req.load_id.lo());

    }

    if (_need_row_binlog_lsn) {

        if (rows.row_binlog_lsns.empty()) {

            return Status::InternalError(

                    "row binlog lsn is missing for tablet_id={}, index_id={}, load_id={}-{}",

                    _req.tablet_id, _req.index_id, _req.load_id.hi(), _req.load_id.lo());

        }

        DCHECK(rows.row_binlog_lsns.size() == rows.row_idxs.size());

    }

    // Flush and reset memtable if it is raw rows great than int32_t.

    int64_t raw_rows = _mem_table->raw_rows();

    DBUG_EXECUTE_IF("MemTableWriter.too_many_raws",

                    { raw_rows = std::numeric_limits<int32_t>::max(); });

    if (raw_rows + rows.row_idxs.size() > std::numeric_limits<int32_t>::max()) {

        g_flush_cuz_rowscnt_oveflow << 1;

        RETURN_IF_ERROR(_flush_memtable());

    }

    _total_received_rows += rows.row_idxs.size();

    auto st = _mem_table->insert(block, rows);

    // Reset memtable immediately after insert failure to prevent potential flush operations.

    // This is a defensive measure because:

    // 1. When insert fails (e.g., memory allocation failure during add_rows),

    //    the memtable is in an inconsistent state and should not be flushed

    // 2. However, memory pressure might trigger a flush operation on this failed memtable

    // 3. By resetting here, we ensure the failed memtable won't be included in any subsequent flush,

    //    thus preventing potential crashes

    DBUG_EXECUTE_IF("MemTableWriter.write.random_insert_error", {

        if (rand() % 100 < (100 * dp->param("percent", 0.3))) {

            st = Status::InternalError<false>("write memtable random failed for debug");

        }

    });

    if (!st.ok()) [[unlikely]] {

        _reset_mem_table();

        return st;

    }

    if (UNLIKELY(_mem_table->need_agg() && config::enable_shrink_memory)) {

        _mem_table->shrink_memtable_by_agg();

    }

    if (UNLIKELY(_mem_table->need_flush())) {

        RETURN_IF_ERROR(_flush_memtable());

    }

    return Status::OK();

}

Status MemTableWriter::_flush_memtable() {

    auto s = _flush_memtable_async();

    _reset_mem_table();

    if (UNLIKELY(!s.ok())) {

        return s;

    }

    return Status::OK();

}

Status MemTableWriter::_flush_memtable_async() {

    DCHECK(_flush_token != nullptr);

    std::shared_ptr<MemTable> memtable;

    {

        std::lock_guard<std::mutex> l(_mem_table_ptr_lock);

        memtable = _mem_table;

        _mem_table = nullptr;

        memtable->update_mem_type(MemType::WRITE_FINISHED);

        _freezed_mem_tables.push_back(memtable);

    }

    return _flush_token->submit(memtable);

}

Status MemTableWriter::flush_async() {

    std::lock_guard<std::mutex> l(_lock);

    // Three calling paths:

    // 1. call by local, from `VTabletWriterV2::_write_memtable`.

    // 2. call by remote, from `LoadChannelMgr::_get_load_channel`.

    // 3. call by daemon thread, from `handle_paused_queries` -> `flush_workload_group_memtables`.

    SCOPED_SWITCH_THREAD_MEM_TRACKER_LIMITER(_resource_ctx->memory_context()->mem_tracker());

    if (!_is_init || _is_closed) {

        // This writer is uninitialized or closed before flushing, do nothing.

        // We return OK instead of NOT_INITIALIZED or ALREADY_CLOSED.

        // Because this method maybe called when trying to reduce mem consumption,

        // and at that time, the writer may not be initialized yet and that is a normal case.

        return Status::OK();

    }

    if (_is_cancelled) {

        return _cancel_status;

    }

    VLOG_NOTICE << "flush memtable to reduce mem consumption. memtable size: "

                << PrettyPrinter::print_bytes(_mem_table->memory_usage())

                << ", tablet: " << _req.tablet_id << ", load id: " << print_id(_req.load_id);

    auto s = _flush_memtable_async();

    _reset_mem_table();

    return s;

}

Status MemTableWriter::wait_flush() {

    {

        std::lock_guard<std::mutex> l(_lock);

        if (!_is_init || _is_closed) {

            // return OK instead of NOT_INITIALIZED or ALREADY_CLOSED for same reason

            // as described in flush_async()

            return Status::OK();

        }

        if (_is_cancelled) {

            return _cancel_status;

        }

    }

    SCOPED_RAW_TIMER(&_wait_flush_time_ns);

    RETURN_IF_ERROR(_flush_token->wait());

    return Status::OK();

}

void MemTableWriter::_reset_mem_table() {

    {

        std::lock_guard<std::mutex> l(_mem_table_ptr_lock);

        _mem_table.reset(new MemTable(_req.tablet_id, _tablet_schema, _req.slots, _req.tuple_desc,

                                      _unique_key_mow, _partial_update_info.get(), _resource_ctx,

                                      _need_row_binlog_lsn));

    }

    _segment_num++;

}

Status MemTableWriter::close() {

    _lock_watch.start();

    std::lock_guard<std::mutex> l(_lock);

    _lock_watch.stop();

    if (_is_cancelled) {

        return _cancel_status;

    }

    if (!_is_init) {

        return Status::Error<NOT_INITIALIZED>("delta segment writer has not been initialized");

    }

    if (_is_closed) {

        LOG(WARNING) << "close after closed tablet_id=" << _req.tablet_id

                     << " load_id=" << _req.load_id;

        return Status::OK();

    }

    auto s = _flush_memtable_async();

    {

        std::lock_guard<std::mutex> lm(_mem_table_ptr_lock);

        _mem_table.reset();

    }

    _is_closed = true;

    if (UNLIKELY(!s.ok())) {

        return s;

    } else {

        return Status::OK();

    }

}

Status MemTableWriter::_do_close_wait() {

    SCOPED_RAW_TIMER(&_close_wait_time_ns);

    std::lock_guard<std::mutex> l(_lock);

    DCHECK(_is_init)

            << "delta writer is supposed be to initialized before close_wait() being called";

    if (_is_cancelled) {

        return _cancel_status;

    }

    Status st;

    // return error if previous flush failed

    {

        SCOPED_RAW_TIMER(&_wait_flush_time_ns);

        st = _flush_token->wait();

    }

    if (UNLIKELY(!st.ok())) {

        LOG(WARNING) << "previous flush failed tablet " << _req.tablet_id;

        return st;

    }

    if (_rowset_writer->num_rows() + _flush_token->memtable_stat().merged_rows !=

        _total_received_rows) {

        LOG(WARNING) << "the rows number written doesn't match, rowset num rows written to file: "

                     << _rowset_writer->num_rows()

                     << ", merged_rows: " << _flush_token->memtable_stat().merged_rows

                     << ", total received rows: " << _total_received_rows;

        return Status::InternalError("rows number written by delta writer dosen't match");

    }

    // print slow log if wait more than 1s

    if (_wait_flush_time_ns > 1000UL * 1000 * 1000) {

        LOG(INFO) << "close delta writer for tablet: " << _req.tablet_id

                  << ", load id: " << print_id(_req.load_id) << ", wait close for "

                  << _wait_flush_time_ns << "(ns), stats: " << _flush_token->get_stats();

    }

    return Status::OK();

}

void MemTableWriter::_update_profile(RuntimeProfile* profile) {

    if (!profile) {

        return;

    }

    // NOTE: MemTableWriter may be accessed when profile is out of scope, in MemTableMemoryLimiter.

    // To avoid accessing dangling pointers, we cannot make profile as a member of MemTableWriter.

    auto child =

            profile->create_child(fmt::format("MemTableWriter {}", _req.tablet_id), true, true);

    auto lock_timer = ADD_TIMER(child, "LockTime");

    auto sort_timer = ADD_TIMER(child, "MemTableSortTime");

    auto agg_timer = ADD_TIMER(child, "MemTableAggTime");

    auto memtable_duration_timer = ADD_TIMER(child, "MemTableDurationTime");

    auto segment_writer_timer = ADD_TIMER(child, "SegmentWriterTime");

    auto wait_flush_timer = ADD_TIMER(child, "MemTableWaitFlushTime");

    auto put_into_output_timer = ADD_TIMER(child, "MemTablePutIntoOutputTime");

    auto delete_bitmap_timer = ADD_TIMER(child, "DeleteBitmapTime");

    auto close_wait_timer = ADD_TIMER(child, "CloseWaitTime");

    auto sort_times = ADD_COUNTER(child, "MemTableSortTimes", TUnit::UNIT);

    auto agg_times = ADD_COUNTER(child, "MemTableAggTimes", TUnit::UNIT);

    auto segment_num = ADD_COUNTER(child, "SegmentNum", TUnit::UNIT);

    auto raw_rows_num = ADD_COUNTER(child, "RawRowNum", TUnit::UNIT);

    auto merged_rows_num = ADD_COUNTER(child, "MergedRowNum", TUnit::UNIT);

    COUNTER_UPDATE(lock_timer, _lock_watch.elapsed_time());

    COUNTER_SET(delete_bitmap_timer, _rowset_writer->delete_bitmap_ns());

    COUNTER_SET(segment_writer_timer, _rowset_writer->segment_writer_ns());

    COUNTER_SET(wait_flush_timer, _wait_flush_time_ns);

    COUNTER_SET(close_wait_timer, _close_wait_time_ns);

    COUNTER_SET(segment_num, _segment_num);

    const auto& memtable_stat = _flush_token->memtable_stat();

    COUNTER_SET(sort_timer, memtable_stat.sort_ns);

    COUNTER_SET(agg_timer, memtable_stat.agg_ns);

    COUNTER_SET(memtable_duration_timer, memtable_stat.duration_ns);

    COUNTER_SET(put_into_output_timer, memtable_stat.put_into_output_ns);

    COUNTER_SET(sort_times, memtable_stat.sort_times);

    COUNTER_SET(agg_times, memtable_stat.agg_times);

    COUNTER_SET(raw_rows_num, memtable_stat.raw_rows);

    COUNTER_SET(merged_rows_num, memtable_stat.merged_rows);

}

Status MemTableWriter::cancel() {

    return cancel_with_status(Status::Cancelled("already cancelled"));

}

Status MemTableWriter::cancel_with_status(const Status& st) {

    std::lock_guard<std::mutex> l(_lock);

    if (_is_cancelled) {

        return Status::OK();

    }

    {

        std::lock_guard<std::mutex> lm(_mem_table_ptr_lock);

        _mem_table.reset();

    }

    if (_flush_token != nullptr) {

        // cancel and wait all memtables in flush queue to be finished

        _flush_token->cancel();

    }

    _is_cancelled = true;

    _cancel_status = st;

    return Status::OK();

}

const FlushStatistic& MemTableWriter::get_flush_token_stats() {

    return _flush_token->get_stats();

}

uint64_t MemTableWriter::flush_running_count() const {

    return _flush_token == nullptr ? 0 : _flush_token->get_stats().flush_running_count.load();

}

int64_t MemTableWriter::mem_consumption(MemType mem) {

    if (!_is_init) {

        // This method may be called before this writer is initialized.

        // So _flush_token may be null.

        return 0;

    }

    int64_t mem_usage = 0;

    {

        std::lock_guard<std::mutex> l(_mem_table_ptr_lock);

        for (const auto& mem_table : _freezed_mem_tables) {

            auto mem_table_sptr = mem_table.lock();

            if (mem_table_sptr != nullptr && mem_table_sptr->get_mem_type() == mem) {

                mem_usage += mem_table_sptr->memory_usage();

            }

        }

    }

    return mem_usage;

}

int64_t MemTableWriter::active_memtable_mem_consumption() {

    std::lock_guard<std::mutex> l(_mem_table_ptr_lock);

    return _mem_table != nullptr ? _mem_table->memory_usage() : 0;

}

} // namespace doris