WUIDis a universal unique identifier generator.WUIDis much faster than traditional UUID. EachWUIDinstance can even generate 100M unique identifiers in a single second.- In the nutshell,
WUIDgenerates 64-bit integers in sequence. The high 28 bits are loaded from a data source. By now, Redis, MySQL, MongoDB and Callback are supported. - The uniqueness is guaranteed as long as all
WUIDinstances share a same data source or each group of them has a different section ID. WUIDautomatically renews the high 28 bits when the low 36 bits are about to run out.WUIDis thread-safe, and lock free.- Obfuscation is supported.
BenchmarkWUID 159393580 7.661 ns/op 0 B/op 0 allocs/op
BenchmarkRand 100000000 14.95 ns/op 0 B/op 0 allocs/op
BenchmarkTimestamp 164224915 7.359 ns/op 0 B/op 0 allocs/op
BenchmarkUUID_V1 23629536 43.42 ns/op 0 B/op 0 allocs/op
BenchmarkUUID_V2 29351550 43.96 ns/op 0 B/op 0 allocs/op
BenchmarkUUID_V3 4703044 254.2 ns/op 144 B/op 4 allocs/op
BenchmarkUUID_V4 5796310 210.0 ns/op 16 B/op 1 allocs/op
BenchmarkUUID_V5 4051291 310.7 ns/op 168 B/op 4 allocs/op
BenchmarkRedis 2996 38725 ns/op 160 B/op 5 allocs/op
BenchmarkSnowflake 1000000 2092 ns/op 0 B/op 0 allocs/op
BenchmarkULID 5660170 207.7 ns/op 16 B/op 1 allocs/op
BenchmarkXID 49639082 26.21 ns/op 0 B/op 0 allocs/op
BenchmarkShortID 1312386 922.2 ns/op 320 B/op 11 allocs/op
BenchmarkKsuid 19717675 59.79 ns/op 0 B/op 0 allocs/op
go get -u github.com/edwingeng/wuidimport "github.com/edwingeng/wuid/redis/v8/wuid"
newClient := func() (redis.UniversalClient, bool, error) {
var client redis.UniversalClient
// ...
return client, true, nil
}
// Setup
w := NewWUID("alpha", nil)
err := w.LoadH28FromRedis(newClient, "wuid")
if err != nil {
panic(err)
}
// Generate
for i := 0; i < 10; i++ {
fmt.Printf("%#016x\n", w.Next())
}import "github.com/edwingeng/wuid/mysql/wuid"
openDB := func() (*sql.DB, bool, error) {
var db *sql.DB
// ...
return db, true, nil
}
// Setup
w := NewWUID("alpha", nil)
err := w.LoadH28FromMysql(openDB, "wuid")
if err != nil {
panic(err)
}
// Generate
for i := 0; i < 10; i++ {
fmt.Printf("%#016x\n", w.Next())
}import "github.com/edwingeng/wuid/mongo/wuid"
newClient := func() (*mongo.Client, bool, error) {
var client *mongo.Client
// ...
return client, true, nil
}
// Setup
w := NewWUID("alpha", nil)
err := w.LoadH28FromMongo(newClient, "test", "wuid", "default")
if err != nil {
panic(err)
}
// Generate
for i := 0; i < 10; i++ {
fmt.Printf("%#016x\n", w.Next())
}import "github.com/edwingeng/wuid/callback/wuid"
callback := func() (int64, func(), error) {
var h28 int64
// ...
return h28, nil, nil
}
// Setup
w := NewWUID("alpha", nil)
err := w.LoadH28WithCallback(callback)
if err != nil {
panic(err)
}
// Generate
for i := 0; i < 10; i++ {
fmt.Printf("%#016x\n", w.Next())
}CREATE TABLE IF NOT EXISTS `wuid` (
`h` int(10) NOT NULL AUTO_INCREMENT,
`x` tinyint(4) NOT NULL DEFAULT '0',
PRIMARY KEY (`x`),
UNIQUE KEY `h` (`h`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;WithSectionbrands a section ID on each generated number. A section ID must be in between [0, 7].WithStepsets the step and the floor for each generated number.WithObfuscationenables number obfuscation.
It is highly recommended to pass a logger to wuid.NewWUID and keep an eye on the warnings that include "renew failed". It indicates that the low 36 bits are about to run out in hours to hundreds of hours, and the renewal program failed for some reason. WUID will make many renewal attempts until succeeded.