pyarango整理
目录:
安装需要用到的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) in students:
... 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 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': 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 in queryResult:
... print(key)
marywollstonecraft
katechopin
percyshelley
fyodordostoevsky
marktwain
...
参考资料:
https://www.arangodb.com/tutorials/cn-tutorial-python/