Files
graph/algo/uidlist_test.go
zeekay f5aaeb712e Hanzo Graph — the engine, on zapdb, ZAP-native
Derived from Dgraph (github.com/dgraph-io/dgraph) at commit 64804bd2, Apache-2.0.
See NOTICE.

WHAT THIS IS. The graph engine as a Go library: posting lists, the DQL parser,
the type and tokenizer system, the index and schema layers, and the wire types.
39,170 lines of the upstream's 166,337.

THE STORE is github.com/luxfi/zapdb, a Badger fork that kept the package name,
the subpackages (options, pb, y) and the API — Open, OpenManaged, DB, Options —
so the 74 import sites are aliased rather than rewritten.

THE CODEC is ZAP. zapdb serializes with ZAP, not protobuf: its pb package builds
the ZAP types by default and the protobuf ones only under `-tags grpc`, a path
that does not compile (table/builder.go calls pb.Marshal, which that tag
removes). One call site in posting needed converting; every other type here is
Hanzo's own protobuf and is untouched.

NO TRANSPORT. An embedded engine dials nothing, so nothing here imports
google.golang.org/grpc. Removed: 20 transport functions in x, the generated
service stubs for Raft, Zero and Worker (1,657 lines), and the JWT helper —
identity belongs to IAM. The core called none of them.

NOT KEPT: worker, conn, raftwal, the cluster commands, the GraphQL layer and the
test harnesses. `query`, the DQL execution engine, went with them because it
depends on worker; parsing DQL is available here, executing it is not.

The history of the upstream project lives at github.com/dgraph-io/dgraph. This
repository begins at the derivation because three quarters of that history
describes code this fork does not carry.
2026-08-20 21:26:27 -07:00

682 lines
16 KiB
Go

/*
* SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
* SPDX-License-Identifier: Apache-2.0
*/
package algo
import (
"fmt"
"math/rand"
"sort"
"testing"
"github.com/stretchr/testify/require"
"google.golang.org/protobuf/proto"
"github.com/hanzoai/graph/codec"
"github.com/hanzoai/graph/protos/pb"
)
func newList(data []uint64) *pb.List {
return &pb.List{Uids: data}
}
func TestMergeSorted1(t *testing.T) {
input := []*pb.List{
newList([]uint64{55}),
}
require.Equal(t, MergeSorted(input).Uids, []uint64{55})
}
func TestMergeSorted2(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 3, 6, 8, 10}),
newList([]uint64{2, 4, 5, 7, 15}),
}
require.Equal(t, MergeSorted(input).Uids,
[]uint64{1, 2, 3, 4, 5, 6, 7, 8, 10, 15})
}
func TestMergeSorted3(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 3, 6, 8, 10}),
newList([]uint64{}),
}
require.Equal(t, MergeSorted(input).Uids, []uint64{1, 3, 6, 8, 10})
}
func TestMergeSorted4(t *testing.T) {
input := []*pb.List{
newList([]uint64{}),
newList([]uint64{1, 3, 6, 8, 10}),
}
require.Equal(t, MergeSorted(input).Uids, []uint64{1, 3, 6, 8, 10})
}
func TestMergeSorted5(t *testing.T) {
input := []*pb.List{
newList([]uint64{}),
newList([]uint64{}),
}
require.Empty(t, MergeSorted(input).Uids)
}
func TestMergeSorted6(t *testing.T) {
input := []*pb.List{
newList([]uint64{11, 13, 16, 18, 20}),
newList([]uint64{12, 14, 15, 15, 16, 16, 17, 25}),
newList([]uint64{1, 2}),
}
require.Equal(t, MergeSorted(input).Uids,
[]uint64{1, 2, 11, 12, 13, 14, 15, 16, 17, 18, 20, 25})
}
func BenchmarkMergeSorted(b *testing.B) {
createList := func(n int) *pb.List {
list := make([]uint64, n)
for i := range list {
list[i] = uint64(rand.Int63())
}
sort.Slice(list, func(i, j int) bool {
return list[i] < list[j]
})
return &pb.List{Uids: list}
}
input := []*pb.List{}
for i := 0; i < 10000; i++ {
input = append(input, createList(100))
}
b.Run("MergeSorted", func(b *testing.B) {
for i := 0; i < b.N; i++ {
internalMergeSort(input)
}
})
b.Run("MergeSortedParallel", func(b *testing.B) {
for i := 0; i < b.N; i++ {
MergeSortedMoreMem(input)
}
})
b.Run("MergeSortedNew", func(b *testing.B) {
for i := 0; i < b.N; i++ {
MergeSorted(input)
}
})
}
func TestMergeSortedRandom(t *testing.T) {
createList := func(n int) *pb.List {
list := make([]uint64, n)
for i := range list {
list[i] = uint64(rand.Int63())
}
sort.Slice(list, func(i, j int) bool {
return list[i] < list[j]
})
return &pb.List{Uids: list}
}
input := []*pb.List{}
for i := 0; i < 1000; i++ {
input = append(input, createList(1000))
}
require.Equal(t, MergeSorted(input).Uids, internalMergeSort(input).Uids)
}
func TestMergeSorted7(t *testing.T) {
input := []*pb.List{
newList([]uint64{5, 6, 7}),
newList([]uint64{3, 4}),
newList([]uint64{1, 2}),
newList([]uint64{}),
}
require.Equal(t, MergeSorted(input).Uids, []uint64{1, 2, 3, 4, 5, 6, 7})
}
func TestMergeSorted8(t *testing.T) {
input := []*pb.List{}
require.Empty(t, MergeSorted(input).Uids)
}
func TestMergeSorted9(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 1, 1}),
}
require.Equal(t, MergeSorted(input).Uids, []uint64{1})
}
func TestMergeSorted10(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3, 3, 6}),
newList([]uint64{4, 8, 9}),
}
require.Equal(t, MergeSorted(input).Uids, []uint64{1, 2, 3, 4, 6, 8, 9})
}
func TestIntersectSorted1(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{2, 3, 4, 5}),
}
require.Equal(t, []uint64{2, 3}, IntersectSorted(input).Uids)
}
func TestIntersectSorted2(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
}
require.Equal(t, IntersectSorted(input).Uids, []uint64{1, 2, 3})
}
func TestIntersectSorted3(t *testing.T) {
input := []*pb.List{}
require.Empty(t, IntersectSorted(input).Uids)
}
func TestIntersectSorted4(t *testing.T) {
input := []*pb.List{
newList([]uint64{100, 101}),
}
require.Equal(t, IntersectSorted(input).Uids, []uint64{100, 101})
}
func TestIntersectSorted5(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{2, 3, 4, 5}),
newList([]uint64{4, 5, 6}),
}
require.Empty(t, IntersectSorted(input).Uids)
}
func TestIntersectSorted6(t *testing.T) {
input := []*pb.List{
newList([]uint64{10, 12, 13}),
newList([]uint64{2, 3, 4, 13}),
newList([]uint64{4, 5, 6}),
}
require.Empty(t, IntersectSorted(input).Uids)
}
func TestDiffSorted1(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{1}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{2, 3}, output.Uids)
}
func TestDiffSorted2(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{2}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{1, 3}, output.Uids)
}
func TestDiffSorted3(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{3}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{1, 2}, output.Uids)
}
func TestDiffSorted4(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{1, 2, 3}, output.Uids)
}
func TestDiffSorted5(t *testing.T) {
input := []*pb.List{
newList([]uint64{}),
newList([]uint64{1, 2}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{}, output.Uids)
}
func TestSubSorted1(t *testing.T) {
input := []*pb.List{
newList([]uint64{1, 2, 3}),
newList([]uint64{2, 3, 4, 5}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{1}, output.Uids)
}
func TestSubSorted6(t *testing.T) {
input := []*pb.List{
newList([]uint64{10, 12, 13}),
newList([]uint64{2, 3, 4, 13}),
}
output := Difference(input[0], input[1])
require.Equal(t, []uint64{10, 12}, output.Uids)
}
func TestUIDListIntersect1(t *testing.T) {
u := newList([]uint64{1, 2, 3})
v := newList([]uint64{})
IntersectWith(u, v, u)
require.Empty(t, u.Uids)
}
func TestUIDListIntersect2(t *testing.T) {
u := newList([]uint64{1, 2, 3})
v := newList([]uint64{1, 2, 3, 4, 5})
IntersectWith(u, v, u)
require.Equal(t, []uint64{1, 2, 3}, u.Uids)
require.Equal(t, []uint64{1, 2, 3, 4, 5}, v.Uids)
}
func TestUIDListIntersect3(t *testing.T) {
u := newList([]uint64{1, 2, 3})
v := newList([]uint64{2})
IntersectWith(u, v, u)
require.Equal(t, []uint64{2}, u.Uids)
require.Equal(t, []uint64{2}, v.Uids)
}
func TestUIDListIntersect4(t *testing.T) {
u := newList([]uint64{1, 2, 3})
v := newList([]uint64{0, 5})
IntersectWith(u, v, u)
require.Empty(t, u.Uids)
require.Equal(t, []uint64{0, 5}, v.Uids)
}
func TestUIDListIntersect5(t *testing.T) {
u := newList([]uint64{1, 2, 3})
v := newList([]uint64{3, 5})
IntersectWith(u, v, u)
require.Equal(t, []uint64{3}, u.Uids)
}
func TestUIDListIntersect6(t *testing.T) {
common, other, _ := fillNums(10, 500)
u := newList(common)
v := newList(other)
IntersectWith(u, v, u)
require.Equal(t, common, u.Uids)
}
func TestUIDListIntersect7(t *testing.T) {
common, other, _ := fillNums(10, 2500)
u := newList(common)
v := newList(other)
IntersectWith(u, v, u)
require.Equal(t, common, u.Uids)
}
func TestUIDListIntersect8(t *testing.T) {
common, other, _ := fillNums(10, 20000)
u := newList(common)
v := newList(other)
IntersectWith(u, v, newList(nil))
require.Equal(t, common, u.Uids)
}
func TestUIDListIntersectDupFirst(t *testing.T) {
u := newList([]uint64{1, 1, 2, 3})
v := newList([]uint64{1, 2})
IntersectWith(u, v, u)
require.Equal(t, []uint64{1, 2}, u.Uids)
}
func TestUIDListIntersectDupBoth(t *testing.T) {
u := newList([]uint64{1, 1, 2, 3, 5})
v := newList([]uint64{1, 1, 2, 4})
IntersectWith(u, v, u)
require.Equal(t, []uint64{1, 1, 2}, u.Uids)
}
func TestUIDListIntersectDupSecond(t *testing.T) {
u := newList([]uint64{1, 2, 3, 5})
v := newList([]uint64{1, 1, 2, 4})
IntersectWith(u, v, u)
require.Equal(t, []uint64{1, 2}, u.Uids)
}
func TestApplyFilterUint(t *testing.T) {
l := []uint64{1, 2, 3, 4, 5}
u := newList(l)
ApplyFilter(u, func(a uint64, idx int) bool { return (l[idx] % 2) == 1 })
require.Equal(t, []uint64{1, 3, 5}, u.Uids)
}
// Benchmarks for IntersectWith
func BenchmarkListIntersectRandom(b *testing.B) {
randomTests := func(arrSz int, overlap float64) {
limit := int64(float64(arrSz) / overlap)
u1, v1 := make([]uint64, arrSz), make([]uint64, arrSz)
for i := range arrSz {
u1[i] = uint64(rand.Int63n(limit))
v1[i] = uint64(rand.Int63n(limit))
}
sort.Slice(u1, func(i, j int) bool { return u1[i] < u1[j] })
sort.Slice(v1, func(i, j int) bool { return v1[i] < v1[j] })
u := newList(u1)
v := newList(v1)
dst1 := &pb.List{}
dst2 := &pb.List{}
compressedUids := codec.Encode(u1, 256)
b.Run(fmt.Sprintf(":size=%d:overlap=%.2f:", arrSz, overlap),
func(b *testing.B) {
for k := 0; k < b.N; k++ {
IntersectWith(u, v, dst1)
}
})
b.Run(fmt.Sprintf(":compressed:size=%d:overlap=%.2f:", arrSz, overlap),
func(b *testing.B) {
for k := 0; k < b.N; k++ {
IntersectCompressedWith(compressedUids, 0, v, dst2)
}
})
i := 0
j := 0
for i < len(dst1.Uids) {
if dst1.Uids[i] != dst2.Uids[j] {
b.Errorf("Unexpected error in intersection")
}
// Behaviour of bin intersect is not defined when duplicates are present
i = skipDuplicate(dst1.Uids, i)
j = skipDuplicate(dst2.Uids, j)
}
if j < len(dst2.Uids) {
b.Errorf("Unexpected error in intersection")
}
codec.FreePack(compressedUids)
}
randomTests(10240, 0.3)
randomTests(1024000, 0.3)
randomTests(10240, 0.1)
randomTests(1024000, 0.1)
randomTests(10240, 0.01)
randomTests(1024000, 0.01)
}
func BenchmarkListIntersectCompressBin(b *testing.B) {
randomTests := func(sz int, overlap float64) {
rs := []float64{0.01, 0.1, 1, 10, 100}
for _, r := range rs {
sz1 := sz
sz2 := int(float64(sz) * r)
if sz2 > 10000000 || sz2 == 0 {
break
}
u1, v1 := make([]uint64, sz1), make([]uint64, sz2)
limit := int64(float64(sz) / overlap)
for i := range sz1 {
u1[i] = uint64(rand.Int63n(limit))
}
for i := range sz2 {
v1[i] = uint64(rand.Int63n(limit))
}
sort.Slice(u1, func(i, j int) bool { return u1[i] < u1[j] })
sort.Slice(v1, func(i, j int) bool { return v1[i] < v1[j] })
dst2 := &pb.List{}
dst1 := &pb.List{}
compressedUids := codec.Encode(v1, 256)
b.Run(fmt.Sprintf("linJump:IntersectWith:ratio=%v:size=%d:overlap=%.2f:", r, sz, overlap),
func(b *testing.B) {
for k := 0; k < b.N; k++ {
dec := codec.Decoder{Pack: compressedUids}
dec.Seek(0, codec.SeekStart)
IntersectCompressedWithLinJump(&dec, u1, &dst1.Uids)
}
})
b.Run(fmt.Sprintf("compressed:IntersectWith:ratio=%v:size=%d:overlap=%.2f:", r, sz, overlap),
func(b *testing.B) {
for k := 0; k < b.N; k++ {
dec := codec.Decoder{Pack: compressedUids}
dec.Seek(0, codec.SeekStart)
IntersectCompressedWithBin(&dec, u1, &dst2.Uids)
}
})
codec.FreePack(compressedUids)
}
}
randomTests(10, 0.01)
randomTests(100, 0.01)
randomTests(1000, 0.01)
randomTests(10000, 0.01)
randomTests(100000, 0.01)
randomTests(1000000, 0.01)
}
func BenchmarkListIntersectRatio(b *testing.B) {
randomTests := func(sz int, overlap float64) {
rs := []int{1, 10, 50, 100, 500, 1000, 10000, 100000, 1000000}
for _, r := range rs {
sz1 := sz
sz2 := sz * r
if sz2 > 1000000 {
break
}
u1, v1 := make([]uint64, sz1), make([]uint64, sz2)
limit := int64(float64(sz) / overlap)
for i := range sz1 {
u1[i] = uint64(rand.Int63n(limit))
}
for i := range sz2 {
v1[i] = uint64(rand.Int63n(limit))
}
sort.Slice(u1, func(i, j int) bool { return u1[i] < u1[j] })
sort.Slice(v1, func(i, j int) bool { return v1[i] < v1[j] })
u := &pb.List{Uids: u1}
v := &pb.List{Uids: v1}
dst1 := &pb.List{}
dst2 := &pb.List{}
compressedUids := codec.Encode(v1, 256)
fmt.Printf("len: %d, compressed: %d, bytes/int: %f\n",
len(v1), proto.Size(compressedUids), float64(proto.Size(compressedUids))/float64(len(v1)))
b.Run(fmt.Sprintf(":IntersectWith:ratio=%d:size=%d:overlap=%.2f:", r, sz, overlap),
func(b *testing.B) {
for k := 0; k < b.N; k++ {
IntersectWith(u, v, dst1)
}
})
b.Run(fmt.Sprintf("compressed:IntersectWith:ratio=%d:size=%d:overlap=%.2f:", r, sz, overlap),
func(b *testing.B) {
for k := 0; k < b.N; k++ {
IntersectCompressedWith(compressedUids, 0, u, dst2)
}
})
fmt.Println()
i := 0
j := 0
for i < len(dst1.Uids) {
if dst1.Uids[i] != dst2.Uids[j] {
b.Errorf("Unexpected error in intersection")
}
// Behaviour of bin intersect is not defined when duplicates are present
i = skipDuplicate(dst1.Uids, i)
j = skipDuplicate(dst2.Uids, j)
}
if j < len(dst2.Uids) {
b.Errorf("Unexpected error in intersection")
}
codec.FreePack(compressedUids)
}
}
randomTests(10, 0.01)
randomTests(100, 0.01)
randomTests(1000, 0.01)
randomTests(10000, 0.01)
randomTests(100000, 0.01)
randomTests(1000000, 0.01)
}
func skipDuplicate(in []uint64, idx int) int {
i := idx + 1
for i < len(in) && in[i] == in[idx] {
i++
}
return i
}
func sortUint64(nums []uint64) {
sort.Slice(nums, func(i, j int) bool { return nums[i] < nums[j] })
}
func fillNumsDiff(N1, N2, N3 int) ([]uint64, []uint64, []uint64) {
commonNums := make([]uint64, N1)
blockNums := make([]uint64, N1+N2)
otherNums := make([]uint64, N1+N3)
allC := make(map[uint64]bool)
for i := range N1 {
val := rand.Uint64() % 1000
commonNums[i] = val
blockNums[i] = val
otherNums[i] = val
allC[val] = true
}
for i := N1; i < N1+N2; i++ {
val := rand.Uint64() % 1000
blockNums[i] = val
allC[val] = true
}
for i := N1; i < N1+N3; i++ {
val := rand.Uint64()
for ok := true; ok; _, ok = allC[val] {
val = rand.Uint64() % 1000
}
otherNums[i] = val
}
sortUint64(commonNums)
sortUint64(blockNums)
sortUint64(otherNums)
return commonNums, blockNums, otherNums
}
func fillNums(N1, N2 int) ([]uint64, []uint64, []uint64) {
commonNums := make([]uint64, N1)
blockNums := make([]uint64, N1+N2)
otherNums := make([]uint64, N1+N2)
for i := range N1 {
val := rand.Uint64()
commonNums[i] = val
blockNums[i] = val
otherNums[i] = val
}
for i := N1; i < N1+N2; i++ {
blockNums[i] = rand.Uint64()
otherNums[i] = rand.Uint64()
}
sortUint64(commonNums)
sortUint64(blockNums)
sortUint64(otherNums)
return commonNums, blockNums, otherNums
}
func TestIntersectCompressedWithLinJump(t *testing.T) {
lengths := []int{0, 1, 3, 11, 100}
for _, N1 := range lengths {
for _, N2 := range lengths {
// Intersection of blockNums and otherNums is commonNums.
commonNums, blockNums, otherNums := fillNums(N1, N2)
enc := codec.Encoder{BlockSize: 10}
for _, num := range blockNums {
enc.Add(num)
}
pack := enc.Done()
dec := codec.Decoder{Pack: pack}
dec.Seek(0, codec.SeekStart)
actual := make([]uint64, 0)
IntersectCompressedWithLinJump(&dec, otherNums, &actual)
require.Equal(t, commonNums, actual)
codec.FreePack(pack)
}
}
}
func TestIntersectCompressedWithBin(t *testing.T) {
//lengths := []int{0, 1, 3, 11, 100, 500, 1000}
for _, N1 := range []int{11} {
for _, N2 := range []int{3} {
// Intersection of blockNums and otherNums is commonNums.
commonNums, blockNums, otherNums := fillNumsDiff(N1/10, N1, N2)
enc := codec.Encoder{BlockSize: 10}
for _, num := range blockNums {
enc.Add(num)
}
pack := enc.Done()
dec := codec.Decoder{Pack: pack}
dec.Seek(0, codec.SeekStart)
actual := make([]uint64, 0)
IntersectCompressedWithBin(&dec, otherNums, &actual)
require.Equal(t, commonNums, actual)
codec.FreePack(pack)
}
}
}
func TestIntersectCompressedWithBinMissingSize(t *testing.T) {
lengths := []int{0, 1, 3, 11, 100, 500, 1000}
for _, N1 := range lengths {
for _, N2 := range lengths {
// Intersection of blockNums and otherNums is commonNums.
commonNums, blockNums, otherNums := fillNums(N1, N2)
// Set the block size to 0 to verify that the method still works in this case.
enc := codec.Encoder{BlockSize: 0}
for _, num := range blockNums {
enc.Add(num)
}
pack := enc.Done()
dec := codec.Decoder{Pack: pack}
dec.Seek(0, codec.SeekStart)
actual := make([]uint64, 0)
IntersectCompressedWithBin(&dec, otherNums, &actual)
require.Equal(t, commonNums, actual)
codec.FreePack(pack)
}
}
}