add search and bench doc for golang maker
This commit is contained in:
parent
27a8b249ae
commit
6254a598fc
|
|
@ -12,7 +12,7 @@ go build
|
||||||
# 数据生成
|
# 数据生成
|
||||||
|
|
||||||
通过 `dbmaker gen` 命令生成 ip2region.xdb 二进制文件:
|
通过 `dbmaker gen` 命令生成 ip2region.xdb 二进制文件:
|
||||||
```bash
|
```
|
||||||
➜ golang git:(v2.0_xdb) ✗ ./dbmaker gen
|
➜ golang git:(v2.0_xdb) ✗ ./dbmaker gen
|
||||||
dbmaker gen [command options]
|
dbmaker gen [command options]
|
||||||
options:
|
options:
|
||||||
|
|
@ -21,7 +21,7 @@ options:
|
||||||
```
|
```
|
||||||
|
|
||||||
例如,使用默认的 data/ip.merge.txt 作为源数据,生成一个 ip2region.xdb 到当前目录:
|
例如,使用默认的 data/ip.merge.txt 作为源数据,生成一个 ip2region.xdb 到当前目录:
|
||||||
```
|
```bash
|
||||||
./dbmaker gen --src=../../data/ip.merge.txt --dst=./ip2region.xdb
|
./dbmaker gen --src=../../data/ip.merge.txt --dst=./ip2region.xdb
|
||||||
# 会看到一堆输出,最终会看到类似如下输出表示运行结束
|
# 会看到一堆输出,最终会看到类似如下输出表示运行结束
|
||||||
...
|
...
|
||||||
|
|
@ -31,4 +31,54 @@ options:
|
||||||
|
|
||||||
# 数据查询
|
# 数据查询
|
||||||
|
|
||||||
|
通过 `dbmaker search` 命令来测试查询输入的 ip:
|
||||||
|
```
|
||||||
|
dbmaker test [command options]
|
||||||
|
options:
|
||||||
|
--db string ip2region binary db file path
|
||||||
|
```
|
||||||
|
|
||||||
|
例如,使用自带的 xdb 文件来运行查询测试:
|
||||||
|
```bash
|
||||||
|
./dbmaker search --db=../../data/ip2region.xdb
|
||||||
|
ip2region 2.0 test program, commands:
|
||||||
|
loadIndex : load the vector index for search speedup.
|
||||||
|
clearIndex: clear the vector index.
|
||||||
|
quit : exit the test program
|
||||||
|
ip2region>> 103.192.227.215
|
||||||
|
{region:中国|0|香港|0|0, iocount:8, took:87.151µs}
|
||||||
|
ip2region>> loadIndex
|
||||||
|
vector index cached
|
||||||
|
ip2region>> 39.114.2.16
|
||||||
|
{region:韩国|0|0|0|SK宽带, iocount:2, took:50.005µs}
|
||||||
|
ip2region>> 120.24.130.96
|
||||||
|
{region:中国|0|广东省|深圳市|阿里云, iocount:2, took:32.805µs}
|
||||||
|
ip2region>>
|
||||||
|
```
|
||||||
|
|
||||||
# bench 测试
|
# bench 测试
|
||||||
|
|
||||||
|
如果你自主生成了 xdb 文件,请确保运行如下的 `dbmaker bench` 命令来确保制定的 xdb 文件的正确性:
|
||||||
|
```
|
||||||
|
➜ golang git:(v2.0_xdb) ✗ ./dbmaker bench
|
||||||
|
dbmaker bench [command options]
|
||||||
|
options:
|
||||||
|
--db string ip2region binary xdb file path
|
||||||
|
--src string source ip text file path
|
||||||
|
--ignore-error bool keep going if bench failed
|
||||||
|
```
|
||||||
|
|
||||||
|
例如:使用 data/ip.merge.txt 源文件来 bench 测试 data/ip2region.xdb 这个 xdb 文件:
|
||||||
|
```bash
|
||||||
|
./dbmaker bench --db=../../data/ip2region.xdb --src=../../data/ip.merge.txt
|
||||||
|
# 会看到一堆输出,看到类似如下的数据表示 bench 测试通过了,否则就会报错
|
||||||
|
...
|
||||||
|
try to bench segment: `224.0.0.0|255.255.255.255|0|0|0|内网IP|内网IP`
|
||||||
|
|-try to bench ip '224.0.0.0' ... --[Ok]
|
||||||
|
|-try to bench ip '231.255.255.255' ... --[Ok]
|
||||||
|
|-try to bench ip '239.255.255.255' ... --[Ok]
|
||||||
|
|-try to bench ip '247.255.255.255' ... --[Ok]
|
||||||
|
|-try to bench ip '255.255.255.255' ... --[Ok]
|
||||||
|
Bench finished, {count: 3417955, failed: 0, took: 52.200116397s}
|
||||||
|
```
|
||||||
|
如果运行过程中有错误会立马停止运行,也可以执行 --ignore-error=true 参数来忽略错误,在最后看 failed 的统计结果。
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue