reifydb-engine 0.10.0

Query execution and processing engine for ReifyDB
Documentation
// SPDX-License-Identifier: Apache-2.0
// Copyright (c) 2026 ReifyDB

use std::sync::Arc;

use arrow_array::RecordBatch;
use reifydb_catalog::error::{CatalogError, CatalogObjectKind};
use reifydb_codec::row::bytes::EncodedBytes;
use reifydb_core::{
	interface::{
		catalog::{
			config::{ConfigKey, GetConfig},
			namespace::Namespace,
			object::ObjectId,
			policy::{DataOp, PolicyTargetType},
			table::Table,
		},
		resolved::{ResolvedNamespace, ResolvedObject, ResolvedTable},
	},
	key::{
		any::TaggedKey,
		row::{PartitionedRowKey, RowKeyRange},
	},
	value::batch::single_row,
};
use reifydb_evaluate::stack::SymbolTable;
use reifydb_rql::{nodes::DeleteTableNode, query::QueryPlan};
use reifydb_transaction::{multi::RangeScope, transaction::Transaction};
use reifydb_value::{
	fragment::Fragment,
	params::Params,
	value::{
		Value,
		partition::Partition,
		row_number::RowNumber,
		system_columns::{partitions, row_numbers},
	},
};

use super::{
	context::{TableTarget, WriteExecCtx},
	primary_key::{self, PrimaryKeyIndex},
	returning::{decode_returning_dictionaries, decode_stored_table_rows, evaluate_returning, with_pre_image},
	shape::get_or_create_table_shape,
};
use crate::{
	Result,
	error::EngineError,
	partition::row_key_from_partition,
	policy::PolicyEvaluator,
	transaction::operation::table::TableOperations,
	vm::{
		services::Services,
		volcano::{
			compile::compile,
			query::{QueryContext, QueryNode, query_budget},
		},
	},
};

pub(crate) fn delete(
	services: &Arc<Services>,
	txn: &mut Transaction<'_>,
	plan: DeleteTableNode,
	params: Params,
	symbols: &SymbolTable,
) -> Result<RecordBatch> {
	let DeleteTableNode {
		input,
		target,
		returning,
	} = plan;
	let target = target.expect("DELETE without input requires explicit target table");
	let (namespace, table) = resolve_delete_table_target(services, txn, &target)?;
	let resolved_source = build_delete_table_resolved_source(&namespace, &table);
	let target_data = TableTarget {
		namespace: &namespace,
		table: &table,
		fragment: target.identifier(),
	};

	let exec = WriteExecCtx {
		services,
		symbols,
	};
	let (deleted_count, returned_rows) = if let Some(input_plan) = input {
		run_table_delete_with_input(
			&exec,
			txn,
			*input_plan,
			&target_data,
			&resolved_source,
			&params,
			returning.is_some(),
		)?
	} else {
		run_table_delete_all(services, txn, &table, returning.is_some())?
	};

	if let Some(returning_exprs) = &returning {
		let shape = get_or_create_table_shape(&services.catalog, &table, txn)?;
		let columns = decode_stored_table_rows(&services.catalog, txn, &table, &shape, &returned_rows)?;
		let columns = decode_returning_dictionaries(services, txn, &table.columns, columns)?;
		let columns = with_pre_image(columns.clone(), &columns)?;
		return evaluate_returning(services, symbols, returning_exprs, columns, txn.identity());
	}
	delete_table_result(namespace.name(), &table.name, deleted_count)
}

#[inline]
fn resolve_delete_table_target(
	services: &Arc<Services>,
	txn: &mut Transaction<'_>,
	target: &ResolvedTable,
) -> Result<(Namespace, Table)> {
	let namespace_name = target.namespace().name();
	let Some(namespace) = services.catalog.find_namespace_by_name(txn, namespace_name)? else {
		return Err(CatalogError::NotFound {
			kind: CatalogObjectKind::Namespace,
			namespace: namespace_name.to_string(),
			name: String::new(),
			fragment: Fragment::internal(namespace_name),
		}
		.into());
	};
	let Some(table) = services.catalog.find_table_by_name(txn, namespace.id(), target.name())? else {
		return Err(CatalogError::NotFound {
			kind: CatalogObjectKind::Table,
			namespace: namespace_name.to_string(),
			name: target.name().to_string(),
			fragment: target.identifier().clone(),
		}
		.into());
	};
	Ok((namespace, table))
}

#[inline]
fn build_delete_table_resolved_source(namespace: &Namespace, table: &Table) -> Option<ResolvedObject> {
	let namespace_ident = Fragment::internal(namespace.name());
	let resolved_namespace = ResolvedNamespace::new(namespace_ident, namespace.clone());
	let table_ident = Fragment::internal(table.name.clone());
	let resolved_table = ResolvedTable::new(table_ident, resolved_namespace, table.clone());
	Some(ResolvedObject::Table(resolved_table))
}

fn run_table_delete_with_input(
	exec: &WriteExecCtx<'_>,
	txn: &mut Transaction<'_>,
	input_plan: QueryPlan,
	target: &TableTarget<'_>,
	resolved_source: &Option<ResolvedObject>,
	params: &Params,
	has_returning: bool,
) -> Result<(u64, Vec<(RowNumber, EncodedBytes)>)> {
	let context = QueryContext {
		services: exec.services.clone(),
		source: resolved_source.clone(),
		batch_size: exec.services.catalog.get_config_uint2(ConfigKey::QueryRowBatchSize) as u64,
		params: params.clone(),
		symbols: exec.symbols.clone(),
		identity: txn.identity(),
		memory: query_budget(exec.services),
	};
	let mut input_node = compile(input_plan, txn, Arc::new(context.clone()));
	input_node.initialize(txn, &context)?;

	let (row_numbers_to_delete, partitions_to_delete) =
		collect_rows_to_delete(exec, txn, &mut input_node, &context, target)?;

	if !target.table.partition_by.is_empty() && partitions_to_delete.len() != row_numbers_to_delete.len() {
		return Err(EngineError::MissingPartitionAddress {
			object: ObjectId::Table(target.table.id),
			operation: "DELETE",
		}
		.into());
	}

	let pk_def = primary_key::get_primary_key(&exec.services.catalog, txn, target.table)?;
	let mut pk_index = pk_def.as_ref().map(PrimaryKeyIndex::new);

	let row_keys: Vec<TaggedKey> = row_numbers_to_delete
		.iter()
		.enumerate()
		.map(|(idx, &row_number)| {
			row_key_from_partition(target.table.id, partitions_to_delete.get(idx).copied(), row_number)
		})
		.collect();
	let old_rows = txn.get(&row_keys)?;

	let mut filtered_ids: Vec<RowNumber> = Vec::with_capacity(row_numbers_to_delete.len());
	let mut filtered_partitions: Vec<Partition> = Vec::with_capacity(partitions_to_delete.len());
	let mut filtered_rows: Vec<EncodedBytes> = Vec::with_capacity(row_numbers_to_delete.len());
	for (idx, (row_number, old_row)) in row_numbers_to_delete.into_iter().zip(old_rows).enumerate() {
		let Some(old_row) = old_row else {
			continue;
		};
		if let Some(pk_index) = &mut pk_index {
			pk_index.remove(&exec.services.catalog, txn, target.table, &old_row.bytes)?;
		}
		filtered_ids.push(row_number);
		if let Some(p) = partitions_to_delete.get(idx).copied() {
			filtered_partitions.push(p);
		}
		filtered_rows.push(old_row.bytes);
	}

	if let Some(pk_index) = pk_index {
		pk_index.write(txn)?;
	}
	let removed = txn.remove_from_table(
		&exec.services.catalog,
		target.table,
		&filtered_ids,
		&filtered_partitions,
		&filtered_rows,
	)?;
	let deleted_count = removed.len() as u64;
	let returned_rows: Vec<(RowNumber, EncodedBytes)> = if has_returning {
		removed
	} else {
		Vec::new()
	};
	Ok((deleted_count, returned_rows))
}

fn collect_rows_to_delete(
	exec: &WriteExecCtx<'_>,
	txn: &mut Transaction<'_>,
	input_node: &mut Box<dyn QueryNode>,
	context: &QueryContext,
	target: &TableTarget<'_>,
) -> Result<(Vec<RowNumber>, Vec<Partition>)> {
	let mut row_numbers_to_delete = Vec::new();
	let mut partitions_to_delete = Vec::new();
	let mut mutable_context = context.clone();
	while let Some(columns) = input_node.next(txn, &mut mutable_context)? {
		if columns.num_rows() == 0 {
			continue;
		}
		PolicyEvaluator::new(exec.services, exec.symbols).enforce_write_policies(
			txn,
			target.namespace.name(),
			&target.table.name,
			DataOp::Delete,
			&columns,
			PolicyTargetType::Table,
		)?;
		if row_numbers(&columns)?.is_empty() {
			return Err(EngineError::MissingRowNumberColumn.into());
		}
		let row_numbers = row_numbers(&columns)?;
		let sidecar_partitions = partitions(&columns)?;
		for row_idx in 0..columns.num_rows() {
			row_numbers_to_delete.push(row_numbers[row_idx]);
			if !sidecar_partitions.is_empty() {
				partitions_to_delete.push(sidecar_partitions[row_idx]);
			}
		}
	}
	Ok((row_numbers_to_delete, partitions_to_delete))
}

fn run_table_delete_all(
	services: &Arc<Services>,
	txn: &mut Transaction<'_>,
	table: &Table,
	has_returning: bool,
) -> Result<(u64, Vec<(RowNumber, EncodedBytes)>)> {
	let partitioned = !table.partition_by.is_empty();
	let range = if partitioned {
		PartitionedRowKey::full_scan(table.id)
	} else {
		RowKeyRange::storage_scan(table.id.into())
	};
	let pk_def = primary_key::get_primary_key(&services.catalog, txn, table)?;
	let mut pk_index = pk_def.as_ref().map(PrimaryKeyIndex::new);
	let rows: Vec<_> = txn.range(range, RangeScope::All, 32)?.collect::<Result<Vec<_>>>()?;

	let mut filtered_ids: Vec<RowNumber> = Vec::with_capacity(rows.len());
	let mut filtered_partitions: Vec<Partition> = Vec::with_capacity(rows.len());
	let mut filtered_rows: Vec<EncodedBytes> = Vec::with_capacity(rows.len());
	for multi in rows {
		if let Some(pk_index) = &mut pk_index {
			pk_index.remove(&services.catalog, txn, table, &multi.bytes)?;
		}
		filtered_rows.push(multi.bytes);
		if partitioned {
			let TaggedKey::PartitionedRow(key) = multi.key else {
				panic!("valid PartitionedRowKey encoding");
			};
			filtered_ids.push(key.row);
			filtered_partitions.push(key.partition);
		} else {
			let TaggedKey::Row(row_key) = multi.key else {
				panic!("valid RowKey encoding");
			};
			filtered_ids.push(row_key.row);
		}
	}

	if let Some(pk_index) = pk_index {
		pk_index.write(txn)?;
	}
	let removed =
		txn.remove_from_table(&services.catalog, table, &filtered_ids, &filtered_partitions, &filtered_rows)?;
	let deleted_count = removed.len() as u64;
	let returned_rows: Vec<(RowNumber, EncodedBytes)> = if has_returning {
		removed
	} else {
		Vec::new()
	};
	Ok((deleted_count, returned_rows))
}

#[inline]
fn delete_table_result(namespace: &str, table: &str, deleted: u64) -> Result<RecordBatch> {
	single_row([
		("namespace", Value::Utf8(namespace.to_string())),
		("table", Value::Utf8(table.to_string())),
		("deleted", Value::Uint8(deleted)),
	])
}