目录:
安装需要用到的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: 202, 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) instudents:
... doc=studentsCollection.createDocument()
... doc[‘name‘] = "%s %s" % (first, last)
... doc[‘gpa‘] =gpa
... doc[‘year‘] = 2017... 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 incol.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‘: 404,‘errorNum‘: 1202,‘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=100)>>> for key inqueryResult:
... print(key)
marywollstonecraft
katechopin
percyshelley
fyodordostoevsky
marktwain
...
参考资料: