pyorient
简介
pyorient是orientdb的python库
该库提供两种访问orientdb的方式：1、client 的方式
2、ogm 的方式（类似于ORM）
由于OGM 封装了client，且由于OGM 易于理解，操作简单，所以，这里主要介绍OGM。
创建/连接数据库
导入OGM 所需模块
from pyorient.ogm import Graph, Config
实例化 graph
config = Config.from_url('/localhost/test','root','root')
graph = Graph(config,'admin','admin')
注 ：
- config 中的两个 root 分别为orientdb 实例的用户名和密码。类似于如下命令
orientdb > connect remote:localhost root root
graph 中的两个 admin 即想要连接的数据库的用户名和密码
- 由于Graph() 会调用open 方法，所以，如果数据库中没有将要连接的数据库，那么就会创建一个新的，相应的数据库。
操作数据库
映射
和ORM类似，OGM会将 python 代码中的 class 映射到orientdb中的class。相当于关系型数据库中的表；python中class的属性即为orientd中class的property。即相当于关系型数据库中表的字段/列
想要将python中的class 映射到orientdb 中的class，需要将python中的class进行注册。
代码如下:
from pyorient.ogm.declarative import declarative_node, declarative_relationship
Node = declarative_node()
Relationship = declarative_relationship()
class Person(Node):
pass
class Likes(Relationship):
pass
graph.create_all(Node.registry)
graph.create_all(Relationship.registry)
注：
- 每一次调用declarative_node( ) 和 declarative_relationship( ) 都会生成相应的注册表。其实Node和Relationship是两个基类。
- create_all( ) 命令就会在orientdb中创建相应的class，如果该class已经存在，那么就会更新该class。
Boker (代理)
OGM 拥有多层映射。
上面提到的python class 到 orientdb class 是一层映射。另一层映射是python class 的object(对象) 和orientdb中具体的 vertex 和 edge 之间的映射。Boker 即工作在这一层。该层映射成功后，会自动为每一个class 创建个一个boker对象。需要注意的是vertex类需要有element_plural 属性，relationship类需要有 label 属性。
代码如下：
class Foo(Node):
element_plural = 'foos'
name = String()
class Friend(Relationship):
label = 'friends'
graph.include(Node.registry)
graph.foos.create(name='Bar')
Foo.objects.create(name='Baz')
find_bar = graph.foos.query(name='Bar')
注
- graph.foos 和Foo.objects 都是一样的，都是boker对象。
- Relationship 的子类，在orientdb中 是用 label 来命名类名的。如 Friend 类在数据库中的类名为friends
- query() 反回的是一个查询集对象。
命令
inE() outE() bothE()
返回进/出/进出自一个顶点或者类的 边的对象
in_() out() both()
返回 进/出/进出 自一个边的或者类的 顶点的对象。
get_vertex() get_edge() get_element()
获取 顶点/边/顶点或者边
element 包括顶点和边两种对象。
create_class() create_vertex() create_edge() drop_class()
创建 顶点或边/顶点/边 ; 删除类
open() drop()
打开/关闭一个数据库
注 ： 调用open( )时，如果该数据库不存在，则自动创建。
调用drop( ) 时，需要有一个已经打开的数据库。
query()
返回一个query对象。具有all count group_by order_by filter 等方法，可以对查询结果进行处理。
update() clear_registry()
更新python中orientdb对象的元素注册表 /清除元素注册表
字段类型
在OGM中，python类的属性就是orientdb 的property，也就是相当于关系型数据库中的字段/列。在pyorient中，字段类型有 String Boolean Float Date 等类型。这些字段又有如下属性。
name 会覆盖掉 “=” 前面命名的属性名。
nullable 允许为空
readonly 只读
default 默认值
indexed 是否为索引值
unique 是否唯一，如果为真，那么会创建相应的索引。
mandatory 是否强制有值。如果没有设置可以为空，那么默认设定为强制有值。
