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

項目一覧

効率モデルまたはクエリビルダーで 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コレクションにドキュメントを挿入します
挿入操作が成功したかどうかを出力します

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

戻る

ドキュメントの挿入

ドキュメントの更新