reifydb-catalog 0.4.13

Database catalog and metadata management for ReifyDB
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

// SPDX-License-Identifier: Apache-2.0
// Copyright (c) 2025 ReifyDB

use reifydb_core::{common::CommitVersion, interface::catalog::shape::ShapeId, row::RowTtl};

use crate::materialized::{MaterializedCatalog, MultiVersionRowTtl};

impl MaterializedCatalog {
	/// Find a TTL config for a shape at a specific version
	pub fn find_row_ttl_at(&self, shape: ShapeId, version: CommitVersion) -> Option<RowTtl> {
		self.row_ttls.get(&shape).and_then(|entry| {
			let multi = entry.value();
			multi.get(version)
		})
	}

	/// Find a TTL config for a shape (returns latest version)
	pub fn find_row_ttl(&self, shape: ShapeId) -> Option<RowTtl> {
		self.row_ttls.get(&shape).and_then(|entry| {
			let multi = entry.value();
			multi.get_latest()
		})
	}

	/// Set a TTL config for a shape at a specific version
	pub fn set_row_ttl(&self, shape: ShapeId, version: CommitVersion, config: Option<RowTtl>) {
		let multi = self.row_ttls.get_or_insert_with(shape, MultiVersionRowTtl::new);

		if let Some(new_config) = config {
			multi.value().insert(version, new_config);
		} else {
			multi.value().remove(version);
		}
	}
}

#[cfg(test)]
pub mod tests {
	use reifydb_core::{
		interface::catalog::id::TableId,
		row::{RowTtlAnchor, RowTtlCleanupMode},
	};

	use super::*;

	#[test]
	fn test_set_and_find_row_ttl() {
		let catalog = MaterializedCatalog::new();
		let shape = ShapeId::Table(TableId(1));
		let config = RowTtl {
			duration_nanos: 300_000_000_000,
			anchor: RowTtlAnchor::Created,
			cleanup_mode: RowTtlCleanupMode::Drop,
		};

		catalog.set_row_ttl(shape, CommitVersion(1), Some(config.clone()));

		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(1)), Some(config.clone()));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(5)), Some(config));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(0)), None);
	}

	#[test]
	fn test_row_ttl_update() {
		let catalog = MaterializedCatalog::new();
		let shape = ShapeId::Table(TableId(42));

		let config_v1 = RowTtl {
			duration_nanos: 300_000_000_000,
			anchor: RowTtlAnchor::Created,
			cleanup_mode: RowTtlCleanupMode::Drop,
		};
		let config_v2 = RowTtl {
			duration_nanos: 600_000_000_000,
			anchor: RowTtlAnchor::Updated,
			cleanup_mode: RowTtlCleanupMode::Delete,
		};

		catalog.set_row_ttl(shape, CommitVersion(1), Some(config_v1.clone()));
		catalog.set_row_ttl(shape, CommitVersion(2), Some(config_v2.clone()));

		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(1)), Some(config_v1));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(2)), Some(config_v2.clone()));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(10)), Some(config_v2));
	}

	#[test]
	fn test_row_ttl_deletion() {
		let catalog = MaterializedCatalog::new();
		let shape = ShapeId::Table(TableId(99));
		let config = RowTtl {
			duration_nanos: 300_000_000_000,
			anchor: RowTtlAnchor::Created,
			cleanup_mode: RowTtlCleanupMode::Drop,
		};

		catalog.set_row_ttl(shape, CommitVersion(1), Some(config.clone()));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(1)), Some(config.clone()));

		catalog.set_row_ttl(shape, CommitVersion(2), None);
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(2)), None);
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(1)), Some(config));
	}

	#[test]
	fn test_row_ttl_versioning() {
		let catalog = MaterializedCatalog::new();
		let shape = ShapeId::Table(TableId(100));

		let config_v1 = RowTtl {
			duration_nanos: 60_000_000_000,
			anchor: RowTtlAnchor::Created,
			cleanup_mode: RowTtlCleanupMode::Drop,
		};
		let config_v2 = RowTtl {
			duration_nanos: 300_000_000_000,
			anchor: RowTtlAnchor::Updated,
			cleanup_mode: RowTtlCleanupMode::Delete,
		};
		let config_v3 = RowTtl {
			duration_nanos: 86_400_000_000_000,
			anchor: RowTtlAnchor::Created,
			cleanup_mode: RowTtlCleanupMode::Drop,
		};

		catalog.set_row_ttl(shape, CommitVersion(10), Some(config_v1.clone()));
		catalog.set_row_ttl(shape, CommitVersion(20), Some(config_v2.clone()));
		catalog.set_row_ttl(shape, CommitVersion(30), Some(config_v3.clone()));

		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(5)), None);
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(10)), Some(config_v1.clone()));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(15)), Some(config_v1));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(20)), Some(config_v2.clone()));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(25)), Some(config_v2));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(30)), Some(config_v3.clone()));
		assert_eq!(catalog.find_row_ttl_at(shape, CommitVersion(100)), Some(config_v3));
	}
}