Skip to content

Commit 33cf4f1

Browse files
committed
Prefer log over open-log
1 parent 04e2019 commit 33cf4f1

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

open-log/rfcs/0001-storage.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# RFC 0001: Open-Log Storage
1+
# RFC 0001: Log Storage
22

33
**Status**: Draft
44

@@ -7,11 +7,11 @@
77

88
## Summary
99

10-
This RFC defines the storage model and core API for open-log. Keys are stored directly in the LSM with a sequence number suffix, enabling per-key log streams with global ordering. The API provides append and scan operations mirroring SlateDB's interface.
10+
This RFC defines the storage model and core API for OpenData-Log. Keys are stored directly in the LSM with a sequence number suffix, enabling per-key log streams with global ordering. The API provides append and scan operations mirroring SlateDB's interface.
1111

1212
## Motivation
1313

14-
Open-Log is a key-oriented log system inspired by Kafka, but with a simpler model: keys are user-defined and every key is logically its own independent log. There is no concept of partitions or repartitioning—users simply write to new keys when their access patterns change.
14+
OpenData-Log is a key-oriented log system inspired by Kafka, but with a simpler model: keys are user-defined and every key is logically its own independent log. There is no concept of partitions or repartitioning—users simply write to new keys when their access patterns change.
1515

1616
Logs are stored in SlateDB's LSM tree. Writes are appended to the WAL and memtable, then flushed to sorted string tables (SSTs). LSM compaction naturally organizes data for log locality, grouping entries by key prefix over time. This provides efficient sequential reads for individual logs without requiring explicit partitioning infrastructure.
1717

@@ -63,7 +63,7 @@ If SlateDB supports multi-writer in the future, each writer would maintain its o
6363

6464
### SST Representation
6565

66-
Open-log proposes two enhancements to SlateDB's SST structure to support efficient `scan` and `count` operations.
66+
OpenData-Log proposes two enhancements to SlateDB's SST structure to support efficient `scan` and `count` operations.
6767

6868
#### Block Record Counts
6969

@@ -77,7 +77,7 @@ This enables counting records in a range by scanning the LSM at the index level
7777

7878
#### Bloom Filter Granularity
7979

80-
SlateDB SSTs include bloom filters to accelerate point lookups. For open-log, the bloom filter should be keyed on the log key alone, not the composite SlateDB key which includes the sequence number. This allows the bloom filter to indicate whether a given log is present in an SST, reducing the blocks read during `scan` or `count` queries.
80+
SlateDB SSTs include bloom filters to accelerate point lookups. For OpenData-Log, the bloom filter should be keyed on the log key alone, not the composite SlateDB key which includes the sequence number. This allows the bloom filter to indicate whether a given log is present in an SST, reducing the blocks read during `scan` or `count` queries.
8181

8282
### Append-Only Scan Optimization
8383

@@ -101,7 +101,7 @@ struct WriteOptions {
101101
await_durable: bool,
102102
}
103103

104-
impl OpenLog {
104+
impl Log {
105105
async fn append(&self, record: Record, options: WriteOptions) -> Result<(), Error>;
106106
async fn append_batch(&self, records: Vec<Record>, options: WriteOptions) -> Result<(), Error>;
107107
}
@@ -128,7 +128,7 @@ impl ScanIterator {
128128
async fn next(&mut self) -> Result<Option<LogEntry>, Error>;
129129
}
130130

131-
impl OpenLog {
131+
impl Log {
132132
fn scan(&self, key: Bytes, seq_range: impl RangeBounds<u64>, options: ScanOptions) -> ScanIterator;
133133
}
134134
```
@@ -143,7 +143,7 @@ struct CountOptions {
143143
approximate: bool,
144144
}
145145

146-
impl OpenLog {
146+
impl Log {
147147
async fn count(&self, key: Bytes, seq_range: impl RangeBounds<u64>, options: CountOptions) -> Result<u64, Error>;
148148
}
149149
```

0 commit comments

Comments
 (0)