MySQL 8.4 Release Notes
22.4.3.2 使用集合
要在模式中工作,使用全局对象db
来访问当前模式。在这个例子中,我们正在使用之前导入的world_x
模式,并且是countryinfo
集合。因此,你发出的操作的格式为db.
,其中collection_name
.operationcollection_name
是操作将执行到的集合的名称。在以下示例中,所有操作都将对countryinfo
集合执行。
使用add()
方法将一个文档或多个文档插入现有集合。将以下文档插入到countryinfo
集合中。由于这是一段多行内容,请按两次Enter来插入文档。
mysql-py> db.countryinfo.add(
{
"GNP": .6,
"IndepYear": 1967,
"Name": "Sealand",
"Code:": "SEA",
"demographics": {
"LifeExpectancy": 79,
"Population": 27
},
"geography": {
"Continent": "Europe",
"Region": "British Islands",
"SurfaceArea": 193
},
"government": {
"GovernmentForm": "Monarchy",
"HeadOfState": "Michael Bates"
}
}
)
方法返回操作的状态。你可以通过搜索文档来验证操作。例如:
mysql-py> db.countryinfo.find("Name = 'Sealand'")
{
"GNP": 0.6,
"_id": "00005e2ff4af00000000000000f4",
"Name": "Sealand",
"Code:": "SEA",
"IndepYear": 1967,
"geography": {
"Region": "British Islands",
"Continent": "Europe",
"SurfaceArea": 193
},
"government": {
"HeadOfState": "Michael Bates",
"GovernmentForm": "Monarchy"
},
"demographics": {
"Population": 27,
"LifeExpectancy": 79
}
}
注意,除了在文档添加时指定的字段之外,还有一个额外的字段,即_id
。每个文档都需要一个唯一标识符字段叫做_id
。文档ID由服务器生成,不是客户端,因此MySQL Shell不会自动设置一个_id
值。如果文档不包含_id
字段,MySQL会为其设置一个_id
值。有关更多信息,请参阅理解文档ID。
-
查看CollectionAddFunction以获取完整语法定义。
-
查看理解文档ID。