Files
qb/enc/time_delta.go

406 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-07 01:06:16 +00:00
type TimeDeltaCompressor struct {
buf []byte
// останній записаний байт, якщо рахувати справа наліво
pos int
lastUnixtime uint32
lastDelta uint32
h byte
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*
func NewTimeDeltaCompressor(buf []byte) *TimeDeltaCompressor {
return &TimeDeltaCompressor{
2026-05-10 00:59:47 +00:00
buf: buf,
2026-06-07 01:06:16 +00:00
}
2026-06-09 08:16:16 +03:00
}
func (s *TimeDeltaCompressor) RestoreState(payloadSize int, lastTimestamp uint32) {
2026-06-07 21:27:18 +03:00
if payloadSize > 0 {
2026-06-09 08:16:16 +03:00
s.lastUnixtime = lastTimestamp
s.pos = len(s.buf) - payloadSize
if payloadSize > 4 {
2026-06-07 01:06:16 +00:00
s.h = s.buf[s.pos]
2026-06-09 08:16:16 +03:00
u64, _, err := bin.GetVarUint64(s.buf[s.pos+1:])
2026-06-07 01:06:16 +00:00
if err != nil {
log.Fatalf("bug: get last delta: %s", err)
}
s.lastDelta = uint32(u64)
}
2026-05-10 00:59:47 +00:00
}
}
2026-06-06 15:36:27 +03:00
// retrun
2026-06-07 21:27:18 +03:00
func (s *TimeDeltaCompressor) Evaluate(unixtime uint32) (compressionWay int, requiredSpace int) {
2026-06-09 08:16:16 +03:00
requiredSpace = len(s.buf) - s.pos
if requiredSpace > 0 {
2026-05-10 00:59:47 +00:00
delta := unixtime - s.lastUnixtime
2026-06-06 15:36:27 +03:00
if s.lastDelta > 0 {
2026-05-10 00:59:47 +00:00
if s.h < 128 {
2026-06-06 15:36:27 +03:00
// run
if delta == s.lastDelta && s.h < 127 {
2026-06-07 21:27:18 +03:00
compressionWay = incrementRun
2026-05-10 00:59:47 +00:00
} else {
2026-06-07 21:27:18 +03:00
compressionWay = endSeries
2026-06-09 08:16:16 +03:00
requiredSpace += bin.CountVarUint64(uint64(delta)) + hSize
2026-05-10 00:59:47 +00:00
}
} else {
2026-06-06 15:36:27 +03:00
// literal
if delta != s.lastDelta {
if s.h < 255 {
2026-06-07 21:27:18 +03:00
compressionWay = incrementLiteral
2026-06-09 08:16:16 +03:00
requiredSpace += bin.CountVarUint64(uint64(delta))
2026-06-06 15:36:27 +03:00
} else {
2026-06-07 21:27:18 +03:00
compressionWay = endSeries
2026-06-09 08:16:16 +03:00
requiredSpace += bin.CountVarUint64(uint64(delta)) + hSize
2026-06-06 15:36:27 +03:00
}
2026-05-10 00:59:47 +00:00
} else {
2026-06-07 21:27:18 +03:00
compressionWay = startRun
2026-06-07 01:06:16 +00:00
if s.h > 128 {
2026-06-09 08:16:16 +03:00
requiredSpace += hSize // h - end of run
2026-06-07 01:06:16 +00:00
}
2026-05-10 00:59:47 +00:00
}
}
} else {
2026-06-07 21:27:18 +03:00
compressionWay = add1stDelta
2026-06-09 08:16:16 +03:00
requiredSpace += bin.CountVarUint64(uint64(delta)) + hSize
2026-06-06 15:36:27 +03:00
}
} else {
2026-06-07 21:27:18 +03:00
compressionWay = addUnixtime
2026-06-09 08:16:16 +03:00
requiredSpace += 4
2026-06-06 15:36:27 +03:00
}
return
2026-05-10 00:59:47 +00:00
}
2026-06-09 08:16:16 +03:00
// pos вказує на h byte
2026-06-07 21:27:18 +03:00
func (s *TimeDeltaCompressor) Compress(compressionWay int, unixtime uint32) {
2026-06-06 15:36:27 +03:00
delta := unixtime - s.lastUnixtime
2026-06-07 21:27:18 +03:00
switch compressionWay {
2026-06-07 01:06:16 +00:00
case incrementRun:
2026-06-06 15:36:27 +03:00
s.h++
2026-06-09 08:16:16 +03:00
s.buf[s.pos] = s.h
2026-06-07 01:06:16 +00:00
case incrementLiteral:
s.lastDelta = delta
2026-06-06 15:36:27 +03:00
s.h++
2026-06-09 08:16:16 +03:00
// тому що перезаписую h
s.pos++
n, _ := bin.TailPutVarUint64(s.buf[:s.pos], uint64(delta))
2026-06-07 01:06:16 +00:00
s.pos -= n
s.pos--
s.buf[s.pos] = s.h
2026-06-09 08:16:16 +03:00
case endSeries:
2026-06-07 01:06:16 +00:00
// start new literal (length=1)
2026-06-06 15:36:27 +03:00
s.lastDelta = delta
2026-06-07 01:06:16 +00:00
s.h = 128
2026-06-09 08:16:16 +03:00
n, _ := bin.TailPutVarUint64(s.buf[:s.pos], uint64(delta))
s.pos -= n
s.pos--
s.buf[s.pos] = s.h
2026-06-06 15:36:27 +03:00
case startRun:
2026-06-07 01:06:16 +00:00
if s.h > 128 {
s.h--
2026-06-09 08:16:16 +03:00
s.pos += bin.CountVarUint64(uint64(s.lastDelta)) // забираю останню дельту у literal
s.buf[s.pos] = s.h // write h - end of literal (because length > 1)
s.pos--
// run delta
n, _ := bin.TailPutVarUint64(s.buf[:s.pos], uint64(delta))
s.pos -= n
// для h
2026-06-07 01:06:16 +00:00
s.pos--
2026-06-06 15:36:27 +03:00
}
2026-06-07 01:06:16 +00:00
// start new run (length=2)
s.h = 0
2026-06-09 08:16:16 +03:00
s.buf[s.pos] = s.h
2026-06-06 15:36:27 +03:00
case add1stDelta:
2026-06-07 01:06:16 +00:00
// start new literal (length=1)
2026-06-06 15:36:27 +03:00
s.lastDelta = delta
2026-06-07 01:06:16 +00:00
s.h = 128
2026-06-09 08:16:16 +03:00
n, _ := bin.TailPutVarUint64(s.buf[:s.pos], uint64(delta))
s.pos -= n
s.pos--
s.buf[s.pos] = s.h
case addUnixtime:
s.pos -= 4
bin.PutUint32(s.buf[s.pos:], unixtime)
2026-06-06 15:36:27 +03:00
}
2026-06-07 21:27:18 +03:00
// 1st value or update after every update
// do not write immediatelly because of update after every update
2026-06-06 15:36:27 +03:00
s.lastUnixtime = unixtime
2026-05-10 00:59:47 +00:00
}
2026-06-07 01:06:16 +00:00
func (s *TimeDeltaCompressor) DeleteLast() {
2026-05-10 00:59:47 +00:00
}
2026-05-31 20:01:28 +00:00
// FIX - check methods
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-05-31 20:01:28 +00:00
H: s.h,
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-07 01:06:16 +00:00
// fix
func (s *TimeDeltaCompressor) Offset() int {
// if s.state != nil {
// return s.state.Pos
// }
2026-05-31 20:01:28 +00:00
return 0
}
2026-06-09 08:16:16 +03:00
func (s *TimeDeltaCompressor) Size() int {
if s.state == nil {
return len(s.buf) - s.pos
} else {
2026-06-09 16:42:17 +00:00
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
func (s *TimeDeltaCompressor) Payload() []byte {
2026-06-07 01:06:16 +00:00
if s.state == nil {
2026-06-09 08:16:16 +03:00
return s.buf[s.pos:]
2026-06-07 01:06:16 +00:00
} else {
2026-06-09 08:16:16 +03:00
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
s.h = 0
2026-06-07 21:27:18 +03:00
}
func (s *TimeDeltaCompressor) CreateDecompressor() qb.TimestampDecompressor {
var (
h = s.h
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)
}