aerospike工具集——aql

来源：互联网发布：tgp修复网络环境失败编辑：程序博客网时间：2024/06/06 00:13

aql工具提供了一个类似于sql的命令行接口，用于数据库，UDF和索引管理。aerospike不支持sql查询或管理语言，只是提供一个类似于sql的接口。

aql的使用方法

aql OPTIONS

可以通过aql --help来查看帮助文档，aql --help之后可以看到如下选项：

-h <host>服务器ip，默认为：127.0.0.1

-p <port>端口号。默认为：3000

-c <command>执行指定的命令

-f <filepath>执行的命令在指定的文件中

-v启用详细输出

-e打开命令的反馈模式

-T <milliseconds>设置命令执行超时时间，单位为ms，默认为1000

-o (json | table)设置输出模型，默认为table

-u <path> 设置UDF用户管理模块。

-s <path> 设置系统UDF管理模块

--help帮助

aql使用基于SQL命令语言的语法，对于习惯了关系型数据库的人来说是一个不错的工具。

数据管理

查找所有的namespace

得到所有的set

得到所有的bin

索引管理

创建一个索引

CREATE INDEX <index> ON <ns>[.<set>] (<bin>) <type>

<index>索引名称，在一个命名空间上索引名称必须唯一；

<ns>命名空间；

<set>设置是可选的，如果没有设置，则索引的记录不属于一个set；

<bin>根据bin建立索引

<type>索引存储的类型，必须是：NUMERIC or STRING

显示ns下的所有的索引信息

删除一个索引

索引状态同步

sync_state

ValueDescriptionsynced次级索引和主索引保持一致need_sync次级索引和主索引保存不一致，需要同步

如果sync_state=need_sync and state=RW，则需要进行同步处理

修复索引的方法如下：aql不能提供索引修复的功能，需要用asinfo来处理

[root@mobiead-06 server]# asinfo -v "sindex-repair:ns=test;indexname=numindex;set=testset;"

索引状态

ValueDescriptionWO次级索引只写模式，一般情况下只能进行更新次级索引，但不能进行查询RW次级索引读写模式. 这种模式下可以进行查询

查询和扫描管理

启用查询跟踪

关闭查询跟踪

正在运行的查询

查询运行的命令列表：Managing Queries

正在运行的扫描

Managing Scans

结束正在运行的任务

KILL_QUERY <id>

KILL_SCAN <id>

查询记录

SELECT * FROM <ns>[.<set>]

select * from test.myset

SELECT <bin>[, <bin>[, ...]] FROM <ns>[.<set>]

select name, age from test.myset

SELECT <bin>[, <bin>[, ...]] FROM <ns>[.<set>] WHERE [<predicate>]

<predicate>只能用在加索引的bin上

<bin> BETWEEN <lower> AND <upper>

<bin> = <value>

aql> CREATE INDEX user_age_idx ON test.myset (age) STRING

当age为数字型时：

aql> CREATE INDEX user_age_idx ON test.myset (age) NUMERIC

聚合查询或扫描结果

touch profile_aggregator.lua

vim profile_aggregator.lua

添加如下内容：（得到最年长的女性）

functionavg_age(stream)localfunctionfemale(rec)return rec.gender == "F"endlocalfunctionname_age(rec)return map{ name=rec.name, age=rec.age }  endlocalfunctioneldest(p1, p2)if p1.age > p2.age thenreturn p1    elsereturn p2    endendreturn stream : filter(female) : map(name_age) : reduce(eldest)end

ascli udf-put profile_aggregator.lua

AGGREGATE <module>.<function>([<arg>[,...]]) ON <ns>[.<set>] WHERE <predicate>

aql> AGGREGATE profile_aggregator.avg_age() ON users.profiles WHERE age BETWEEN 20 and 29+--------------------------------------++ avg_age                        |+--------------------------------------++ { "name": "Annie Black", "age": 28 } |+--------------------------------------+

PS：需要关注一下lua这门小脚本语言，将来可以依靠它在aerospike上进行一些统计，当然用户数据的统计如何进行也要进行详细而有远虑的设计。

记录操作

插入一条记录

INSERTINTO <ns>[.<set>] (PK, <bins>) VALUES (<key>, <values>)

得到一条记录

DELETEFROM <ns>[.<set>] WHERE PK=<key>

设置

所有set的值和属性只能保持在当前的session里面

aql> get <setting>

aql> get outputOUTPUT = TABLE

aql> set <setting> <value>

aql> set output json

可用的设置：

VIEW

输出模型.

VIEW ( TABLE | JSON )

例如

aql> set output table

VERBOSE

启用详细输出

VERBOSE ( TRUE | FALSE )

ECHO

Echo commands.

ECHO ( TRUE | FALSE )

TIMEOUT

查询过期时间，单位是毫秒

TIMEOUT <milliseconds>

RECORD_TTL

以秒为单位的时间,随后创建或更新记录服务器将会在设置的这个时间内有效。

RECORD_TTL <seconds>

LUA_USERPATH

用户管理的lua文件的路径

LUA_USERPATH <path>

LUA_SYSPATH

Aerospike管理的lua文件路径

LUA_SYSPATH <path>

统计

系统统计

aql> stat system+---------------------------------+--------------------+| name                            | value              |+---------------------------------+--------------------+| "cluster_size"                  | 1                  || "cluster_key"                   | "AA47E9295DD25BC2" || "cluster_integrity"             | "true"             || "objects"                       | 12                 |...179 rows in set (0.000 secs)

二级索引统计信息

aql> stat index test numindex+--------------------------+-------+| name                     | value |+--------------------------+-------+| "keys"                   | 6     || "objects"                | 11    || "data_memory_used"       | 1320  || "load_pct"               | 100   || "loadtime"               | 6     || "stat_write_reqs"        | 11    || "stat_write_success"     | 11    || "stat_write_errs"        | 0     || "stat_delete_reqs"       | 0     || "stat_delete_success"    | 0     || "stat_delete_errs"       | 0     || "stat_defrag_recs"       | 0     || "stat_defrag_time"       | 0     || "n_query"                | 6     || "avg_selectivity"        | 2     || "avg_record_size"        | 42    || "n_aggregation"          | 5     || "agg_avg_selectivity"    | 2     || "agg_avg_record_size"    | 8     || "n_lookups"              | 1     || "lookup_avg_selectivity" | 6     || "lookup_avg_record_size" | 106   |+--------------------------+-------+22 rows in set (0.000 secs)

查询统计

aql> stat query+--------------------------+-------+| name                     | value |+--------------------------+-------+| "n_query_reqs"           | 6     || "n_query_success"        | 6     || "n_query_abort"          | 0     || "n_query_fail"           | 0     || "avg_selectivity"        | 2     || "queue_full"             | 0     || "n_aggregations"         | 5     || "n_agg_success"          | 5     || "n_agg_abort"            | 0     || "avg_agg_selectivity"    | 2     || "n_lookups"              | 1     || "n_lookup_success"       | 1     || "n_lookup_abort"         | 0     || "avg_lookup_selectivity" | 6     |+--------------------------+-------+14 rows in set (0.000 secs)

UDF管理

注册一个模块

REGISTER MODULE '<filepath>'

aql> register module '~/tmp/my_udf.lua'

aql> show modules+---------------------------+-------+------------------------+| module                    | type  | hash                   |+---------------------------+-------+------------------------+| "example1.lua"            | "lua" | "033671e05067888fce09" || "example2.lua"            | "lua" | "07b42082cca8e73a96b2" |+---------------------------+-------+------------------------+2 rows in set (0.000 secs)

查看模块信息

DESC MODULE <module>

aql> desc module example2.lua+----------------------+-------+-------------------------+| gen                  | type  | content                 |+----------------------+-------+-------------------------+| "1t0IoVM2B/zwAb3QMa" | "LUA" | "CmxvY2FsIGZ1bmN0aW9uIG |+----------------------+-------+-------------------------+1 row in set (0.000 secs)

删除一个模块

REMOVE MODULE <module>

aql> remove module example2.lua

0 0