Docs Menu

複数のドキュメントの挿入

項目一覧

効率モデルまたはクエリ ビルダーで 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 アプリケーションを編集して使用例を実行する方法については、使用例のランディング ページ を参照してください。

項目一覧