pyarango整理

目录：

• 连接数据库
• 创建数据库/集合/文档
• 检索筛选
• 更新
• 删除
• 调用AQL的方法

安装需要用到的python包：

pip install pyarango

一、连接数据库：

>>> from pyArango.connection import *
>>> conn = Connection(username="root", password="root_passwd")

当该代码执行时，它会初始化 conn 变量上的服务器连接。默认情况下，pyArango会尝试建立与http://127.0.0.1:8529的连接。

二、创建数据库/集合/文档

创建和打开数据库

方法：

createDatabase()

该方法可以在服务器上打开或创建数据库，当要连接的数据库不存在时，pyArango会在服务器上创建它。当它存在时，pyArango会尝试打开数据库。

>>> db = conn.createDatabase(name="school")

也可以使用其名称作为服务器连接上的键来打开现有数据库：

>>> db = conn["school"]
>>> db
ArangoDB database: school

创建集合

方法：

createCollection()

>>> studentsCollection = db.createCollection(name="Students")
>>> db["Students"]
ArangoDB Collection name: Students, id: , type: document, status loaded

创建文档

方法：

createDocument()

>>> doc1 = studentsCollection.createDocument()
>>> doc1["name"] = "John Smith"
>>> doc1
ArangoDoc 'None': {'name': 'John Smith'}
>>> doc2 = studentsCollection.createDocument()
>>> doc2["firstname"] = "Emily"
>>> doc2["lastname"] = "Bronte"
>>> doc2
ArangoDoc 'None': {'firstname': 'Emily', 'lastname': 'Bronte'} 

因为尚未将其保存到ArangoDB，所以该文档显示其 _id 为“None”。这意味着该变量存在于您的Python代码中，但不存在于数据库中。 ArangoDB 通过将集合名称与 __key 值进行配对来构造 _id 值。

保存文档：

>>> doc1._key = "johnsmith"
>>> doc1.save()
>>> doc1
ArangoDoc 'Students/johnsmith': {'name': 'John Smith'}

循环输入数据：

>>> students = [('Oscar', 'Wilde', 3.5), ('Thomas', 'Hobbes', 3.2),
... ('Mark', 'Twain', 3.0), ('Kate', 'Chopin', 3.8), ('Fyodor', 'Dostoevsky', 3.1),
... ('Jane', 'Austen',3.4), ('Mary', 'Wollstonecraft', 3.7), ('Percy', 'Shelley', 3.5),
... ('William', 'Faulkner', 3.8), ('Charlotte', 'Bronte', 3.0)]
>>> for (first, last, gpa) in students:
...    doc = studentsCollection.createDocument()
...    doc['name'] = "%s %s" % (first, last)
...    doc['gpa'] = gpa
...    doc['year'] =
...    doc._key = ''.join([first, last]).lower()
...    doc.save()

三、检索筛选

查看某一个特定学生的GPA：

>>> def report_gpa(document):
...    print("Student: %s" % document['name'])
...    print("GPA:     %s" % document['gpa'])
>>> kate = studentsCollection['katechopin']
>>> report_gpa(kate)
Student: Kate Chopin
GPA:     3.8

筛选平均成绩在3.5以上的学生：

方法：

fetchAll()

>>> def top_scores(col, gpa):
...    print("Top Soring Students:")
...    for student in col.fetchAll():
...       if student['gpa'] >= gpa:
...          print("- %s" % student['name'])
>>> top_scores(studentsCollection, 3.5)
Top Scoring Students:
- Mary Wollstonecraft
- Kate Chopin
- Percy Shelly
- William Faulkner
- Oscar Wilde

四、更新

可以定义一个特定的函数来处理更新：

>>> def update_gpa(key, new_gpa):
...    doc = studentsCollection[key]
...    doc['gpa'] = new_gpa
...    doc.save()

五、删除

方法：

delete()

>>> tom = studentsCollection["thomashobbes"]
>>> tom.delete()
>>> studentsCollection["thomashobbes"]
KeyError: (
   'Unable to find document with _key: thomashobbes', {
      'code': ,
      'errorNum': ,
      'errorMessage': 'document Students/thomashobbes not found',
      'error': True
})

六、调用AQL的方法

除了上面显示的Python方法之外，ArangoDB还提供了一种查询语言（称为AQL），用于检索和修改数据库上的文档。在pyArango中，您可以使用 AQLQuery() 方法执行这些查询。

检索所有文档的_key：

>>> aql = "FOR x IN Students RETURN x._key"
>>> queryResult = db.AQLQuery(aql, rawResults=True, batchSize=)
>>> for key in queryResult:
...    print(key)
marywollstonecraft
katechopin
percyshelley
fyodordostoevsky
marktwain
...

参考资料：

https://www.arangodb.com/tutorials/cn-tutorial-python/