Retrieve MongoDB Data

Overview

このガイドでは、 Lambda MongoDBを使用してMongoDBコレクションからデータを検索する方法を学びます。このガイドでは、データを検索するために使用できる Eloqueent モデル メソッドについて説明し、さまざまなタイプの検索操作の例を示します。

Laravel 統合の Eloquent モデルの詳細について詳しくは、データのモデル化セクションを参照してください。

クエリに一致するドキュメントの取得

Lambda の Eloqueent オブジェクト関係マッパー（ORM）を使用して、MongoDB コレクションを表すモデルを作成し、その上でクエリ条件を指定するためにメソッドを連鎖させることができます。

一連の条件に一致するドキュメントを検索するには、コレクションの対応する Eloqueent モデルでwhere()メソッドを呼び出し、クエリフィルターを メソッドに渡します。

クエリフィルターは、フィールド値の要件を指定し、これらの要件を満たすドキュメントのみを返すように検索操作に指示します。

クエリを構築するには、次のwhere()メソッド呼び出しのいずれかを使用できます。

• where('<field name>', <value>) ターゲット フィールドが正確に指定された値を持つドキュメントに一致するクエリを構築します

• where('<field name>', '<comparison operator>', <value>) ターゲット フィールドの値が比較条件を満たすドキュメントに一致するクエリを構築します

検索操作に複数の条件セットを適用するには、一連のwhere()メソッドを連鎖させることができます。

where()メソッドを使用してクエリを作成したら、 get()メソッドを連鎖させてクエリ結果を検索します。

この例では、 Movie Elastic モデルで 2 つのwhere()メソッドを呼び出して、次の条件を満たすドキュメントを検索します。

• year フィールドの値は 2010

• imdb.rating ネストされたフィールドの値が より大きい 8.5

$movies = Movie::where('year', 2010)
    ->where('imdb.rating', '>', 8.5)
    ->get();

class MovieController
{
    public function show()
    {
         $movies = Movie::where('year', 2010)
             ->where('imdb.rating', '>', 8.5)
             ->get();
         return view('browse_movies', [
             'movies' => $movies
         ]);
    }
}

Title: Inception
Year: 2010
Runtime: 148
IMDB Rating: 8.8
IMDB Votes: 1294646
Plot: A thief who steals corporate secrets through use of dream-sharing
technology is given the inverse task of planting an idea into the mind of a CEO.
Title: Senna
Year: 2010
Runtime: 106
IMDB Rating: 8.6
IMDB Votes: 41904
Plot: A documentary on Brazilian Formula One racing driver Ayrton Senna, who won the
F1 world championship three times before his death at age 34.

Elastic ORM の代わりに Lambda クエリ ビルダを使用してクエリを実行する方法については、「クエリ ビルダ」ページを参照してください。

$movies = Movie::where('countries', ['Indonesia', 'Canada'])
    ->get();

$movies = Movie::where('countries', 'in', ['Canada', 'Egypt'])
    ->get();

最初の結果を取得

一連の条件に一致する最初のドキュメントを取得するには、 where()メソッドとそれに続くfirst()メソッドを使用します。

一意の値をクエリするときに一貫した結果が得られるように、 orderBy()メソッドをfirst()にチェーンします。 orderBy()メソッドを省略すると、MongoDB はドキュメントの自然な順序に従って、またはコレクションに表示されるように、一致するドキュメントを返します。

この例では、 runtimeフィールドの値が30であるドキュメントをクエリし、 _idフィールドの値に従って最初に一致するドキュメントを返します。

$movie = Movie::where('runtime', 30)
    ->orderBy('_id')
    ->first();

class MovieController
{
    public function show()
    {
        $movie = Movie::where('runtime', 30)
            ->orderBy('_id')
            ->first();
        return view('browse_movies', [
            'movies' => $movie
        ]);
    }
}

Title: Statues also Die
Year: 1953
Runtime: 30
IMDB Rating: 7.6
IMDB Votes: 620
Plot: A documentary of black art.

コレクション内のすべてのドキュメントを取得

クエリフィルターを省略すると、コレクション内のすべてのドキュメントを検索できます。 ドキュメントを返すには、コレクションを表す Elowent モデルでget()メソッドを呼び出します。 あるいは、 get()メソッドのエイリアスall()を使用して同じ操作を実行することもできます。

すべてのドキュメントに一致する検索操作を実行するには、次の構文を使用します。

$movies = Movie::get();

完全に実行可能な例

以下のセクションでは、Laravel Integration を使用してドキュメントを検索する方法を説明する完全に実行可能なコード例を示しています。これらの例では、Atlas サンプル データセットの sample_mflix.movies コレクションを使用します。

$movie = Movie::where('directors', 'Rob Reiner')
  ->orderBy('id')
  ->first();
echo $movie->toJson();

// Result is truncated
{
  "_id": ...,
  "title": "This Is Spinal Tap",
  "directors": [ "Rob Reiner" ],
   ...
}

$movie = DB::table('movies')
  ->where('directors', 'Rob Reiner')
  ->orderBy('_id')
  ->first();
echo $movie->title;

This Is Spinal Tap

$movies = Movie::where('runtime', '>', 900)
    ->orderBy('id')
    ->get();

// Results are truncated
[
  {
    "_id": ...,
    "runtime": 1256,
    "title": "Centennial",
    ...,
  },
  {
    "_id": ...,
    "runtime": 1140,
    "title": "Baseball",
    ...,
  },
  ...
]

$movies = DB::table('movies')
    ->where('runtime', '>', 900)
    ->orderBy('_id')
    ->get();

// Results are truncated
[
  {
    "_id": ...,
    "runtime": 1256,
    "title": "Centennial",
    ...,
  },
  {
    "_id": ...,
    "runtime": 1140,
    "title": "Baseball",
    ...,
  },
  ...
]

$count = Movie::where('genres', 'Biography')
    ->count();
echo 'Number of documents: ' . $count;

Number of documents: 1267

$count = DB::table('movies')
    ->where('genres', 'Biography')
    ->count();
echo 'Number of documents: ' . $count;

Number of documents: 1267

$ratings = Movie::where('directors', 'Sofia Coppola')
    ->select('imdb.rating')
    ->distinct()
    ->get();
echo $ratings;

[[5.6],[6.4],[7.2],[7.8]]

$ratings = DB::table('movies')
    ->where('directors', 'Sofia Coppola')
    ->select('imdb.rating')
    ->distinct()
    ->get();
echo $ratings;

[5.6,6.4,7.2,7.8]

詳細情報

MongoDB にデータを挿入する方法について詳しくは、「ドキュメントの挿入」ガイドを参照してください。

Lambda 統合が結果を返す方法を変更する方法については、「 クエリ結果の変更 」ガイドを参照してください。