MySQL中记录（Documents）的基本操作——添加记录和查找记录

在MySQL中，我们通常不称数据表中的记录为“文档”，而是称之为“行”或“记录”。记录表示为JSON对象。在内部，它们以高效的二进制格式存储，从而实现快速查找和更新。

添加记录

使用add（）方法可以将一个记录或记录列表插入到现有集合中。将以下记录插入countryinfo集合。由于这是多行内容，请按Enter键两次以插入记录。

mysql-js> 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-js> 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 8.0.11及更高版本中，记录id是由服务器生成的，而不是由客户端生成的，因此MySQL Shell不会自动设置_id值。如果记录不包含_id字段，则8.0.11或更高版本的MySQL服务器会设置_id值。在这种情况下，8.0版本或5.7版本的MySQL服务器不会设置_id值，因此必须显式指定。如果不这样做，MySQL Shell将返回错误5115记录缺少一个必填字段。

查找记录

您可以使用find（）方法从模式中的集合中查询和返回记录。MySQL Shell提供了额外的方法与find（）方法一起使用，以过滤和排序返回的记录。

MySQL提供了以下运算符来指定搜索条件：OR（||）、AND（&&）、XOR、IS、NOT、BETWEEN、IN、LIKE、！=、<>、>、>=、<、<=、&、|、<<、>>、+、-、*、/、~、和 %。

查找集合中的所有记录

若要返回集合中的所有记录，请使用find（）方法，而不指定搜索条件。例如，以下操作将返回countryinfo集合中的所有记录。

mysql-js> db.countryinfo.find()
[
     {
          "GNP": 828,
          "Code:": "ABW",
          "Name": "Aruba",
          "IndepYear": null,
          "geography": {
              "Continent": "North America",
              "Region": "Caribbean",
              "SurfaceArea": 193
          },
          "government": {
              "GovernmentForm": "Nonmetropolitan Territory of The Netherlands",
              "HeadOfState": "Beatrix"
          }
          "demographics": {
              "LifeExpectancy": 78.4000015258789,
              "Population": 103000
          },
          ...
      }
 ]
240 documents in set (0.00 sec)

该方法生成的结果除了包含集合中的所有记录之外，还包含操作信息。

空集（没有匹配的记录）返回以下信息：

Empty set (0.00 sec)

筛选搜索

您可以使用find（）方法包含搜索条件。所有表达式都必须用引号括起来。为了简洁起见，有些示例不显示输出。

一个简单的搜索条件可以由Name字段和一个我们知道在记录中的值组成。以下示例返回单个记录：

mysql-js> db.countryinfo.find("Name = 'Australia'")
[
    {
        "GNP": 351182,
        "Code:": "AUS",
        "Name": "Australia",
        "IndepYear": 1901,
        "geography": {
            "Continent": "Oceania",
            "Region": "Australia and New Zealand",
            "SurfaceArea": 7741220
        },
        "government": {
            "GovernmentForm": "Constitutional Monarchy, Federation",
            "HeadOfState": "Elisabeth II"
        }
        "demographics": {
            "LifeExpectancy": 79.80000305175781,
            "Population": 18886000
        },
    }
]

以下示例搜索所有国民生产总值高于5000亿美元的国家。国家信息收集以百万为单位衡量国民生产总值。

mysql-js> db.countryinfo.find("GNP > 500000")
...[output removed]
10 documents in set (0.00 sec)

以下查询中的“人口”字段嵌入到人口统计对象中。要访问嵌入的字段，请使用人口统计和人口统计之间的时间段来确定关系。记录和字段名称区分大小写。

mysql-js> db.countryinfo.find("GNP > 500000 and demographics.Population < 100000000")
...[output removed]
6 documents in set (0.00 sec)

以下表达式中的算术运算符用于查询人均国民生产总值高于30000美元的国家。搜索条件可以包括算术运算符和大多数MySQL函数。

注意：countryinfo集合中有七个记录的总体值为零。因此，警告消息会出现在输出的末尾。

mysql-js> db.countryinfo.find("GNP*1000000/demographics.Population > 30000")
...[output removed]
9 documents in set, 7 warnings (0.00 sec)
Warning (Code 1365): Division by 0
Warning (Code 1365): Division by 0
Warning (Code 1365): Division by 0
Warning (Code 1365): Division by 0
Warning (Code 1365): Division by 0
Warning (Code 1365): Division by 0
Warning (Code 1365): Division by 0

可以使用bind（）方法将值与搜索条件分离。例如，不要指定硬编码的国家/地区名称作为条件，而是替换一个由冒号和以字母开头的名称（如国家/地区）组成的命名占位符。然后使用bind（占位符，value）方法，如下所示：

mysql-js> db.countryinfo.find("Name = :country").bind("country", "Italy")
{
    "GNP": 1161755,
    "_id": "00005de917d8000000000000006a",
    "Code": "ITA",
    "Name": "Italy",
    "Airports": [],
    "IndepYear": 1861,
    "geography": {
        "Region": "Southern Europe",
        "Continent": "Europe",
        "SurfaceArea": 301316
    },
    "government": {
        "HeadOfState": "Carlo Azeglio Ciampi",
        "GovernmentForm": "Republic"
    },
    "demographics": {
        "Population": 57680000,
        "LifeExpectancy": 79
    }
}
1 document in set (0.01 sec)

在程序中，绑定使您能够在表达式中指定占位符，这些占位符在执行前用值填充，并且可以从自动转义中受益（视情况而定）。

始终使用绑定对输入进行清理。避免在使用字符串串联的查询中引入值，这可能会产生无效输入，在某些情况下还会导致安全问题。

您可以使用占位符和bind（）方法创建保存的搜索，然后使用不同的值调用这些搜索。例如，要创建已保存的国家/地区搜索：

mysql-js> var myFind = db.countryinfo.find("Name = :country")
mysql-js> myFind.bind('country', 'France')
{
    "GNP": 1424285,
    "_id": "00005de917d80000000000000048",
    "Code": "FRA",
    "Name": "France",
    "IndepYear": 843,
    "geography": {
        "Region": "Western Europe",
        "Continent": "Europe",
        "SurfaceArea": 551500
    },
    "government": {
        "HeadOfState": "Jacques Chirac",
        "GovernmentForm": "Republic"
    },
    "demographics": {
        "Population": 59225700,
        "LifeExpectancy": 78.80000305175781
    }
}
1 document in set (0.0028 sec)
 
mysql-js> myFind.bind('country', 'Germany')
{
    "GNP": 2133367,
    "_id": "00005de917d80000000000000038",
    "Code": "DEU",
    "Name": "Germany",
    "IndepYear": 1955,
    "geography": {
        "Region": "Western Europe",
        "Continent": "Europe",
        "SurfaceArea": 357022
    },
    "government": {
        "HeadOfState": "Johannes Rau",
        "GovernmentForm": "Federal Republic"
    },
    "demographics": {
        "Population": 82164700,
        "LifeExpectancy": 77.4000015258789
    }
}
 
1 document in set (0.0026 sec)

项目成果

您可以返回记录的特定字段，而不是返回所有字段。以下示例返回countryinfo集合中与搜索条件匹配的所有记录的GNP和Name字段。

使用fields（）方法传递要返回的字段列表。

mysql-js> db.countryinfo.find("GNP > 5000000").fields(["GNP", "Name"])
[
    {
        "GNP": 8510700,
        "Name": "United States"
    }
]
1 document in set (0.00 sec)

此外，还可以通过表达式来描述想要返回的记录，并对这些返回的记录进行修改，比如添加、重命名、嵌套字段，甚至计算新的字段值。

例如，使用以下表达式更改字段的名称以仅返回两个记录。

mysql-js> db.countryinfo.find().fields(
mysqlx.expr('{"Name": upper(Name), "GNPPerCapita": GNP*1000000/demographics.Population}')).limit(2)
{
    "Name": "ARUBA",
    "GNPPerCapita": 8038.834951456311
}
{
    "Name": "AFGHANISTAN",
    "GNPPerCapita": 263.0281690140845
}

限制、排序和跳过结果

您可以应用limit（）、sort（）和skip（）方法来管理find（）方法返回的记录的数量和顺序。

要指定结果集中包含的记录数，请在find（）方法后面附加一个值的limit（）方法。以下查询返回countryinfo集合中的前五个记录。

mysql-js> db.countryinfo.find().limit(5)
... [output removed]
5 documents in set (0.00 sec)

若要对查询结果进行排序，可以在find()方法后附加sort()方法。你需要向sort()方法传递一个或多个字段名称的列表，用以指明排序的依据。同时，你还可以选择性地为每个字段指定排序方式，即升序（asc）或降序（desc）。若未明确指定，则默认采用升序排序。 

例如，以下查询按IndepYear字段对所有记录进行排序，然后按降序返回前八个记录。

mysql-js> db.countryinfo.find().sort(["IndepYear desc"]).limit(8)
... [output removed]
8 documents in set (0.00 sec)

limit()方法默认从集合中的第一个记录开始返回结果。如果你想改变起始的记录，可以使用skip()方法。例如，如果你想忽略第一个记录，并返回接下来符合条件的八个记录，你可以将1作为参数传递给skip()方法。

mysql-js> db.countryinfo.find().sort(["IndepYear desc"]).limit(8).skip(1)
... [output removed]
8 documents in set (0.00 sec)