解读Neo4j全新的Python驱动程序

xman

原文：The World’s Most Amazing Python Driver for Neo4j
作者： Nigel Small
译者：仲培艺，关注数据库领域，纠错

尽管Neo4j社区目前已发布了Java、Python、JavaScript和.NET官方支持的驱动程序，但其发展并未停步。本周，Neo4j发布驱动程序py2neo 3.1版本，同时还为Python用户推出了全新的OGM。

OGM（Object-Graph Mapper）和图形数据库的关系，就相当于ORM（对象关系映射）和传统RDMS之间的关系：前者都是一个架构，可供构建database-aware领域对象（domain objects）。

Py2neo OGM的操作围绕新的GraphObject类展开。此处其扮演基础类和管理者的双重角色：前者限定了领域对象；后者则支持基础节点和使py2neo OGM持久化的相关平台。

借Movie Graph（和Neo4j预先打包）为例，以该数据集为基础，模拟一个Person类：

1. class Person(GraphObject):
   
2.     __primarykey__ = "name"
   
3.     name = Property()
   
4.     born = Property()

复制代码

此处，一个Person类有两类属性。而Neo4j的属性没有固定类型，因此，比起典型ORM下的SQL字段，其相关定义较少。

类属性和基础属性名称相同：命名和生成。必要时，其可重定向为不同名属性，含表达式例如Property（name="actual_name"）。

最终，定义一个主键（primarykey），指出哪种属性是push和pull操作的唯一标识符；定义一个primarylabel，尽管是默认条件，仍可用Person代替。

综上所述，可以通过一个Cypher statement，挑选出一个特定Person对象节点：

1. MATCH (a:Person) WHERE a.name = {n} RETURN a

复制代码

此外，如果想要在同一个数据集内，模拟Person和Movie，还有其关联平台，可通过以下途径：

1. class Movie(GraphObject):
   
2.     __primarykey__ = "title"
   
3.     title = Property()
   
4.     tagline = Property()
   
5.     released = Property()
   
6.     actors = RelatedFrom("Person", "ACTED_IN")
   
7.     directors = RelatedFrom("Person", "DIRECTED")
   
8.     producers = RelatedFrom("Person", "PRODUCED")
   
9. class Person(GraphObject):
   
10.     __primarykey__ = "name"
    
11.     name = Property()
    
12.     born = Property()
    
13.     acted_in = RelatedTo(Movie)
    
14.     directed = RelatedTo(Movie)
    
15.     produced = RelatedTo(Movie)

复制代码

此处包含两类新属性：RelatedTo和RelatedFrom。这两类属性定义了关系对象集（连接方式相似）。换句话说，就是它们共享相同的开始节点或终止节点，和共同的关系类型。

以acted_in = RelatedTo（Movie）为例，它描述了一组Movie关系节点集，这些节点都是通过一个输出ACTED_IN关系来连接的。这里要注意的是，和上面提及的属性命名一样，关系类型也默认自动匹配属性名，只不过此处字母为大写形式。相反，对应的反向定义，actors = RelatedFrom（"erson", "ACTED_IN"）则明指定了关系名，以区分与属性名的差异。

为了研究执行对象的方法，可以假设一个情境：需要从数据库中提取出Keanu Reeves，并将他和经典影片Bill & Ted’s Excellent Adventure相连接 （不包含在原始图当中）。在这种情况下，首先要利用GraphObject类，并通过Person子类选择演员。随后，构建一个新的Movie对象，并添加到Keanu Reeves参与演出的影片集当中。最终，将上述全部信息汇入图表中。进程代码如下：

1. keanu = Person.select(graph, "Keanu Reeves").first()
   
2. bill_and_ted = Movie()
   
3. bill_and_ted.title = "Bill & Ted's Excellent Adventure"
   
4. keanu.acted_in.add(bill_and_ted)
   
5. graph.push(keanu)

复制代码

通过一个类似集的端口（提供添加和移除方法），关系对象支持其父类对象。这些数据汇入图表之后，为了完成操作，OGM架构自动构建并运行所有必要的Cypher。

该方法也可用于执行其它更复杂的选择。Where
method可利用所有WHERE
子句中的expression。比如要输出所有名字首字母是“K”的演员，操作如下：

1. for person in Person.select(graph).where("_.name =~ 'K.*'"):
   
2.     print(person.name)

复制代码

注意：此处用到下划线字符来指代待匹配节点。

Py2neo文档还包含很多其它信息，且GitHub知识库当中还有一个演示应用程序，该程序展示了一个微型movie浏览器（截图如下）当中，一切是如何运行的。