指定查询

Overview

在本指南中，您可以学习；了解如何使用Kotlin Sync驾驶员指定查询。

您可以通过创建查询筛选器来优化查询返回的文档集。 查询筛选器是一个表达式，用于指定Atlas Search MongoDB在读取或写入操作中用于匹配文档的 条件。在查询筛选器中，您可以提示驱动程序Atlas Search与您的查询完全匹配的文档，或者您可以组合查询筛选器以Express更复杂的匹配条件。

{ "_id": 1, "name": "apples", "quantity": 5, "rating": 3, "color": "red", "type": ["fuji", "honeycrisp"] },
{ "_id": 2, "name": "bananas", "quantity": 7, "rating": 4, "color": "yellow", "type": ["cavendish"] },
{ "_id": 3, "name": "oranges", "quantity": 6, "rating": 2, "type": ["naval", "mandarin"] },
{ "_id": 4, "name": "pineapple", "quantity": 3, "rating": 5, "color": "yellow" },

data class Fruit(
    @BsonId
    val id: Int,
    val name: String,
    val quantity: Int,
    val rating: Int,
    val color: String,
    val type: List<String>
)

val uri = "<connection string URI>"
val settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString(uri))
    .retryWrites(true)
    .build()
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("sample_fruit")
val collection = database.getCollection<Fruit>("fruits")
collection.insertMany(listOf(
    Fruit(1, "apples", 5, 3, "red", listOf("fuji", "honeycrisp")),
    Fruit(2, "bananas", 7, 4, "yellow", listOf("cavendish")),
    Fruit(3, "oranges", 6, 2, null, listOf("naval", "mandarin")),
    Fruit(4, "pineapples", 3, 5, "yellow", null)
))

精确匹配

字面值查询返回与查询筛选器精确匹配的文档。

以下示例将查询过滤指定为find()方法的参数。 该代码返回color字段值为"yellow"的所有文档。

val results = collection.find(eq(Fruit::color.name, "yellow"))
results.forEach { result ->
    println(result);
}

Fruit(id=2, name=bananas, quantity=7, rating=4, color=yellow, type=[cavendish])
Fruit(id=4, name=pineapples, quantity=3, rating=5, color=yellow, type=null)

比较操作符。

比较运算符会根据查询筛选器中的指定值评估文档字段值。 以下是常见比较操作符的列表：

• $gt：大于

• $lte：小于或等于

• $ne：不等于

要查看比较操作符的完整列表，请参阅 MongoDB Server 手册中的比较查询操作符指南。

以下示例将查询过滤中的操作符指定为find()方法的参数。 此代码会返回rating字段值大于2的所有文档。

val results = collection.find(gt(Fruit::rating.name, 2))
results.forEach { result ->
    println(result)
}

Fruit(id=1, name=apples, quantity=5, rating=3, color=red, type=[fuji, honeycrisp])
Fruit(id=2, name=bananas, quantity=7, rating=4, color=yellow, type=[cavendish])
Fruit(id=4, name=pineapples, quantity=3, rating=5, color=yellow, type=null)

逻辑操作符

逻辑操作符通过使用应用于两组或多组表达式结果的逻辑来匹配文档。 以下是逻辑操作符列表：

• $and，返回符合所有子句条件的所有文档

• $or，返回符合一个子句条件的所有文档

• $nor，返回所有不符合任一子句条件的文档

• $not，它会返回与表达式不匹配的所有文档

要了解有关逻辑操作符的更多信息，请参阅 MongoDB Server 手册中的逻辑查询操作符指南。

以下示例将查询过滤中的逻辑操作符指定为find()方法的参数。 此代码会返回quantity字段值大于5或color字段值为"yellow"的所有文档。

val results = collection.find(
    or(
        gt(Fruit::quantity.name, 5),
        eq(Fruit::color.name, "yellow")
    )
)
results.forEach { result ->
    println(result)
}

Fruit(id=2, name=bananas, quantity=7, rating=4, color=yellow, type=[cavendish])
Fruit(id=3, name=oranges, quantity=6, rating=2, color=null, type=[naval, mandarin])
Fruit(id=4, name=pineapples, quantity=3, rating=5, color=yellow, type=null)

数组操作符

数组操作符根据数组字段中元素的值或数量来匹配文档。 以下是可用数组操作符的列表：

• $all，它会返回带有数组的文档，而该数组包含查询中的所有元素

• $elemMatch，如果数组字段中的元素与查询中的所有条件匹配，则返回文档

• $size，返回包含指定大小数组的所有文档

要了解有关数组操作符的更多信息，请参阅 MongoDB Server 手册中的数组查询操作符指南。

以下示例将查询过滤中的大量操作符指定为find()方法的参数。 该代码返回具有恰好包含2元素的type大量字段的所有文档。

val results = collection.find(size(Fruit::type.name, 2))
results.forEach { result ->
    println(result)
}

Fruit(id=1, name=apples, quantity=5, rating=3, color=red, type=[fuji, honeycrisp])
Fruit(id=3, name=oranges, quantity=6, rating=2, color=null, type=[naval, mandarin])

元素操作符

元素操作符根据字段的存在或类型查询数据。

要了解有关元素操作符的更多信息，请参阅 MongoDB Server 手册中的元素查询操作符指南。

以下示例将查询过滤中的元素操作符指定为find()方法的参数。 该代码返回所有具有color字段的文档。

val results = collection.find(exists(Fruit::color.name))
results.forEach { result ->
    println(result)
}

Fruit(id=1, name=apples, quantity=5, rating=3, color=red, type=[fuji, honeycrisp])
Fruit(id=2, name=bananas, quantity=7, rating=4, color=yellow, type=[cavendish])
Fruit(id=4, name=pineapples, quantity=3, rating=5, color=yellow, type=null)

评估操作符

求值操作符根据对单个字段或整个文集文件的求值结果返回数据。

以下是常见评估操作符的列表：

• $text，对文档执行文本Atlas Search

• $regex，返回与指定正则表达式匹配的文档

• $mod，它执行 模数 对字段值进行运算，并返回余数为指定值的文档

要查看评估操作符的完整列表，请参阅 MongoDB Server 手册中的评估查询操作符指南。

以下示例将查询过滤中的评估操作符指定为find()方法的参数。 该代码使用正则表达式返回name字段值至少有两个连续"p"字符的所有文档。

val results = collection.find(regex(Fruit::name.name, "p{2,}"))
results.forEach { result ->
    println(result)
}

Fruit(id=1, name=apples, quantity=5, rating=3, color=red, type=[fuji, honeycrisp])
Fruit(id=4, name=pineapples, quantity=3, rating=5, color=yellow, type=null)

更多信息

要了解有关查询文档的更多信息，请参阅 MongoDB Server 手册中的查询文档指南。

要学习；了解有关使用Kotlin Sync驾驶员检索文档的更多信息，请参阅检索数据。