安装需要用到的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/

巴特西

pyarango整理

目录：