HTTP REST_SDK参考_图数据库GDB_阿里云技术文档

本文介绍如何使用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。

HTTP REST_SDK参考_图数据库GDB

HTTP REST

更多dsl示例

版权声明

评论