/ /

/ /

オブジェクトの配列のクエリ、フィルタリング、取得

returnScope オプションを使用してクエリのコンテキストを設定し、オブジェクトの配列を個別のドキュメントとして返すことができます。

要件

returnScope を使用してネストされたオブジェクトを個々のドキュメントとして取得するには、次の操作を行う必要があります。

オブジェクトの配列を embeddedDocuments 型としてインデックス化します。
検索するネストされたフィールドに対して storedSource を定義します。 MongoDB Search は、で定義されているフィールドのみを返します。storedSource
クエリで returnStoredSource オプションをtrue に設定します。

構文

returnScope クエリでは、次の構文を使用します。

{
  $search: {
   "<operator>": {
      <operator-specification>,
   },
   "returnScope": {
      "path": "<embedded-documents-field-to-retrieve>"
   },
   "returnStoredSource": true
  }
}

{
  $searchMeta: {
   "returnScope": {
      "path": "<embedded-documents-field-to-retrieve>"
   },
   "returnStoredSource": true
  },
  "facet": {
    "<operator>": {
      <operator-specification>,
   },
    "facets": {
      <facet-definition>
    }
  }
}

クエリ構文の詳細については、 $searchを参照してください。

動作

returnScope オプションは、クエリの取得コンテキストを設定します。クエリで returnScope を指定すると、 MongoDB Search は各埋め込みドキュメントを個々のドキュメントとみなしてスコア付け、ソート、カウントします。

Considerations

演算子仕様では、クエリするフィールドへの完全なパスを指定する必要があります。

returnScope オプションを使用すると、 MongoDB Search は embeddedDocument 内で storedSource として構成したフィールドのみを返します。 embeddedDocument パス外のフィールド（ルートレベルのフィールドなど）および storedSource として構成されていないフィールドは返されません。

例

次の例は、クエリで returnScope オプションを使用する方法を示しています。例では、sample_training.companiesサンプルデータセットを使用します。クラスターにデータをロードし、コレクションのフィールドにサンプルインデックスを作成したら、サンプルデータに対して次のクエリを試すことができます。

サンプルインデックス

1 {
2   "mappings": { 
3     "dynamic": false,
4     "fields": { 
5       "funding_rounds": { 
6         "type": "embeddedDocuments",
7         "dynamic": true,
8         "fields": {
9           "investments": {
10             "type": "embeddedDocuments",
11             "dynamic": true
12           }
13         },
14         "storedSource": {
15           "include": [
16             "round_code", 
17             "raised_currency_code",
18             "raised_amount",
19             "investments.person",
20             "investments.financial_org"
21           ] 
22         },
23       } 
24     }
25   }
26 }

上記のインデックス定義により、 MongoDB Search は次のように構成されます。

funding_rounds フィールドと funding_rounds.investments フィールドを embeddedDocuments タイプとしてインデックス付けします。
オブジェクトの funding_rounds と funding_rounds.investments 配列にネストされているすべての動的にインデックス可能なフィールドをインデックス化します。
次のフィールドを mongot に保存します。
- funding_rounds.round_code
- funding_rounds.raised_currency_code
- funding_rounds.raised_amount
- funding_rounds.investments.person
- funding_rounds.investments.financial_org

embeddedDocument演算子を使用して、 funding_roundsフィールドとfunding_rounds.investments フィールドの両方に対して要素単位のクエリを実行できます。次のセクションでは、returnScope オプションを使用してembeddedDocuments フィールドを個別のドキュメントとして取得するいくつかのサンプルクエリを示します。

sample_streaming.companies コレクションのサンプルドキュメント構造

{
  ...,
  "funding_rounds": [
    {
      "id": <integer>,
      "round_code": "<string>",
      "source_url": "<string>",
      "source_description": "<string>",
      "raised_amount": <integer>,
      "raised_currency_code": "<string>",
      "funded_year": <integer>,
      "funded_month": "<string>",
      "funded_day": "<string>",
      "investments": [
         {
           "company": "<string>",
           "financial_org": {
             "name": "<string>",
             "permalink": "<string>"
           },
           "person": {
             "first_name": "<string>",
             "last_name": "<string>",
             "permalink": "<string>"
           }
         },
         ...
      ]
    },
    ...
  ],
  ...
}

サンプルクエリ

次のセクションは、returnScope オプションを使用して、mongot に保存された embeddedDocuments 型フィールドのフィールドを検索するサンプルクエリを示します。

簡単なクエリ

埋め込みドキュメントフィールドをクエリして検索します。

次のクエリでは、 range（MongoDB Search 演算子）を使用して、フィールドに対して、funding_rounds.raised_amount5000000 以上かつ10000000 未満の値をクエリします。オプションを使用して、クエリスコープをフィールドに設定します。funding_rounds returnScopeオプションを使用して保存されたオブジェクトのfunding_rounds 配列内のフィールドを含む、オブジェクトのfunding_rounds.investments returnStoredSource配列内に保存されたすべてのフィールドが返されます。結果数を5funding_rounds ドキュメントのみに制限します。

1 db.companies.aggregate(
2   {
3     "$search": {
4       "range": {
5         "path": "funding_rounds.raised_amount",
6         "gte": 5000000,
7         "lte": 10000000
8       },
9       "returnStoredSource": true,
10       "returnScope": {
11         "path": "funding_rounds"
12       }
13     }
14   },
15   {
16     "$limit": 5
17   }
18 )

[
  {
    round_code: 'a',
    raised_amount: 5250000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: {
          name: 'Frazier Technology Ventures',
          permalink: 'frazier-technology-ventures'
        },
        person: null
      },
      {
        financial_org: { name: 'Trinity Ventures', permalink: 'trinity-ventures' },
        person: null
      }
    ]
  },
  {
    round_code: 'b',
    raised_amount: 9500000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: { name: 'Accel Partners', permalink: 'accel-partners' },
        person: null
      },
      {
        financial_org: {
          name: 'Frazier Technology Ventures',
          permalink: 'frazier-technology-ventures'
        },
        person: null
      },
      {
        financial_org: { name: 'Trinity Ventures', permalink: 'trinity-ventures' },
        person: null
      }
    ]
  },
  {
    round_code: 'a',
    raised_amount: 5000000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: {
          name: 'Charles River Ventures',
          permalink: 'charles-river-ventures'
        },
        person: null
      },
      {
        financial_org: {
          name: 'Union Square Ventures',
          permalink: 'union-square-ventures'
        },
        person: null
      },
      {
        financial_org: null,
        person: {
          first_name: 'Marc',
          last_name: 'Andreessen',
          permalink: 'marc-andreessen'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Dick',
          last_name: 'Costolo',
          permalink: 'dick-costolo'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Naval',
          last_name: 'Ravikant',
          permalink: 'naval-ravikant'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Ron',
          last_name: 'Conway',
          permalink: 'ron-conway'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Chris',
          last_name: 'Sacca',
          permalink: 'chris-sacca'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Greg',
          last_name: 'Yaitanes',
          permalink: 'greg-yaitanes'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Brian',
          last_name: 'Pokorny',
          permalink: 'brian-pokorny'
        }
      },
      {
        financial_org: { name: 'SV Angel', permalink: 'sv-angel' },
        person: null
      }
    ]
  },
  {
    round_code: 'e',
    raised_amount: 5166511,
    raised_currency_code: 'USD',
    investments: []
  },
  {
    round_code: 'b',
    raised_amount: 9000000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: {
          name: 'Charles River Ventures',
          permalink: 'charles-river-ventures'
        },
        person: null
      },
      {
        financial_org: { name: 'Redpoint Ventures', permalink: 'redpoint-ventures' },
        person: null
      },
      {
        financial_org: {
          name: 'The Kinsey Hills Group',
          permalink: 'kinsey-hills-group'
        },
        person: null
      }
    ]
  }
]

複合クエリ

複数の埋め込みドキュメントフィールドをクエリして検索します。

次のクエリでは、compound 演算子を使用して、同じクエリでネストされたembeddedDocuments フィールドの複数のレベルを検索します。

``unding_rounds. resume_currency_code`` と一致する必要があります USD
funding_rounds.investments.financial_org.name と Trinity Ventures は一致する必要があります

オブジェクトの funding_rounds 配列内に保存されているすべてのフィールド（funding_rounds.investments 内のフィールドを含む）が返されます。結果数を 5 funding_rounds ドキュメントのみに制限します。

1 db.companies.aggregate(
2   {
3     "$search": {
4       "compound": {
5         "must": [{
6           "text": {
7             "path": "funding_rounds.raised_currency_code",
8             "query": "usd"
9           }
10         }],
11         "should": [{
12           "phrase": {
13             "path": "funding_rounds.investments.financial_org",
14             "query": "Trinity Ventures",
15           }
16         }]
17       },
18       "returnStoredSource": true,
19       "returnScope": {
20         "path": "funding_rounds"
21       }
22     }
23   },
24   {
25     "$limit": 5
26   }
27 )

[
  {
    round_code: 'a',
    raised_amount: 5250000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: {
          name: 'Frazier Technology Ventures',
          permalink: 'frazier-technology-ventures'
        },
        person: null
      },
      {
        financial_org: { name: 'Trinity Ventures', permalink: 'trinity-ventures' },
        person: null
      }
    ]
  },
  {
    round_code: 'b',
    raised_amount: 9500000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: { name: 'Accel Partners', permalink: 'accel-partners' },
        person: null
      },
      {
        financial_org: {
          name: 'Frazier Technology Ventures',
          permalink: 'frazier-technology-ventures'
        },
        person: null
      },
      {
        financial_org: { name: 'Trinity Ventures', permalink: 'trinity-ventures' },
        person: null
      }
    ]
  },
  {
    round_code: 'c',
    raised_amount: 25000000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: { name: 'DAG Ventures', permalink: 'dag-ventures' },
        person: null
      },
      {
        financial_org: { name: 'Accel Partners', permalink: 'accel-partners' },
        person: null
      },
      {
        financial_org: { name: 'Trinity Ventures', permalink: 'trinity-ventures' },
        person: null
      },
      {
        financial_org: {
          name: 'Frazier Technology Ventures',
          permalink: 'frazier-technology-ventures'
        },
        person: null
      }
    ]
  },
  {
    round_code: 'angel',
    raised_amount: 500000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: null,
        person: {
          first_name: 'Peter',
          last_name: 'Thiel',
          permalink: 'peter-thiel'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Reid',
          last_name: 'Hoffman',
          permalink: 'reid-hoffman'
        }
      }
    ]
  },
  {
    round_code: 'a',
    raised_amount: 12700000,
    raised_currency_code: 'USD',
    investments: [
      {
        financial_org: { name: 'Accel Partners', permalink: 'accel-partners' },
        person: null
      },
      {
        financial_org: null,
        person: {
          first_name: 'Mark',
          last_name: 'Pincus',
          permalink: 'mark-pincus'
        }
      },
      {
        financial_org: null,
        person: {
          first_name: 'Reid',
          last_name: 'Hoffman',
          permalink: 'reid-hoffman'
        }
      }
    ]
  }
]

戻る

searchSequenceToken

tracking

1	{
2	"mappings": {
3	"dynamic": false,
4	"fields": {
5	"funding_rounds": {
6	"type": "embeddedDocuments",
7	"dynamic": true,
8	"fields": {
9	"investments": {
10	"type": "embeddedDocuments",
11	"dynamic": true
12	}
13	},
14	"storedSource": {
15	"include": [
16	"round_code",
17	"raised_currency_code",
18	"raised_amount",
19	"investments.person",
20	"investments.financial_org"
21	]
22	},
23	}
24	}
25	}
26	}

1	db.companies.aggregate(
2	{
3	"$search": {
4	"range": {
5	"path": "funding_rounds.raised_amount",
6	"gte": 5000000,
7	"lte": 10000000
8	},
9	"returnStoredSource": true,
10	"returnScope": {
11	"path": "funding_rounds"
12	}
13	}
14	},
15	{
16	"$limit": 5
17	}
18	)

1	db.companies.aggregate(
2	{
3	"$search": {
4	"compound": {
5	"must": [{
6	"text": {
7	"path": "funding_rounds.raised_currency_code",
8	"query": "usd"
9	}
10	}],
11	"should": [{
12	"phrase": {
13	"path": "funding_rounds.investments.financial_org",
14	"query": "Trinity Ventures",
15	}
16	}]
17	},
18	"returnStoredSource": true,
19	"returnScope": {
20	"path": "funding_rounds"
21	}
22	}
23	},
24	{
25	"$limit": 5
26	}
27	)

要件

構文

動作

Considerations

例

サンプル インデックス

サンプル クエリ

簡単なクエリ

複合クエリ

サンプルインデックス

サンプルクエリ