HTTP REST
本文介绍如何使用HTTP REST方式连接和操作图数据库GDB。REST API兼容Gremlin3.3.x和3.4.0版本。
进行以下操作时,请确保图数据库GDB的实例与您的ECS虚拟机处于同一个Virtual Private Cloud(VPC)网络环境。
以下范例中,需要将配置信息替换成您的图数据库实例的相关信息:
- 将
${your-gdb-endpoint}
改为您的图数据库GDB实例的域名 - 将
${username}
改为您的图数据库GDB实例的用户名 - 将
${password}
改为您的图数据库GDB实例的密码
1、图数据库GDB的HTTP接入点为${your_gdb_endpoint}:8182/gremlin
。
2、连接的时候可以使用GET
请求,也可以使用POST
请求。但是建议使用POST
请求进行操作:
curl -u ${username}:${password} -X POST -d '{"gremlin":"g.V().limit(1)"}' http://${your_gdb_endpoint}:8182/gremlin
//此处注意需要对label值的双引号进行转义
curl -u ${username}:${password} -X POST -d '{"gremlin":"gremlin:g.V().hasLabel(\"movie\").limit(10)"}' http://${your_gdb_endpoint}:8182/gremlin
curl -u ${username}:${password} "http://${your_gdb_endpoint}:8182/gremlin?gremlin=g.V().limit(1)"
3、使用REST请求访问服务器的时候,可以以binding形式携带参数:
curl -u ${username}:${password} -X POST -d '{"gremlin":"g.V().limit(n)","bindings":{"n":1}}' http://${your_gdb_endpoint}:8182/gremlin
4、返回结果范例为:
{
"requestId": "e640005a-f2fd-403e-812c-f61e7a3fb7cb",
"result": {
"data": {
"@type": "g:List",
"@value": [
{
"@type": "g:Vertex",
"@value": {
"id": "3a63cc90-d957-4324-9ffc-16a8e4c1c1f4",
"label": "label",
"properties": {
"pint": [
{
"@type": "g:VertexProperty",
"@value": {
"id": "3a63cc90-d957-4324-9ffc-16a8e4c1c1f4",
"label": "label",
"value": {
"@type": "g:Int32",
"@value": 3
}
}
}
]
}
}
}
]
},
"meta": {
"@type": "g:Map",
"@value": []
}
},
"status": {
"attributes": {
"@type": "g:Map",
"@value": []
},
"code": 200,
"message": ""
}
}
更多dsl示例
- 上面的例子是使用
g.V().limit(n)
遍历返回GDB中的部分点。要查询其他内容,可以替换成其他的DSL - 其他dsl范例如下,图的点、边结构链接 http://tinkerpop.apache.org/docs/current/reference/#traversal
- 注意下面dsl需要改造成参数化的调用方式, 利用 gremlin + bindings来构造
DSL硬编码
g.V().hasLabel('gdb_sample_person').drop()
|
|
V
参数化调用
g.V().hasLabel(label).drop()
bindings:{"label":"gdb_sample_person"}
删除指定label的点、边
g.E().hasLabel('gdb_sample_knows').drop()
g.E().hasLabel('gdb_sample_created').drop()
g.V().hasLabel('gdb_sample_person').drop()
g.V().hasLabel('gdb_sample_software').drop()
添加顶点,为其设置id、property
g.addV('gdb_sample_person').property(id, 'gdb_sample_marko').property('age', 28).property('name', 'marko')
g.addV('gdb_sample_person').property(id, 'gdb_sample_vadas').property('age', 27).property('name', 'vadas')
g.addV('gdb_sample_person').property(id, 'gdb_sample_josh').property('age', 32).property('name', 'josh')
g.addV('gdb_sample_person').property(id, 'gdb_sample_peter').property('age', 35).property('name', 'peter')
g.addV('gdb_sample_software').property(id, 'gdb_sample_lop').property('lang', 'java').property('name', 'lop')
g.addV('gdb_sample_software').property(id, 'gdb_sample_ripple').property('lang', 'java').property('name', 'ripple')
修改(或新增) age 属性
g.V('gdb_sample_marko').property('age', 29)
建立关系,设置属性 weight
g.addE('gdb_sample_knows').from(V('gdb_sample_marko')).to(V('gdb_sample_vadas')).property('weight', 0.5f)
g.addE('gdb_sample_knows').from(V('gdb_sample_marko')).to(V('gdb_sample_josh')).property('weight', 1.0f)
g.addE('gdb_sample_created').from(V('gdb_sample_marko')).to(V('gdb_sample_lop')).property('weight', 0.4f)
g.addE('gdb_sample_created').from(V('gdb_sample_josh')).to(V('gdb_sample_lop')).property('weight', 0.4f)
g.addE('gdb_sample_created').from(V('gdb_sample_josh')).to(V('gdb_sample_ripple')).property('weight', 1.0f)
g.addE('gdb_sample_created').from(V('gdb_sample_peter')).to(V('gdb_sample_lop')).property('weight', 0.2f)
查询所有点/指定label的点数量
g.V().count()
g.V().hasLabel('gdb_sample_person').count()
查询指定条件的顶点 (>29岁的人, 按name降序排列所有人)
g.V().hasLabel('gdb_sample_person').has('age', gt(29))
g.V().hasLabel('gdb_sample_person').order().by('name', decr)
关联查询(获取 marko 认识的人, marko认识的人created的software)
g.V('gdb_sample_marko').outE('gdb_sample_knows').inV().hasLabel('gdb_sample_person')
g.V('gdb_sample_marko').outE('gdb_sample_knows').inV().hasLabel('gdb_sample_person').outE('gdb_sample_created').inV().hasLabel('gdb_sample_software')
删除关系、顶点
g.V('gdb_sample_marko').outE('gdb_sample_knows').where(inV().has(id, 'gdb_sample_josh')).drop()
g.V('gdb_sample_marko').drop()
有关Gremlin REST接口的更多信息,请参阅Apache TinkerPop3文档中的Connecting via HTTP。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论