https://github.com/fengxq2014/mars
A distributed high-performance snowflake id generator
https://github.com/fengxq2014/mars
distributed golang high-performance snowflake-twitter
Last synced: 2 months ago
JSON representation
A distributed high-performance snowflake id generator
- Host: GitHub
- URL: https://github.com/fengxq2014/mars
- Owner: Fengxq2014
- License: mit
- Created: 2019-01-04T05:58:23.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-02-05T06:36:43.000Z (over 1 year ago)
- Last Synced: 2025-01-25T10:26:57.267Z (4 months ago)
- Topics: distributed, golang, high-performance, snowflake-twitter
- Language: Go
- Size: 67.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
```base
_ __ ___ __ _ _ __ ___
| '_ ` _ \ / _` | '__/ __|
| | | | | | (_| | | \__ \
|_| |_| |_|\__,_|_| |___/
```
# Mars(阿瑞斯)
[](https://goreportcard.com/report/github.com/Fengxq2014/mars)
[](https://godoc.org/github.com/Fengxq2014/mars)
[](https://travis-ci.org/Fengxq2014/mars)
一个分布式、高性能的雪花id生成器
* 标准雪花id
* 53位兼容前端js精度的短雪花id
* 自增序列（按时间【分钟、小时、天、月、年】回退、按最大值回退）
* 批量获取id
## 依赖
* etcd 一个高可用的分布式键值(key-value)数据库，etcd内部采用raft协议作为一致性算法
## 使用
* http
* 获取id
```base
$ curl -u name:passwd 'http://{host}/id'
$ 530749286099451904%
$ # 批量获取
$ curl -u name:passwd 'http://{host}/id?num=10'
```
* 获取53位id
```base
$ curl -u name:passwd 'http://{host}/id53'
$ 4122703036416%
$ # 批量获取
$ curl -u name:passwd 'http://{host}/id53?num=10'
```
* 获取序列号
```base
$ # {id}：为序列号id，需要按照业务规则进行预先配置
$ curl -u name:passwd 'http://{host}/seq/{id}'
$ 1%
$ # 批量获取
$ curl -u name:passwd 'http://{host}/seq/{id}?num=10'
```
* 解析id信息
```$xslt
$ curl -u name:passwd 'http://{host}/info/530703474355077120'
$ {"node":"192.168.1.65:9736","step":"0","time":"2019-01-04T11:06:08.28+08:00"}%
```
* tcp
* 使用redis-cli
```base
$ redis-cli auth
$ # 获取一个标准id
$ get id
$ #批量获取10个
$ lrange id 0 10
$ # 获取一个53位id
$ get id53
$ #批量获取10个
$ lrange id53 0 10
$ # 获取一个序列号 {id}：为序列号id，需要按照业务规则进行预先配置
$ get seq/{id}
$ #批量获取10个
$ lrange seq/{id} 0 10
```
* 使用其他redis client 请使用redis sentinel 模式
## 用户认证
### http
使用basic auth
### tcp
使用redis auth
## seq.conf配置
```json
[
{
"id": "1",
"timeRollback": "m", // 按时间回退（m：分钟，h：小时，d：天，M：月，y：年）
"numRollback": 1000 // 按最大值回退
}
]
```
## 节点状态流程图
[](https://postimg.cc/z32Wx2yR)
## 性能
### http
```bash
Running 30s test @ http://localhost:8081/id
16 threads and 400 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 4.99ms 782.98us 10.69ms 78.32%
Req/Sec 4.91k 632.05 8.32k 85.78%
Latency Distribution
50% 5.15ms
75% 5.45ms
90% 5.77ms
99% 6.43ms
2348646 requests in 30.10s, 374.05MB read
Socket errors: connect 0, read 237, write 0, timeout 0
Non-2xx or 3xx responses: 2348646
Requests/sec: 78021.13
Transfer/sec: 12.43MB
```