X DevAPI 用户指南 / 第 4 章使用集合 /
4.1 集合的基本 CRUD 操作
使用 X DevAPI 时,处理文档集合非常简单。以下示例显示了在处理文档时 CRUD 操作的基本用法(有关更多详细信息,请参见
第 4.3 节“集合 CRUD 功能概述”): 建立与 MySQL 服务器实例的连接后,将创建一个可以保存 JSON 文档的新集合并插入了几个文档。然后,执行查找操作以从集合中搜索特定文档。最后,该集合再次从数据库中删除。该示例假定
test
模式存在并且集合
my_collection
不存在。
# Connecting to MySQL Server and working with a Collection
from mysqlsh import mysqlx
# Connect to server
mySession = mysqlx.get_session( {
'host': 'localhost', 'port': 33060,
'user': 'user', 'password': 'password'} )
myDb = mySession.get_schema('test')
# Create a new collection 'my_collection'
myColl = myDb.create_collection('my_collection')
# Insert documents
myColl.add({ 'name': 'Laurie', 'age': 19 }).execute()
myColl.add({ 'name': 'Nadya', 'age': 54 }).execute()
myColl.add({ 'name': 'Lukas', 'age': 32 }).execute()
# Find a document
docs = myColl.find('name like :param1 AND age < :param2') \
.limit(1) \
.bind('param1','L%') \
.bind('param2',20) \
.execute()
# Print document
doc = docs.fetch_one()
print(doc)
# Drop the collection
myDb.drop_collection('my_collection')