データベースとコレクション

Overview

このガイドでは、Lambda MongoDB を使用して MongoDB データベースとコレクションにアクセスおよび管理する方法を学習できます。

MongoDB では、データは階層構造で整理されています。 MongoDB 配置には 1 つ以上のデータベースが含まれ、各データベースには 1 つ以上のコレクションが含まれます。 各コレクションでは、MongoDB は、フィールドと値のペアを含むドキュメントとしてデータを保存します。 Lambda 統合では、Eloquet モデルを通じてドキュメントにアクセスできます。

ドキュメント データ形式の詳細については、サーバー マニュアルのドキュメントを参照してください。

接続構成でのデータベースの指定

アプリケーションの config/database.phpファイルで接続に使用するデータベース名を指定できます。 このファイルの connections プロパティには、 接続string 、データベース名、任意で認証の詳細など、すべてのデータベース接続情報が保存されています。 データベース接続を指定すると、データベースレベルの操作を実行し、データベースが含むコレクションにアクセスできます。

databaseプロパティのデータベース名を存在しないデータベースの名前に設定しても、Lambda は引き続き有効な接続を行います。 データベースのコレクションにデータを挿入すると、サーバーによって自動的にデータが作成されます。

次の例は、 dsnとdatabaseプロパティを設定して、デフォルトのデータベース接続を設定し、 config/database.phpファイルにanimalsデータベースへのデータベース接続を作成する方法を示しています。

'default' => 'mongodb',
'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'animals',
    ], ...
]

デフォルトのデータベース接続を設定すると、Lambda 統合は操作にその接続を使用しますが、 config/database.phpファイルに複数のデータベース接続を指定できます。

次の例は、 データベースと データベースにアクセスするために複数のデータベース接続（mongodb とmongodb_alt ）を指定する方法を示しています。animalsplants

'connections' => [
    'mongodb' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'animals',
    ],
    'mongodb_alt' => [
        'driver' => 'mongodb',
        'dsn' => 'mongodb://localhost:27017/',
        'database' => 'plants',
    ]
], ...

アプリケーションに複数のデータベース接続が含まれており、デフォルト以外のデータベースにモデルを保存する場合は、 Modelクラスの$connectionプロパティをオーバーライドします。

次の例は、 Flowerモデル クラスの$connectionプロパティをオーバーライドしてmongodb_alt接続を使用する方法を示しています。 これにより、Lambda 統合は、デフォルトのデータベースではなく、 plantsデータベースのflowersコレクションにモデルを保存するように指示します。

class Flower extends Model
{
    protected $connection = 'mongodb_alt';
}

コレクションにアクセスする

MongoDB\Laravel\Eloquent\Modelを拡張するモデル クラスを作成すると、Lambda 統合は、モデル クラス名がスニペットの複数形である名前を持つコレクションにモデルデータを保存します。

たとえば、 Flowerというモデル クラスを作成すると、Lambda はそのモデルをデータベース内のflowersコレクションに適用します。

コードの読みやすさと維持性を高めるために、コレクションにアクセスするには Eloquet ORM を使用することをお勧めします。 次の例では、 Flowerクラスを使用して検索操作を指定しています。これにより、Lambda はflowersコレクションから結果を検索します。

Flower::where('name', 'Water Lily')->get()

楕円モデルを使用して操作を実行できない場合は、 DBファサードでtable()メソッドを呼び出すことでクエリ ビルダにアクセスできます。 次の例では、前の例と同じクエリを示していますが、このクエリはDB::table()メソッドを使用して構築されています。

DB::connection('mongodb')
    ->table('flowers')
    ->where('name', 'Water Lily')
    ->get()

listCollections

データベース内のコレクションに関する情報を表示するには、次のいずれかのアクションを実行できます。

• shellコマンドの実行

• データベースまたはスキーマ メソッドの呼び出し

php artisan db:show

$collections = DB::connection('mongodb')->getMongoDB()->listCollections();

コレクション フィールドを一覧表示する

コレクション内の各フィールドに関する情報を表示するには、次のいずれかのアクションを実行できます。

• shellコマンドの実行

• スキーマ メソッドの呼び出し

php artisan db:table <collection name>

$fields = Schema::getColumns('flowers');

コレクションの作成と削除

コレクションを作成および削除する方法については、 スキーマ ビルダ ガイドの「 Lambda 移行の実行 」セクションを参照してください。