複数のドキュメントの挿入
項目一覧
効率モデルまたはクエリ ビルダーでinsert()
メソッドを呼び出すことで、コレクションに複数のドキュメントを挿入できます。
複数のドキュメントを挿入するには、 insert()
メソッドを呼び出し、メソッド呼び出し内で新しいドキュメントを配列として指定します。 各配列エントリには、1 つのドキュメントのフィールド値が含まれます。
Tip
挿入操作の詳細については、 書込み操作 ガイドの「ドキュメントの挿入」セクションを参照してください。
例
対応するそれぞれの クエリ構文を使用する同じ操作の使用例を表示するには、次の Eloquent タブと Query Builder タブから選択します。
この例では、次のアクションを実行します。
Movie
Eloent モデルを使用して、sample_mflix
データベース内のmovies
コレクションを表しますmovies
コレクションにドキュメントを挿入します挿入操作が成功したかどうかを出力します
この例ではinsert()
メソッドを呼び出して、2023
にリリースされた映画を表すドキュメントを挿入しています。挿入操作が成功した場合は、1
の値が返されます。操作が失敗した場合、例外がスローされます。
$success = Movie::insert([ [ 'title' => 'Anatomy of a Fall', 'release_date' => new UTCDateTime(new DateTimeImmutable('2023-08-23')), ], [ 'title' => 'The Boy and the Heron', 'release_date' => new UTCDateTime(new DateTimeImmutable('2023-12-08')), ], [ 'title' => 'Passages', 'release_date' => new UTCDateTime(new DateTimeImmutable('2023-06-28')), ], ]); echo 'Insert operation success: ' . ($success ? 'yes' : 'no');
Insert operation success: yes
この例では、次のアクションを実行します。
DB
ファサードからtable()
メソッドを呼び出してmovies
コレクションにアクセスしますmovies
コレクションにドキュメントを挿入します挿入操作が成功したかどうかを出力します
この例ではinsert()
メソッドを呼び出して、2023
にリリースされた映画を表すドキュメントを挿入しています。挿入操作が成功した場合は、1
の値が返されます。操作が失敗した場合、例外がスローされます。
$success = DB::table('movies') ->insert([ [ 'title' => 'Anatomy of a Fall', 'release_date' => new UTCDateTime(new DateTimeImmutable('2023-08-23')), ], [ 'title' => 'The Boy and the Heron', 'release_date' => new UTCDateTime(new DateTimeImmutable('2023-12-08')), ], [ 'title' => 'Passages', 'release_date' => new UTCDateTime(new DateTimeImmutable('2023-06-28')), ], ]); echo 'Insert operation success: ' . ($success ? 'yes' : 'no');
Insert operation success: yes
Lambda アプリケーションを編集して使用例を実行する方法については、使用例のランディング ページ を参照してください。