Files
qb/enc/value_delta.go

442 lines
11 KiB
Go
Raw Normal View History

2026-06-11 01:46:25 +00:00
package enc
import (
2026-06-14 23:12:03 +03:00
"fmt"
2026-06-11 01:46:25 +00:00
"io"
"log"
"math"
bin "gordenko.dev/dima/bin/little"
"gordenko.dev/dima/qb"
)
const (
tmpValueSize = 19
)
type ValueDeltaCompressor struct {
buf []byte
coef float64
pos int // payload size
baseValue float64
lastDelta uint64
2026-06-11 14:27:38 +00:00
// (baseValue, coef, value) => delta
calcDelta func(float64, float64, float64) uint64
// (value, coef) => uint64
toUint64 func(float64, float64) uint64
// (value, coef) => uint64
toFloat64 func(uint64, float64) float64
2026-06-12 06:11:57 +00:00
state *qb.ValueDeltaCapturedState
2026-06-11 01:46:25 +00:00
}
// Після відновлення із снапшота
2026-06-11 14:27:38 +00:00
func NewValueDeltaCompressor(metricType qb.MetricType, fracDigits byte, buf []byte, payloadSize int) *ValueDeltaCompressor {
2026-06-11 01:46:25 +00:00
s := &ValueDeltaCompressor{
buf: buf,
2026-06-12 06:11:57 +00:00
coef: 1,
2026-06-11 01:46:25 +00:00
pos: payloadSize,
}
2026-06-12 06:11:57 +00:00
if fracDigits > 0 {
s.coef = math.Pow(10, float64(fracDigits))
}
2026-06-11 14:27:38 +00:00
if metricType == qb.Cumulative {
s.calcDelta = calcCumulativeDelta
s.toUint64 = toCumulativeUint64
s.toFloat64 = toCumulativeFloat64
} else {
s.calcDelta = calcInstantDelta
s.toUint64 = toInstantUint64
s.toFloat64 = toInstantFloat64
}
2026-06-11 01:46:25 +00:00
if payloadSize > 0 {
u64, _, err := bin.GetVarUint64(s.buf)
if err != nil {
log.Fatalf("bug: get base value: %s", err)
}
2026-06-12 06:11:57 +00:00
s.baseValue = s.toFloat64(u64, s.coef)
s.lastDelta, _, err = bin.ReverseGetVarUint64(s.buf[:s.pos-1]) // skip h byte
2026-06-11 01:46:25 +00:00
if err != nil {
log.Fatalf("bug: get last delta: %s", err)
}
2026-06-12 06:11:57 +00:00
//fmt.Printf("lastDelta: %d\n", s.lastDelta)
2026-06-11 01:46:25 +00:00
}
return s
}
// можна виділити буфер максимального розміру, що може бути змінено під час кодування
// закодувати на етапі evaluate значення і повернути buf + offset. Причому буфер може бути
// спільний на всі metrics
// arr -
func (s *ValueDeltaCompressor) Evaluate(tmp []byte, value float64) qb.ValueEvaluationReport {
var (
2026-06-12 06:11:57 +00:00
delta uint64
rewindOffset int
i int
2026-06-11 01:46:25 +00:00
)
if s.pos > 0 {
2026-06-11 14:27:38 +00:00
delta = s.calcDelta(s.baseValue, s.coef, value)
2026-06-11 01:46:25 +00:00
h := s.buf[s.pos-1]
if h < 128 {
// run
if delta == s.lastDelta && h < 127 {
// incrementRun
tmp[i] = h + 1
i++
2026-06-12 06:11:57 +00:00
rewindOffset = 1 // перезапис h
2026-06-11 01:46:25 +00:00
} else {
// endSeries
n, _ := bin.ReversePutVarUint64(tmp, delta)
i += n
tmp[i] = 128 // start new literal (length=1)
i++
}
} else {
// literal
if delta != s.lastDelta {
if h < 255 {
// incrementLiteral
n, _ := bin.ReversePutVarUint64(tmp, delta)
i += n
tmp[i] = h + 1
i++
2026-06-12 06:11:57 +00:00
rewindOffset = 1 // перезапис h
2026-06-11 01:46:25 +00:00
} else {
// endSeries
n, _ := bin.ReversePutVarUint64(tmp, delta)
i += n
tmp[i] = 128 // start new literal (length=1)
i++
}
} else {
// startRun
if h > 128 {
tmp[i] = h - 1 // зменшую довжину попередньої серії на 1
i++
n, _ := bin.ReversePutVarUint64(tmp[i:], delta)
i += n
tmp[i] = 0 // start new run (length=2)
i++
2026-06-12 06:11:57 +00:00
rewindOffset = 1 + n // перезапис пари delta/h
2026-06-11 01:46:25 +00:00
} else {
tmp[i] = 0 // change literal (length=1) to run (length=2)
i++
2026-06-12 06:11:57 +00:00
rewindOffset = 1
2026-06-11 01:46:25 +00:00
}
}
}
} else {
2026-06-11 14:27:38 +00:00
n, _ := bin.PutVarUint64(tmp, s.toUint64(value, s.coef))
2026-06-11 01:46:25 +00:00
i += n
n, _ = bin.ReversePutVarUint64(tmp[i:], 0) // delta
i += n
tmp[i] = 128 // start new literal (length=1)
i++
}
return qb.ValueEvaluationReport{
2026-06-12 06:11:57 +00:00
RewindOffset: rewindOffset,
Offset: s.pos - rewindOffset,
ChangeSize: i,
TotalSpace: s.pos + i - rewindOffset,
Delta: delta,
2026-06-11 01:46:25 +00:00
}
}
// pos завжди вказує на h
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaCompressor) Append(rewindOffset int, change []byte, value float64, delta uint64) {
2026-06-14 23:12:03 +03:00
// fmt.Printf("append value:\n")
// fmt.Printf("rewind offset: %d\n", rewindOffset)
// fmt.Printf("change: % x\n", change)
// fmt.Printf("value: %v\n", value)
// fmt.Printf("delta: %d\n", delta)
2026-06-11 01:46:25 +00:00
if s.pos > 0 {
s.lastDelta = delta
} else {
s.baseValue = value
}
2026-06-14 23:12:03 +03:00
//fmt.Printf("buf before: % x\n", s.buf[:s.pos])
2026-06-12 06:11:57 +00:00
copy(s.buf[s.pos-rewindOffset:], change)
s.pos += len(change) - rewindOffset
2026-06-14 23:12:03 +03:00
//fmt.Printf("buf after: % x\n", s.buf[:s.pos])
//fmt.Printf("buf after: % x\n", s.buf[:s.pos])
2026-06-11 01:46:25 +00:00
}
func (s *ValueDeltaCompressor) DeleteLast() {
}
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaCompressor) getState() qb.ValueDeltaCapturedState {
2026-06-14 23:12:03 +03:00
if s.pos > 0 {
// fmt.Println("getState")
// fmt.Printf("pos: %d\n", s.pos)
// fmt.Printf("buf: % x\n", s.buf[:s.pos])
// fmt.Printf("h: %d\n", s.buf[s.pos-1])
// fmt.Printf("lastDelta: %d\n", s.lastDelta)
bound := s.pos - 1 - bin.CountVarUint64(s.lastDelta)
return qb.ValueDeltaCapturedState{
H: s.buf[s.pos-1],
LastDelta: s.lastDelta,
Payload: s.buf[:bound],
}
} else {
return qb.ValueDeltaCapturedState{}
2026-06-11 01:46:25 +00:00
}
}
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaCompressor) CaptureState() {
state := s.getState()
s.state = &state
}
2026-06-13 07:13:03 +00:00
func (s *ValueDeltaCompressor) ForgetCapturedState() {
s.state = nil
}
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaCompressor) Tail(offset int) []byte {
return s.buf[offset:s.pos]
}
2026-06-11 14:27:38 +00:00
// для зростання буфера під час вставки даних. State не цікавить
2026-06-11 01:46:25 +00:00
func (s *ValueDeltaCompressor) Size() int {
2026-06-11 14:27:38 +00:00
return s.pos
2026-06-11 01:46:25 +00:00
}
2026-06-14 23:12:03 +03:00
func (s *ValueDeltaCompressor) CommitedSize() int {
2026-06-12 06:11:57 +00:00
if s.state == nil {
2026-06-14 23:12:03 +03:00
return s.pos
2026-06-12 06:11:57 +00:00
} else {
2026-06-14 23:12:03 +03:00
if len(s.state.Payload) > 0 {
return bin.CountVarUint64(uint64(s.state.LastDelta)) + 1 + len(s.state.Payload)
} else {
return 0
}
2026-06-12 06:11:57 +00:00
}
}
// Snapshot - для створення снапшота.
2026-06-11 01:46:25 +00:00
// func (s *ValueDeltaCompressor) Payload() []byte {
// if s.state == nil {
// return s.buf[:s.pos]
// } else {
// return s.state.Payload
// }
// }
2026-06-14 23:12:03 +03:00
func (s *ValueDeltaCompressor) WriteCommitedTo(w io.Writer) (err error) {
2026-06-12 14:21:14 +00:00
if s.state == nil {
2026-06-11 01:46:25 +00:00
_, err = w.Write(s.buf[:s.pos])
return
} else {
2026-06-12 14:21:14 +00:00
_, err = w.Write(s.state.Payload)
2026-06-11 01:46:25 +00:00
if err != nil {
return
}
2026-06-12 14:21:14 +00:00
_, err = bin.WriteVarUint64(w, s.state.LastDelta)
2026-06-11 01:46:25 +00:00
if err != nil {
return
}
_, err = w.Write([]byte{
2026-06-12 14:21:14 +00:00
s.state.H,
2026-06-11 01:46:25 +00:00
})
return
}
}
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaCompressor) ReplaceBuffer(newbuf []byte) {
2026-06-11 01:46:25 +00:00
s.buf = newbuf
s.pos = 0
s.baseValue = 0
s.lastDelta = 0
}
func (s *ValueDeltaCompressor) LastValue() float64 {
2026-06-12 00:29:02 +03:00
// FIX
// var delta uint64
// if s.state == nil {
// delta = s.lastDelta
// } else {
// delta = s.state.LastDelta
// }
// return s.baseValue + s.toFloat64(delta, s.coef)
return 0
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
// Decompressor читає виключно збережені на диск дані
func (s *ValueDeltaCompressor) CreateDecompressor(metricType qb.MetricType, fracDigits byte) qb.ValueDecompressor {
2026-06-11 01:46:25 +00:00
if s.pos == 0 {
return nil
}
2026-06-12 06:11:57 +00:00
d := NewValueDeltaDecompressor(metricType, fracDigits)
if s.state != nil {
d.RestoreFromState(*s.state)
} else {
d.RestoreFromState(s.getState())
}
return d
2026-06-11 01:46:25 +00:00
}
// DECOMPRESSOR
type ValueDeltaDecompressor struct {
buf []byte
coef float64
pos int
bound int
baseValue float64
lastValue float64
isRun bool
pending int
done bool
2026-06-11 14:27:38 +00:00
// (value, coef) => uint64
toFloat64 func(uint64, float64) float64
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
func NewValueDeltaDecompressor(metricType qb.MetricType, fracDigits byte) *ValueDeltaDecompressor {
s := &ValueDeltaDecompressor{
coef: 1,
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
if fracDigits > 0 {
s.coef = math.Pow(10, float64(fracDigits))
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
if metricType == qb.Cumulative {
s.toFloat64 = toCumulativeFloat64
} else {
s.toFloat64 = toInstantFloat64
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
return s
}
func (s *ValueDeltaDecompressor) RestoreFromEnd(buf []byte) {
s.buf = buf
s.pos = len(buf) // first free
2026-06-14 23:12:03 +03:00
if len(buf) > 0 {
s.readBaseValue()
s.readHeader()
s.readValue()
} else {
s.done = true
}
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaDecompressor) RestoreFromState(state qb.ValueDeltaCapturedState) {
2026-06-14 23:12:03 +03:00
fmt.Printf("%#v\n", state)
2026-06-12 06:11:57 +00:00
s.buf = state.Payload
s.pos = len(s.buf) // first free
2026-06-14 23:12:03 +03:00
if len(s.buf) > 0 {
s.readBaseValue()
s.lastValue = s.baseValue + s.toFloat64(state.LastDelta, s.coef)
s.decodeHeaderByte(state.H)
} else {
s.done = true
}
2026-06-11 01:46:25 +00:00
}
2026-06-12 06:11:57 +00:00
func (s *ValueDeltaDecompressor) readBaseValue() {
u64, n, err := bin.GetVarUint64(s.buf)
2026-06-11 01:46:25 +00:00
if err != nil {
log.Fatalf("bug: get base value: %s", err)
}
2026-06-11 14:27:38 +00:00
s.baseValue = s.toFloat64(u64, s.coef)
2026-06-12 06:11:57 +00:00
s.bound = n
2026-06-11 01:46:25 +00:00
}
func (s *ValueDeltaDecompressor) NextValue() (value float64, done bool) {
if s.done {
return 0, true
}
value = s.lastValue
s.pending--
if s.pending > 0 {
if !s.isRun {
s.readValue()
}
} else if s.pos > s.bound {
s.readHeader()
s.readValue()
} else {
s.done = true
}
return value, false
}
func (s *ValueDeltaDecompressor) readHeader() {
s.pos--
h := s.buf[s.pos]
s.decodeHeaderByte(h)
}
2026-06-12 06:11:57 +00:00
2026-06-11 01:46:25 +00:00
func (s *ValueDeltaDecompressor) readValue() {
u64, n, err := bin.ReverseGetVarUint64(s.buf[:s.pos])
if err != nil {
log.Fatalln(err)
}
s.pos -= n
2026-06-11 14:27:38 +00:00
s.lastValue = s.baseValue + s.toFloat64(u64, s.coef)
2026-06-11 01:46:25 +00:00
}
func (s *ValueDeltaDecompressor) decodeHeaderByte(h byte) {
s.isRun = h < 128
if s.isRun {
s.pending = int(h) + 2
} else {
s.pending = int(h&127) + 1
}
}
2026-06-11 14:27:38 +00:00
// HELPERS
func calcCumulativeDelta(baseValue float64, coef float64, value float64) uint64 {
return uint64((value-baseValue)*coef + eps)
}
func calcInstantDelta(baseValue float64, coef float64, value float64) uint64 {
f64 := (value - baseValue) * coef
if f64 > 0 {
f64 += eps
} else {
f64 -= eps
}
return bin.EncodeZigZag(int64(f64))
}
func toCumulativeUint64(value float64, coef float64) uint64 {
return uint64(value * coef)
}
func toInstantUint64(value float64, coef float64) uint64 {
return bin.EncodeZigZag(int64(value * coef))
}
func toCumulativeFloat64(value uint64, coef float64) float64 {
return float64(value) / coef
}
func toInstantFloat64(value uint64, coef float64) float64 {
return float64(bin.DecodeZigZag(value)) / coef
}
2026-06-11 01:46:25 +00:00
/*
Формат:
base value (var u64)
delta (var u64)
q (qty of previous deltas; msb=0 - series, msb=1 - non series, low 7 bits - qty 1..128)
delta
delta
delta
q
Дельта рахується від base value.
Декодування у зворотньому порядку.
Після base value слідують run або literal блоки.
Run блок - це delta + header byte в кінці.
Literal блок - це від одної до N дельт + header byte в кінці.
Спочатку створюється literal блок.
Якщо для останної дельти додається дублікат, literal блок модифікується -
лічильник зменшується до 1. А остання дельта переміщюється в новий run блок.
Причому лічильник 0 - означає 2 елементи. Приклад:
До:
v1 v2 v3 h-byte(literal, 3) <- v3
Після:
v1 v2 h-byte(literal, 2) v3 h-byte(run, 2)
*/