Files
qb/enc/time_delta.go

405 lines
10 KiB
Go
Raw Normal View History

2026-06-07 21:27:18 +03:00
package enc
2026-05-10 00:59:47 +00:00
import (
2026-06-09 08:16:16 +03:00
"io"
2026-05-10 00:59:47 +00:00
"log"
2026-06-05 19:43:01 +00:00
bin "gordenko.dev/dima/bin/little"
2026-05-31 20:01:28 +00:00
"gordenko.dev/dima/qb"
2026-05-10 00:59:47 +00:00
)
2026-06-05 19:43:01 +00:00
/*
Payload data файла має таку структуру:
vvvvvvvv-> <-ttttttt
де v - це values, які додаються зліва направо, а читаються справа наліво;
t - це timestamps, які додаються справа наліво, а читаються зліва направо.
Timestamps читаються звичайними методами Get*, а писатись мають типу ByRightBound
*/
2026-06-11 01:46:25 +00:00
const (
tmpTimeSize = 7 // max when start run
)
2026-06-07 01:06:16 +00:00
type TimeDeltaCompressor struct {
buf []byte
// останній записаний байт, якщо рахувати справа наліво
pos int
lastUnixtime uint32
lastDelta uint32
state *TimeDeltaCapturedState
2026-05-10 00:59:47 +00:00
}
2026-06-09 08:16:16 +03:00
// Початкове створення, коли даних немає
// Створення після page filled, коли одразу є початкове значення
// Відновлення стану із снапшота. LastTimestamp передаю окермо від payload,
// а lastDelta і h треба прочитати із payload (якщо є)
// Кодує значення справа наліво функціями TailPut*. Читає значення зліва направо функціями Get*
2026-06-10 06:18:45 +03:00
func NewTimeDeltaCompressor(buf []byte, payloadSize int) *TimeDeltaCompressor {
s := &TimeDeltaCompressor{
2026-05-10 00:59:47 +00:00
buf: buf,
2026-06-11 01:46:25 +00:00
pos: len(buf) - payloadSize,
2026-06-07 01:06:16 +00:00
}
2026-06-07 21:27:18 +03:00
if payloadSize > 0 {
2026-06-11 01:46:25 +00:00
var err error
s.lastUnixtime, err = bin.GetUint32(s.buf[len(s.buf)-4:])
if err != nil {
log.Fatalf("bug: get since: %s", err)
}
//s.lastUnixtime = lastTimestamp // fix - порахувати
2026-06-09 08:16:16 +03:00
if payloadSize > 4 {
2026-06-11 01:46:25 +00:00
// u64, _, err := bin.GetVarUint64(s.buf[s.pos+1:])
// if err != nil {
// log.Fatalf("bug: get last delta: %s", err)
// }
// s.lastDelta = uint32(u64)
2026-06-07 01:06:16 +00:00
}
2026-05-10 00:59:47 +00:00
}
2026-06-10 06:18:45 +03:00
return s
2026-05-10 00:59:47 +00:00
}
2026-06-10 06:18:45 +03:00
// FIX - restire lastUnixtime
// func (s *TimeDeltaCompressor) RestoreState() {
// }
2026-06-11 01:46:25 +00:00
func (s *TimeDeltaCompressor) Evaluate(tmp []byte, timestamp uint32) qb.TimeEvaluationReport {
var (
delta = timestamp - s.lastUnixtime
offset int
i int
)
if s.pos < len(s.buf) {
2026-06-06 15:36:27 +03:00
if s.lastDelta > 0 {
2026-06-11 01:46:25 +00:00
h := s.buf[s.pos]
if h < 128 {
2026-06-06 15:36:27 +03:00
// run
2026-06-11 01:46:25 +00:00
if delta == s.lastDelta && h < 127 {
// incrementRun
tmp[i] = h + 1
i++
offset = 1 // перезапис h
2026-05-10 00:59:47 +00:00
} else {
2026-06-11 01:46:25 +00:00
// endSeries
n, _ := bin.PutVarUint64(tmp, uint64(delta))
i += n
tmp[i] = 128 // start new literal (length=1)
i++
2026-05-10 00:59:47 +00:00
}
} else {
2026-06-06 15:36:27 +03:00
// literal
if delta != s.lastDelta {
2026-06-11 01:46:25 +00:00
if h < 255 {
// incrementLiteral
n, _ := bin.PutVarUint64(tmp, uint64(delta))
i += n
tmp[i] = h + 1
i++
offset = 1 // перезапис h
2026-06-06 15:36:27 +03:00
} else {
2026-06-11 01:46:25 +00:00
// endSeries
n, _ := bin.PutVarUint64(tmp, uint64(delta))
i += n
tmp[i] = 128 // start new literal (length=1)
i++
2026-06-06 15:36:27 +03:00
}
2026-05-10 00:59:47 +00:00
} else {
2026-06-11 01:46:25 +00:00
// startRun
if h > 128 {
tmp[i] = h - 1 // зменшую довжину попередньої серії на 1
i++
n, _ := bin.PutVarUint64(tmp[i:], uint64(delta))
i += n
tmp[i] = 0 // start new run (length=2)
i++
offset = 1 + n // перезапис пари delta/h
} else {
tmp[i] = 0 // change literal (length=1) to run (length=2)
i++
offset = 1
2026-06-07 01:06:16 +00:00
}
2026-05-10 00:59:47 +00:00
}
}
} else {
2026-06-11 01:46:25 +00:00
// add 1st delta
n, _ := bin.PutVarUint64(tmp, uint64(delta))
i += n
tmp[i] = 128 // start new literal (length=1)
i++
2026-06-06 15:36:27 +03:00
}
} else {
2026-06-11 01:46:25 +00:00
bin.PutUint32(tmp, timestamp) // 1st timestamp (since)
i += 4
}
return qb.TimeEvaluationReport{
Offset: offset,
ChangeSize: i,
TotalSpace: s.pos - offset + i,
2026-06-06 15:36:27 +03:00
}
2026-05-10 00:59:47 +00:00
}
2026-06-11 01:46:25 +00:00
func (s *TimeDeltaCompressor) Append(offset int, change []byte, timestamp uint32) {
if s.pos < len(s.buf) {
i := s.pos + offset - 1 // -1, because s.pos always points to h byte
for _, b := range change {
s.buf[i] = b
i--
2026-06-06 15:36:27 +03:00
}
2026-06-11 01:46:25 +00:00
s.lastDelta = timestamp - s.lastUnixtime
} else {
copy(s.buf[len(s.buf)-4:], change) // 4b since
2026-06-06 15:36:27 +03:00
}
2026-06-11 01:46:25 +00:00
s.pos -= len(change) - offset
s.lastUnixtime = timestamp
2026-05-10 00:59:47 +00:00
}
2026-06-11 01:46:25 +00:00
// func (s *TimeDeltaCompressor) DeleteLast() {
2026-05-10 00:59:47 +00:00
2026-06-11 01:46:25 +00:00
// }
2026-05-31 20:01:28 +00:00
2026-06-07 01:06:16 +00:00
type TimeDeltaCapturedState struct {
2026-05-10 00:59:47 +00:00
H byte
LastUnixtime uint32
LastDelta uint32
2026-06-07 21:27:18 +03:00
Payload []byte
2026-05-10 00:59:47 +00:00
}
// delta h
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaCompressor) CaptureState() {
2026-05-31 20:01:28 +00:00
if s.state != nil {
qb.Abort(qb.RepeatableLock, nil)
2026-05-10 00:59:47 +00:00
}
2026-05-31 20:01:28 +00:00
// позиція посувається вліво, отже може перескочити на попередній chunk
2026-06-07 01:06:16 +00:00
s.state = &TimeDeltaCapturedState{
2026-06-11 01:46:25 +00:00
H: s.buf[s.pos],
2026-06-07 01:06:16 +00:00
LastUnixtime: s.lastUnixtime,
2026-05-31 20:01:28 +00:00
LastDelta: s.lastDelta,
2026-06-07 21:27:18 +03:00
Payload: s.buf[s.pos:],
2026-05-10 00:59:47 +00:00
}
}
2026-05-31 20:01:28 +00:00
// fix - повернути в Pool буфери
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaCompressor) ForgetCapturedState() {
2026-05-31 20:01:28 +00:00
s.state = nil
2026-05-21 23:38:52 +03:00
}
2026-06-09 08:16:16 +03:00
// коли сторінка заповнена і відправляється в txlog, since замінюю на until
func (s *TimeDeltaCompressor) ReplaceSinceWithUntil() uint32 {
pos := len(s.buf) - 4
since, _ := bin.GetUint32(s.buf[pos:])
bin.PutUint32(s.buf[pos:], s.lastUnixtime)
return since
}
2026-06-11 14:27:38 +00:00
// для зростання буфера під час вставки даних. State не цікавить
func (s *TimeDeltaCompressor) Size() int {
return len(s.buf) - s.pos
}
2026-06-11 01:46:25 +00:00
// if s.state == nil {
// return len(s.buf) - s.pos
// } else {
// return bin.CountVarUint64(uint64(s.state.LastDelta)) + hSize + len(s.state.Payload)
// }
// }
2026-06-09 08:16:16 +03:00
2026-06-07 01:06:16 +00:00
// Snapshot - для створення снапшота.
2026-06-09 08:16:16 +03:00
// FIX - encode firstUnixtime in 1st 4 bytes
//
// while page not completed - has first unixtime, after - last unixtime
2026-06-11 01:46:25 +00:00
// func (s *TimeDeltaCompressor) Payload() []byte {
// if s.state == nil {
// return s.buf[s.pos:]
// } else {
// return s.state.Payload
// }
// }
2026-06-07 01:06:16 +00:00
2026-06-09 08:16:16 +03:00
func (s *TimeDeltaCompressor) WritePayloadTo(w io.Writer) (err error) {
if s.state == nil {
_, err = w.Write(s.buf[:s.pos])
return
} else {
_, err = w.Write(s.state.Payload)
if err != nil {
return
}
_, err = bin.WriteVarUint64(w, uint64(s.state.LastDelta))
if err != nil {
return
}
2026-06-09 16:42:17 +00:00
_, err = w.Write([]byte{
2026-06-09 08:16:16 +03:00
s.state.H,
})
return
}
2026-05-31 20:01:28 +00:00
}
2026-06-09 08:16:16 +03:00
// func (s *TimeDeltaCompressor) encodeTail(lastUnixtime, lastDelta uint32, h byte) []byte {
// tail := make([]byte, 9)
// bin.PutUint32(tail, lastUnixtime)
// tail[4] = h
// n, _ := bin.PutVarUint64(tail[5:], uint64(lastDelta))
// return tail[:n+5]
// }
func (s *TimeDeltaCompressor) Rotate(newbuf []byte) {
2026-05-31 20:01:28 +00:00
// УВАГА!
// state не чіпаємо
2026-06-07 21:27:18 +03:00
s.buf = newbuf
2026-06-07 01:06:16 +00:00
s.pos = len(s.buf)
s.lastUnixtime = 0
2026-05-31 20:01:28 +00:00
s.lastDelta = 0
2026-06-07 21:27:18 +03:00
}
func (s *TimeDeltaCompressor) CreateDecompressor() qb.TimestampDecompressor {
2026-06-11 01:46:25 +00:00
if s.pos == len(s.buf) {
return nil
}
2026-06-07 21:27:18 +03:00
var (
2026-06-11 01:46:25 +00:00
h = s.buf[s.pos]
2026-06-07 21:27:18 +03:00
lastUnixtime = s.lastUnixtime
lastDelta = s.lastDelta
payload = s.buf[s.pos:]
)
if s.state != nil {
h = s.state.H
lastUnixtime = s.state.LastUnixtime
lastDelta = s.state.LastDelta
payload = s.state.Payload
}
return NewTimeDeltaDecompressorFromState(TimeDeltaDecompressorFromStateOptions{
H: h,
LastUnixtime: lastUnixtime,
LastDelta: lastDelta,
Payload: payload,
})
2026-05-31 20:01:28 +00:00
}
2026-06-09 08:16:16 +03:00
func (s *TimeDeltaCompressor) LastTimestamp() uint32 {
return s.lastUnixtime
2026-05-21 23:38:52 +03:00
}
2026-05-10 00:59:47 +00:00
// DECOMPRESSOR
2026-06-07 01:06:16 +00:00
type TimeDeltaDecompressor struct {
2026-06-05 19:43:01 +00:00
buf []byte
2026-05-10 00:59:47 +00:00
pos int
lastDelta uint32
lastUnixtime uint32
isRun bool
pending int
done bool
}
2026-06-07 01:06:16 +00:00
func NewTimeDeltaDecompressor(buf []byte) *TimeDeltaDecompressor {
s := &TimeDeltaDecompressor{
2026-05-10 00:59:47 +00:00
buf: buf,
}
2026-06-07 01:06:16 +00:00
if s.pos < len(s.buf) {
var err error
s.lastUnixtime, err = bin.GetUint32(s.buf)
2026-05-10 00:59:47 +00:00
if err != nil {
log.Fatalf("bug: get last unixtime: %s", err)
}
2026-06-07 01:06:16 +00:00
s.pos += 4
//fmt.Println("restored last unixtime", s.lastUnixtime)
2026-05-10 00:59:47 +00:00
} else {
s.done = true
}
2026-06-07 01:06:16 +00:00
return s
2026-05-10 00:59:47 +00:00
}
2026-06-07 21:27:18 +03:00
type TimeDeltaDecompressorFromStateOptions struct {
H byte
LastUnixtime uint32
LastDelta uint32
Payload []byte
}
func NewTimeDeltaDecompressorFromState(opt TimeDeltaDecompressorFromStateOptions) *TimeDeltaDecompressor {
2026-06-07 01:06:16 +00:00
s := &TimeDeltaDecompressor{
2026-06-07 21:27:18 +03:00
buf: opt.Payload,
lastUnixtime: opt.LastUnixtime,
2026-06-07 01:06:16 +00:00
}
2026-06-07 21:27:18 +03:00
if opt.LastDelta > 0 {
s.lastDelta = opt.LastDelta
s.decodeHeaderByte(opt.H)
2026-05-10 00:59:47 +00:00
}
2026-06-07 01:06:16 +00:00
//fmt.Println("-------------------")
//fmt.Printf("restore from bound: isRun=%t, pending=%d, lastUnix=%d, lastDelta=%d\n",
//s.isRun, s.pending, s.lastUnixtime, s.lastDelta)
//fmt.Printf("buf: %d\n", s.buf)
return s
2026-05-10 00:59:47 +00:00
}
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaDecompressor) NextValue() (value uint32, done bool) {
2026-05-10 00:59:47 +00:00
//fmt.Printf("NextValue(): pos: %d, isRegular: %t, pending: %d\n", s.pos, s.isRegular, s.pending)
if s.done {
return 0, true
}
// повертаю значення, що було прочитано в методі RestoreFromBound/RestoreFromEnd
value = s.lastUnixtime
2026-06-07 01:06:16 +00:00
if s.lastDelta > 0 {
s.lastUnixtime -= s.lastDelta
2026-05-10 00:59:47 +00:00
s.pending--
2026-06-07 01:06:16 +00:00
//fmt.Printf("lastUnix: %d, s.pending: %d\n", s.lastUnixtime, s.pending)
2026-05-10 00:59:47 +00:00
if s.pending > 0 {
// якщо в серії залишаються елементи
if !s.isRun {
s.readDelta()
}
2026-06-07 01:06:16 +00:00
} else if s.pos < len(s.buf) {
2026-05-10 00:59:47 +00:00
// в серії більше немає елементів, отже перевіряє чи є ще дані в буфері.
// дані є - читаю заголовок наступної серії
s.readHeader()
s.readDelta()
} else {
2026-06-07 01:06:16 +00:00
//s.done = true
s.lastDelta = 0
2026-05-10 00:59:47 +00:00
}
} else {
2026-06-07 01:06:16 +00:00
// був закодований лише last unixtime
s.done = true
2026-05-10 00:59:47 +00:00
}
return value, false
}
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaDecompressor) readHeader() {
2026-06-05 19:43:01 +00:00
h := s.buf[s.pos]
2026-06-07 01:06:16 +00:00
s.pos++
2026-05-10 00:59:47 +00:00
s.decodeHeaderByte(h)
2026-06-07 01:06:16 +00:00
// fmt.Println()
// fmt.Println("read from pos:", s.pos)
2026-05-10 00:59:47 +00:00
// fmt.Println("h:", h)
// fmt.Println("isRun:", s.isRun)
// fmt.Println("pending:", s.pending)
2026-06-07 01:06:16 +00:00
// fmt.Println()
2026-05-10 00:59:47 +00:00
}
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaDecompressor) decodeHeaderByte(h byte) {
2026-05-10 00:59:47 +00:00
s.isRun = h < 128
if s.isRun {
2026-06-07 01:06:16 +00:00
s.pending = int(h) + 2
2026-05-10 00:59:47 +00:00
} else {
s.pending = int(h&127) + 1
}
}
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaDecompressor) readDelta() {
u64, n, err := bin.GetVarUint64(s.buf[s.pos:])
2026-05-10 00:59:47 +00:00
if err != nil {
log.Fatalln(err)
}
// fmt.Println()
// fmt.Println("read from pos:", s.pos)
// fmt.Println("read delta:", u64)
// fmt.Println("read delta n:", n)
// fmt.Println()
2026-06-07 01:06:16 +00:00
s.pos += n
2026-05-10 00:59:47 +00:00
s.lastDelta = uint32(u64)
}