find

Команда find в Azure DocumentDB используется для запроса документов в коллекции. Эта команда является основой для операций извлечения данных и может быть настроена с помощью фильтров, проекций и параметров запроса для точной настройки результатов.

Синтаксис

Базовый find синтаксис для команды:

db.collection.find(query, projection, options)

Параметры

Параметр	Description
`query`	Документ, указывающий критерии извлечения документов
`projection`	(Необязательно) Документ, указывающий поля в соответствующих документах, возвращаемых в результирующем наборе.
`options`	(Необязательно) Документ, указывающий параметры поведения запросов и результатов

Примеры

Рассмотрим этот пример документа из коллекции хранилищ в базе данных StoreData.

{
    "_id": "0fcc0bf0-ed18-4ab8-b558-9848e18058f4",
    "name": "First Up Consultants | Beverage Shop - Satterfieldmouth",
    "location": {
        "lat": -89.2384,
        "lon": -46.4012
    },
    "staff": {
        "totalStaff": {
            "fullTime": 8,
            "partTime": 20
        }
    },
    "sales": {
        "totalSales": 75670,
        "salesByCategory": [
            {
                "categoryName": "Wine Accessories",
                "totalSales": 34440
            },
            {
                "categoryName": "Bitters",
                "totalSales": 39496
            },
            {
                "categoryName": "Rum",
                "totalSales": 1734
            }
        ]
    },
    "promotionEvents": [
        {
            "eventName": "Unbeatable Bargain Bash",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 6,
                    "Day": 23
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 7,
                    "Day": 2
                }
            },
            "discounts": [
                {
                    "categoryName": "Whiskey",
                    "discountPercentage": 7
                },
                {
                    "categoryName": "Bitters",
                    "discountPercentage": 15
                },
                {
                    "categoryName": "Brandy",
                    "discountPercentage": 8
                },
                {
                    "categoryName": "Sports Drinks",
                    "discountPercentage": 22
                },
                {
                    "categoryName": "Vodka",
                    "discountPercentage": 19
                }
            ]
        },
        {
            "eventName": "Steal of a Deal Days",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 21
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 9,
                    "Day": 29
                }
            },
            "discounts": [
                {
                    "categoryName": "Organic Wine",
                    "discountPercentage": 19
                },
                {
                    "categoryName": "White Wine",
                    "discountPercentage": 20
                },
                {
                    "categoryName": "Sparkling Wine",
                    "discountPercentage": 19
                },
                {
                    "categoryName": "Whiskey",
                    "discountPercentage": 17
                },
                {
                    "categoryName": "Vodka",
                    "discountPercentage": 23
                }
            ]
        }
    ]
}

Пример 1. Извлечение всех документов

Команда find() без фильтров запросов возвращает все документы в коллекции.

db.stores.find()

Пример 2. Получение документов с помощью фильтров запросов

Получение документов с помощью фильтра в свойстве имени.

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"})

Пример 3. Получение документов с фильтрами запросов для объектов

Получение документов с помощью фильтров запросов в полях lat и lon в объекте расположения.

db.stores.find({"location.lat": 13.5236, "location.lon": -82.5707})

Если нотация точки (.) не используется для ссылки на поля в объекте, фильтр запросов должен точно соответствовать всему объекту, включая порядок полей.

db.stores.find({"location": {"lat": 13.5236, "lon": -82.5707}})

Пример 4. Получение документов с фильтрами запросов в массивах

Извлеките документы из массива promotionEvents, где имя события — "Гранд-сделка Гала".

db.stores.find({"promotionEvents.eventName": "Grand Bargain Gala"})

Извлеките документы из массива "скидки", который находится в массиве promotionEvents, где имя категории — "Области ружья".

db.stores.find({"promotionEvents.discounts.categoryName": "Area Rugs"})

Проекции

Второй документ в команде поиска указывает список полей для проекта в ответе.

Включение определенного поля или нескольких полей в ответ

Целочисленное значение, отличное от нуля, или логическое значение true включает поле в ответе.

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"}, {"location": 1, "sales": 1})

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"}, {"location": true, "sales": true})

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"}, {"location": 1, "sales": true})

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"}, {"location": 1, "sales": -5})

Все четыре запроса эквивалентны и указывают включение полей location и sales в ответе сервера.

{
    "_id": "b5c9f932-4efa-49fd-86ba-b35624d80d95",
    "location": {
        "lat": 13.5236,
        "lon": -82.5707
    },
    "sales": {
        "totalSales": 35346,
        "salesByCategory": [
            {
                "categoryName": "Rulers",
                "totalSales": 35346
            }
        ]
    }
}

Исключение определенного поля или нескольких полей в ответе

Целочисленное значение нуля или логическое значение false исключает указанное поле из ответа запроса.

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"}, {"promotionEvents": 0, "location": 0, "sales": 0})

db.stores.find({"name": "Fourth Coffee | Stationery Haven - New Franco"}, {"promotionEvents": false, "location": false, "sales": false})

Оба запроса эквивалентны и возвращают следующий ответ:

{
    "_id": "b5c9f932-4efa-49fd-86ba-b35624d80d95",
    "name": "Fourth Coffee | Stationery Haven - New Franco",
    "staff": {
        "totalStaff": {
            "fullTime": 17,
            "partTime": 5
        }
    }
}

Замечание

По умолчанию поле _id включается в ответ сервера. Документ проекции не может содержать предложения включения и исключения. Однако поле _id является единственным исключением из этого правила и может быть исключено вместе со списком полей для включения и наоборот.

Проект первого элемента массива, соответствующего критериям фильтра запросов

Команда arrayFieldName.$ проектирует только первое вхождение объекта в массиве, который соответствует указанным фильтрам запросов.

db.stores.find({"promotionEvents.eventName": "Grand Bargain Gala"}, {"promotionEvents.$": true})

Один из возвращенных документов показывает только первый элемент в массиве promotionEvents с именем события "Grand Bargain Гала" при исключении всех остальных элементов в массиве.

{
    "_id": "d7fe6fb9-57e8-471a-b8d2-714e3579a415",
    "promotionEvents": [
        {
            "eventName": "Grand Bargain Gala",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024,
                    "Month": 3,
                    "Day": 25
                },
                "endDate": {
                    "Year": 2024,
                    "Month": 4,
                    "Day": 1
                }
            },
            "discounts": [
                {
                    "categoryName": "Area Rugs",
                    "discountPercentage": 7
                },
                {
                    "categoryName": "Vinyl Flooring",
                    "discountPercentage": 12
                }
            ]
        }
    ]
}

Определенные элементы проекта в массиве, соответствующие критериям фильтра запросов

Этот запрос проектирует свойство eventName и вложенное свойство Year в массиве promotionEvents.

db.stores.find({"promotionEvents.eventName": "Grand Bargain Gala"}, {"promotionEvents.eventName": true, "promotionEvents.promotionalDates.startDate.Year": true})

Один из возвращенных документов показывает указанные элементы массива, проецируемые в ответе.

{
    "_id": "d7fe6fb9-57e8-471a-b8d2-714e3579a415",
    "promotionEvents": [
        {
            "eventName": "Grand Bargain Gala",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024
                }
            }
        },
        {
            "eventName": "Grand Bargain Bash",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024
                }
            }
        },
        {
            "eventName": "Epic Bargain Bash",
            "promotionalDates": {
                "startDate": {
                    "Year": 2024
                }
            }
        }
    ]
}

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-11-19